English | 中文版
維護於 SanHsien/agent-advisor。 Codex 版衍生自 DannyMac180/sol-advisor， 保留原作者署名與 MIT 授權。
Agent Advisor 把同一套風險分流交付流程，包成五個原生 agent runtime 各自的 plugin。 選你這次開發 session 實際在跑的那一版：
| 版本 | 原生角色 | Plugin | 教學 |
|---|---|---|---|
| Codex | GPT-6.1 Sol / Medium 預設 primary，低成本工作可切 Luna / Medium，少數難題切 Astra / Low；選用 Luna、Terra、Sol reviewer lane | agent-advisor-codex |
Agent Advisor for Codex |
| Claude Code | Opus / medium 為 primary；預設 Sonnet / medium 實作，困難工作切 Sonnet / high，Haiku 只做機械批次；選用 Opus reviewer lane | agent-advisor-claude |
Agent Advisor for Claude Code |
| Cursor | 明確指定的高能力模型為 primary；預設 Sonnet / medium 實作，困難工作切 Sonnet / high，Composer 只做機械批次；選用 Opus reviewer lane | agent-advisor-cursor |
Agent Advisor for Cursor |
| Antigravity | pro 級為 primary；預設 flash 實作（含機械批次），困難工作切 pro；選用 pro reviewer lane | agent-advisor-antigravity |
Agent Advisor for Antigravity |
| Hermes | 明確選定的 primary；原生 delegate_task，角色與 provider 分別驗證 | 原生 skill | Hermes |
每一版都保留四條路由：solo、delegate、audit，以及例外的 full。
Primary agent 自己扛架構、路由選擇、驗證與最終驗收。委派是選擇性的，不是儀式。
常駐啟用的做法看該 runtime 給不給：Cursor 與 Antigravity 版把常駐規則包在 plugin 裡，
裝好就生效；Claude Code 版沒有這個機制，要改使用者層的 CLAUDE.md，
見它的常駐啟用一節。
codex plugin marketplace add SanHsien/agent-advisor --ref main
codex plugin add agent-advisor-codex@agent-advisorCodex 版另有原生角色設定檔，需要它自己的安裝器。完整步驟見 Codex 快速上手。
在 Claude Code 內執行：
/plugin marketplace add SanHsien/agent-advisor
/plugin install agent-advisor-claude@agent-advisor
以 Opus 開新 session，然後：
Use /agent-advisor-claude:orchestration to declare a SELECTIVE ROUTE before task tools, then build and verify this feature.
驗證方式與執行期注意事項見 Claude Code 快速上手。 要讓宣告路由變成每個 session 的預設行為（而不是每次都要講一遍），見 常駐啟用。
從側邊欄 Customize 面板安裝，或把 Cursor 的本地 plugin 資料夾指到本 repo：
ln -s "$PWD/cursor/plugins/agent-advisor-cursor" ~/.cursor/plugins/local/agent-advisor-cursor選一個高能力推理模型——不要用 auto——就可以開工。內建的 always-apply 規則會自己
要求宣告路由。見 Cursor 快速上手。
agy plugin install ./antigravity/plugins/agent-advisor-antigravity
agy plugin list用 pro 級模型、高 effort 開 session。內建規則會自己要求宣告路由。 見 Antigravity 快速上手。
裝 hook 之前先看：Antigravity 的 hook 指令路徑不能加引號，加了會癱瘓整個 session。 成因與修復見hook 引號陷阱。
codex/ Codex marketplace 來源、plugin、原生角色設定、verifier
claude/ Claude Code marketplace 來源、plugin、Markdown subagents、啟用模板、verifier
cursor/ Cursor plugin、subagents、always-apply 規則、verifier
antigravity/ Antigravity plugin、subagents、always-active 規則、備援模板、verifier
hermes/ Hermes 原生 skill、成本合約、安裝器與 package verifier
docs/ 共用的 fork 與上游維護紀錄
tests/ 倉庫層單元測試
tools/ 跨平台倉庫 gate
根目錄的 .agents/plugins/marketplace.json 與 .claude-plugin/marketplace.json 是 Codex
與 Claude Code CLI 需要的小型探索目錄。所有執行期實作檔都在各自的平台子目錄底下。
Cursor 與 Antigravity 是從 plugin 目錄安裝的，不在根目錄放任何檔案。
跑 Windows 優先的倉庫 gate：
pwsh -NoProfile -File tools/dev_check.ps1單獨跑單元測試：
python -m unittest discover -s tests -p "test_*.py"各平台文件在 codex/docs、claude/docs、cursor/docs、 antigravity/docs。Fork 維護與署名見 docs/FORK.md 與 docs/UPSTREAM.md。
這五個 repo 各自治理 AI coding 的一層，可以單獨用，也可以疊起來用：
| 層 | Repo | 做什麼 |
|---|---|---|
| 供應鏈 | SkillSpector | 裝進來之前先掃：agent skill 的漏洞與惡意樣式偵測，輸出風險分數與 SAFE／CAUTION／DO_NOT_INSTALL 建議 |
| 派工決策 | Agent Advisor（你在這裡） | 風險分流路由 solo／delegate／audit／full：決定這件事要不要派工、派給誰 |
| 動作攔截 | harness-guard | agent runtime hook，在動手前後與收工時實際攔截危險指令、無證據宣稱、紅燈提交 |
| 產出品質 | ai-quality-gates | 可執行規格與量化門檻：覆蓋率、突變測試、圈複雜度、依賴結構、有界 loop policy |
| 交付流程 | paulsha-cortex | 多 Agent lifecycle：Candidate → Verify → Independent Review → Delivery → CompletionRecord |
相鄰但不同層：agent-governance-toolkit 治理的是上線後自主運行的 agent——政策強制、零信任身分、沙箱執行與可稽核記錄——不是寫程式的 coding agent。opencodex 是供應商代理，決定這些 agent 背後能跑哪些 LLM，本身不約束 agent 行為。
五版維持原生執行與四條風險路由；新增短工作包、可核對的驗證證據沿用與誠實成本記錄。 不固定呼叫顧問、不改成全面平行派工。Claude 原生與 3P 另有明確能力邊界。 見 改善決策 與 Hermes 安裝。
本 repo 是 agent-relay 多 Agent 派工與驗收流水線的一環（角色：派工路由與合約、獨立審查員軌道）。與 agent-relay 的整合規劃中（Phase 2、3）。協定規格與所有相關 repo 的總目錄見 agent-relay。