實戰:GitHub PR 審查機器人
Hermes 實戰教程第11篇:GitHub PR 審查。AI 自動檢查程式碼。
這篇教學將教你用 Hermes Agent 搭建一個 24 小時線上的 AI 審查員,自動幫你檢查 GitHub 上的程式碼合併請求(PR),把團隊從「等審查」的泥潭裡拉出來。
問題來了: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