本機部署 Hermes Agent 串接 OpenRouter DeepSeek，自動化委派 Claude Code 與 Codex CLI 進行程式碼交叉審查，過濾誤報並壓低推理成本。
核心架構：本機協調器與雙引擎審查
Hermes Agent 是 Nous Research 開源的本機 Agent 框架，支援任意 OpenAI 相容端點（含 OpenRouter）作為推理模型，並內建終端機工具可直接操控外部 CLI。這套流程的關鍵在於角色分工：
- Hermes + DeepSeek（via OpenRouter）：擔任「監工」與「彙整者」，負責流程控制、任務分派、結果交叉比對，成本極低。
- Claude Code CLI：負責程式碼審查、安全性掃描、重構建議。
- Codex CLI：提供不同訓練分佈下的審查視角，互補盲點。
兩者獨立產出審查報告，再由 DeepSeek 只保留「雙方都指出」的問題，避免單一模型幻覺或盲點。
步驟 1：安裝 Hermes 並綁定 OpenRouter / DeepSeek
# 安裝 Hermes CLI（依官方文件）
# 設定環境變數
cat >> ~/.hermes/.env <<'EOF'
OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxx
EOF
或在 config.yaml 固定模型：
textmodel:
provider: "openrouter"
default: "deepseek/deepseek-v3.2"
若偏好直連 DeepSeek 官方 API，改設 DEEPSEEK_API_KEY，provider 名稱為 deepseek。
步驟 2：讓 Hermes 委派任務給 Claude Code / Codex
Hermes 內建 terminal 技能，支援 pty=true 處理互動式輸出。常用指令範例：
# 委派給 Codex（需在 git repo 內執行）
codex exec "Add dark mode toggle" --full-auto
# 背景長任務輪詢
codex exec "Refactor auth module" --full-auto &
hermes process action=poll
# 委派給 Claude Code（非互動模式）
claude -p "Review PR #123 for security issues" --effort high --no-session-persistence
注意：Codex 拒絕在非 git repository 目錄執行；Claude Code 需先完成
claude auth。
Hermes 也提供內建委派 skill，可用 hermes auth add openai-codex 匯入既有 Codex OAuth 憑證，免裝 CLI。
步驟 3：實作交叉審查流程（參考 omh-pr-multi-review）
社群已將完整流程封裝為可重複執行的 Skill，核心步驟如下：
| 階段 | 關鍵動作 | 失敗策略 |
|---|---|---|
| 前置檢查 | 驗證 PR URL、CLI 安裝狀態、認證有效性、工作目錄乾淨度 | 任一失敗即終止 |
| 檢出分支 | gh pr checkout --detach，finally 區塊還原原分支 |
確保工作區不受污染 |
| 多重審查 | 依序執行 claude /review、claude /security-review、claude /code-review、codex review |
單一審查逾時/失敗不影響其餘 |
| 交叉彙整 | 再呼叫一次 DeepSeek，只保留「多個審查者獨立提出」的重疊問題；無重疊則明確回報「無交集」 | 避免模型硬掰結論 |
設計原則：流程控制寫死成確定性腳本（Python），不交給 Agent 自由判斷。涉及切換分支、呼叫多 CLI 等副作用操作，Agent 一旦漏步驟即可能損壞工作區。
成本效益與適用場景
| 指標 | 說明 |
|---|---|
| 推理成本 | 四次高強度審查 + 一次彙整，若全用 Claude/GPT 成本極高；DeepSeek 主控可壓低 80% 以上 |
| 等待時間 | 依序執行約 3–8 分鐘，建議僅用於高風險 PR（認證、金流、外部輸入處理） |
| 誤報率 | 雙模型交集問題極可能為真；單一模型獨有問題留給人工判斷 |
| 一般小改動 | 單一模型審查即可，無需啟動完整流程 |
常見坑點與對策
- 權限不足：確認
gh、claude、codex皆有 repo 讀寫權限。 - Context 爆炸：大型 PR 建議先用
git diff --stat判斷範圍，必要時拆分審查。 - API 限流：OpenRouter 免費額度有限，生產環境建議綁定付費帳號或改用 DeepSeek 官方 API。
- 版本漂移：Hermes、Claude Code、CodeX 更新頻繁，Skill 腳本需定期回測。
結語
以 Hermes Agent 為本機協調器，DeepSeek 為低成本大腦，Claude Code 與 Codex 為雙引擎審查員，形成「廉價監工 + 昂貴專家 + 交叉驗證」的實用組合。這套架構不僅適用於 PR 審查，同樣可延伸至自動化重構、安全性掃描、文件生成等任何需要多模型共識的工程任務。