🤖HermesBlog
Hermes 實戰教學 · 第11篇2026/8/9· Easy Understand Hermes Agent

實戰:GitHub PR 審查機器人

Hermes 實戰教程第11篇:GitHub PR 審查。AI 自動檢查程式碼。

這篇教學將教你用 Hermes Agent 搭建一個 24 小時線上的 AI 審查員,自動幫你檢查 GitHub 上的程式碼合併請求(PR),把團隊從「等審查」的泥潭裡拉出來。

guide-github-pr-review

問題來了:PR 堆積如山

想像一下:團隊提交 PR 的速度比你看程式碼的速度還快,PR 列表越排越長,新手把 bug 合併進主線,你每天早上都在補看 diff,根本沒時間寫新功能。你需要一個不知疲倦的助手,替你盯著倉庫。

方案:定時巡邏的 AI 審查員

我們要搭建的系統就像一個社區保全:每兩個小時巡邏一次(Cron 定時器),發現新 PR 就拍照取證(拉取 diff),然後按標準流程檢查(Skill 技能),最後把報告送到你手上(Telegram 或本地檔案)。

定時器 → Hermes Agent → GitHub API → 審查報告
(每2小時)  (AI大腦)      (取得程式碼)   (推送到手機)

無需伺服器,無需公網 IP,你的電腦就能幹這活。


第1步:準備工作

確保你已經裝好 Hermes Agent 和 GitHub 命令列工具(gh),並完成登入認證:

# 安裝 gh(macOS)
brew install gh
# 認證
gh auth login

啟動 Hermes 閘道(負責跑定時任務):

hermes gateway install   # 作為背景服務執行

第2步:先手動試試水

打開 Hermes 對話介面,讓它先手動審查一個真實 PR:

Run: gh pr diff 3888 --repo NousResearch/hermes-agent

它會自動讀取程式碼變更,給出帶行號的具體審查意見。滿意?那就自動化。

第3步:建立審查技能(Skill)

技能就像給 AI 的崗位培訓手冊,讓每次審查標準一致。建立檔案 ~/.hermes/skills/code-review/SKILL.md,寫入審查規則:檢查 bug、安全問題、效能隱患、程式碼風格、測試覆蓋,每條意見必須標註檔案位置、嚴重程度、問題描述、修復建議

第4步:教它你們團隊的規矩

這一步最關鍵!告訴 Hermes 你們的技術棧和約定:

Remember: 我們後端用 Python + FastAPI,所有介面必須有型別註解,
禁止裸 SQL,只用 SQLAlchemy ORM。

這些記憶會永久保存,以後每次審查都會自動遵守。

第5步:建立定時任務

hermes cron create "0 */2 * * *" \
  "檢查新 PR 並審查,倉庫:myorg/backend-api。
   對最近4小時內的新 PR,拉取 diff 並按 code-review 規則審查。
   輸出格式:PR編號、作者、結論、問題列表。" \
  --name "pr-review" \
  --deliver telegram \
  --skill code-review

--deliver telegram 把報告推送到你的手機;沒有訊息工具就用 local 儲存到本地檔案。

第6步:手動觸發

等不及定時?隨時手動跑一次:

hermes cron run pr-review

進階玩法

  • 讓 AI 直接評論到 GitHub 上:在提示詞裡加上 gh pr review 命令,自動按讚或打回
  • 每週一早上出週報:統計各倉庫的 PR 數量、最老 PR 年齡、無人審查的 PR
  • 多倉庫監控:在提示詞裡多列幾個倉庫即可,無需額外設定

常見問題

  • 提示 gh: command not found:確認 gh 在系統 PATH 裡,重啟閘道
  • 審查太籠統:檢查是否載入了 code-review 技能,多教它你們的規範
  • 定時任務不跑:用 hermes gateway status 檢查閘道狀態

總結一下:你剛剛擁有了一個 24 小時線上的 AI 審查員,它不睡覺、不抱怨、不放過任何一行可疑程式碼。團隊 PR 流轉速度翻倍,你只需要在手機上看看報告,把精力花在真正需要人類判斷的地方。

下篇預告:如果不想等定時輪詢,想讓 GitHub 主動把新 PR 推給 AI?下一篇我們聊聊 Webhook 即時觸發審查,讓 AI 在 PR 提交的瞬間就開始工作。

📖 官方文档

本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › guides/github-pr-review-agent