install 設定 43 個 client surface:37 個自動偵測 + 6 個 conditional/explicit。主要平台:
| Agent | 設定位置 |
|---|---|
| Claude Code | ~/.claude.json · Skill + 三層 graph agents + SessionStart/SubagentStart/PreToolUse hooks |
| Codex CLI | $CODEX_HOME/config.toml · AGENTS.md + skill + 三層唯讀 agents |
| Gemini CLI | .gemini/settings.json · GEMINI.md + 三層 subagents |
| OpenCode | $OPENCODE_CONFIG · AGENTS.md + skill + 三層 deny-by-default 唯讀 agents |
| Cursor | .cursor/mcp.json · skill + 三層 parent-handoff agents |
| VS Code | Code/User/mcp.json · ~/.copilot/skills + 三層唯讀 agents |
| Windsurf | ~/.codeium/windsurf/mcp_config.json · always-on global_rules.md |
| Aider / Zed / KiloCode / Qwen Code / GitHub Copilot CLI / … | 各有對應 config |
完整 43 平台矩陣見上游 README 的 Multi-Agent Support。
「Conditional」指 installer 只在已存在的 config 路徑或文件化平台證明目標 active 時才寫入。它絕不:翻開實驗性 feature flag、啟用 plugin、YOLO modes、global permission bypass、或第三方指令信任。
有文件化 custom-agent format 的平台,installer 從一份 canonical contract 產生三層定義:
| Tier | 定位 | 行為 |
|---|---|---|
| Scout(Tier 1) | 快速試探發現 | 約 3–4 個窄呼叫;不做 absence / exhaustive-impact / dead-code 聲稱 |
| Verify(Tier 2,預設) | 任務導向證據 | 任務導向圖證據 + 精確原始碼檢查 + 引用路徑涵蓋 + 範圍涵蓋 |
| Auditor(Tier 3) | 完整稽核 | 受限範圍 + 目前索引 generation + 完整分頁 + 更廣關係檢查 + 明確未解限制 |
每層都批次呼叫 check_index_coverage 檢查證據路徑;clean 只代表「沒有記錄缺口」,不是完整證明。更新的 migration 只覆寫 byte-identical 的先前 Verify 定義,不覆蓋使用者改過的 agents。
某些平台用正向 allowlist 的 server profile 限制工具面:
--tool-profile scout(7 個工具)、Verify/Auditor 用 analysis(11 個)。mcpServers field。安裝的 hooks 都是 fail-open 且 context-only:Claude 的 PreToolUse 觀察 Grep/Glob 並把匹配的圖符號注入 additionalContext;PostToolUse 的 Read 在圖無法完整解析該檔時加涵蓋 context。它永遠不拒絕或替換工具呼叫。