aibridge 是做什麼的？
aibridge 可讓您驅動來自其他提供者的模型：它會在此機器上產生已安裝的 AI CLI 並驗證其輸出。您負責提供判斷和提示工藝；CLI 負責脆弱的執行部分。委派能帶來您可能沒有的東西——不同的訓練和盲點（真正的交叉檢查）、圖像渲染、重量級推理席位——並在後端 CLI 現有的登入環境中並行運行，無需 API 金鑰。每次委派會消耗該後端 CLI 自己的配額（請參閱模型席位以了解配額屬於您的情況）。
執行
aibridge <command> [options] # 如果 `aibridge` 在 PATH 上
npx -y @aibridge/cli <command> [options] # 零安裝——隨處可用
無需安裝步驟：第二種形式會按需從 npm 獲取 CLI。以下參考文件將每個命令寫為 aibridge <command> — 如果 aibridge 不在 PATH 上，請將 aibridge 替換為 npx -y @aibridge/cli；其他所有內容完全相同。需要 Node ≥24.11。
設定（一次性探測，非安裝）
- 最低 CLI 版本：0.1.0。
- 探測：執行
aibridge --version；如果命令不存在，請執行npx -y @aibridge/cli --version並從那時起使用 npx 形式。將列印的版本與0.1.0（semver）進行比較。 - 透過 npx 低於最低版本（快取過期）：重新執行
npx -y @aibridge/cli@latest。透過全域安裝低於最低版本：建議使用者使用npm i -g @aibridge/cli進行更新。 - 如果
node --version低於24.11：CLI 無法運行 — 請要求使用者升級 Node（例如nvm install 24/mise use node@24）。 - 可選，適用於希望直接將
aibridge命令放在 PATH 上的使用者：npm i -g @aibridge/cli。在運行全域安裝前請先詢問使用者。
需要後端 CLI 在 PATH 上並已認證：grok（推薦的規劃者/審查者 — 明確傳遞它）、agy（推薦的實施者 — 明確傳遞它）、codex（推薦的圖片生成席位 — 明確傳遞它，以及 openai-codex/* 委派），以及可選的 claude 用於 anthropic-claude/* 委派層級。
子命令
| 命令 | 描述 | 參考資料 |
|---|---|---|
plan | 將任務擴展為詳細的實作計畫檔案 | reference/plan.md |
implement | 就地實作計畫檔案（編輯工作目錄樹，運行真實閘道） | reference/implement.md |
review | 根據計畫合約審查工作目錄樹差異（或計畫） | reference/review.md |
subagent | 將自包含任務委派給另一個模型 | reference/subagent.md |
image-gen | 透過模型席位（codex、agy 或 grok 後端）生成光柵圖像 | reference/image-gen.md |
runs | 監控和檢查執行運行 | — |
quota | 顯示後端配額和重置時間（grok、agy、codex、claude） | — |
models | 列出註冊表中的每個模型席位（slug、努力級別、圖片格式） | — |
路由
-
第一個詞是子命令名稱 → 載入該參考檔案並遵循它。 此點無可協商：參考資料包含使輸出品質優異的提示工藝 — 跳過它只會產生通用結果。
-
未提供子命令 → 從請求推斷：
- 圖像/圖示/圖形 →
image-gen； - 一個明確指定、自包含的任務，可交給另一個模型處理，或是一個跨模型的第二意見/紅隊測試 →
subagent； - 一個規模較大或高風險的實作工作 → 三步工作流程：
plan→ 您閱讀、編輯並批准計畫檔案 →implement→review --plan <file>。對於高風險設計，添加一個實作前的閘道：在乾淨的工作目錄樹上執行review --plan會審查計畫本身。
如果確實不明確，請顯示上表並詢問。
- 圖像/圖示/圖形 →
-
不確定目前有哪些標誌？ 執行
aibridge <command> --help— 表面會隨著時間增長（新模型、新標誌）。
模型席位（推薦選擇 — 明確傳遞它們）
--model 是每個命令必需的；不會為您預先選擇任何內容。粗略的起點 — 非基準測試，僅是傾向於有效的選擇：
| slug | plan | implement | review | image-gen |
|---|---|---|---|---|
xai-grok/grok-4.5 | ✅ 小–中型，範圍明確 | ✅ 任何保真度 | ✅ | ○ JPEG |
openai-codex/gpt-5.6-sol | ✅ 中–大型，模糊 | ○ | ✅ | ✅ PNG |
anthropic-claude/opus-5 | ✅ 中–大型，模糊 | ○ | ✅ | ✗ |
google-antigravity/gemini-3.6-flash | ○ | ✅ 需要高–極高細節 | ○ | ○ JPEG |
anthropic-claude/sonnet-5 | ○ | ✅ 需要高細節 | ○ | ✗ |
✅ 推薦 · ○ 可用 · ✗ 不支援。對於 plan，限定詞是席位能吸收多少模糊性；對於 implement，則是計畫必須有多明確。
這些是粗略的建議，而非測量結果。如果任務不完全符合某一行 — 或者使用者已說明他們希望如何分配工作 — 請詢問使用者，而非自行猜測。
其他已註冊席位，規則相同：openai-codex/gpt-5.6-terra / -luna（較便宜的編碼層級）、anthropic-claude/fable-5（最困難、執行時間最長的工作）、anthropic-claude/haiku-4-5（快速解答）、google-antigravity/gemini-3.1-pro（僅 -high/-low），以及 agy 的 claude-sonnet-4-6 / claude-opus-4-6-thinking / gpt-oss-120b-medium — 在 Antigravity 配額上進行 Claude 和 GPT 級別的工作，當同一提供者的席位是您想要避免的時候，這一點很重要。執行 aibridge models [--json] 以獲取每個席位的準確事實（接受的努力級別、圖像格式、固定的模型 ID）。aibridge <command> --help 列出每個席位。
- grok 有嚴格的速率限制（約 30 req/min，約 1000 msgs/day；
aibridge quota追蹤每週信用額度使用情況）：一次只運行一個 grok 階段。它是唯一能容忍模糊簡報的席位，因此應將其用於輸入不明確的情況，而非已有詳細計畫的地方。 - 保持審查者與實施者來自不同模型 — 模型審查自己的差異時會共享其自身的盲點。推薦的席位已經不同；如果您覆蓋了一個席位，請檢查另一個。同樣的邏輯也適用於您：對於您自己撰寫的工作，請優先選擇您自己模型系列之外的審查者。
- 配額是相對於協調者而言的。 每個後端花費其自身 CLI 的登入/配額。一個與執行此技能的代理共享配額的後端（對於基於 Claude 的代理是
anthropic-claude/*— 它會向 claude CLI 的訂閱收費 — 對於基於 Antigravity 的代理是google-antigravity/*，等等）是最後的選擇：在使用前請先說明。 - 在配額不足時更換席位：
openai-codex/gpt-5.6-sol[-<effort>]（自己的 ChatGPT 登入）是任何席位的常用替代方案。 - 配額預檢會在每次委派前自動運行；
aibridge quota是在規劃流程時進行手動快速檢查（約兩秒）的方法。
安全與信任模型
- aibridge 的設計宗旨是進行真實的委派：在工具模式下，後端 CLI 讀取/寫入檔案並運行 shell — 其信任級別與執行此技能的代理相同。此處沒有任何內容比使用者已經授予其代理和那些 CLI 的存取權限更多（當使用者安裝並認證它們時）。
- 委派會將任務提示（以及委派者選擇讀取的任何內容）發送給後端 CLI 的提供者。請勿委派使用者不願意發送給該提供者的內容；對於不受信任的輸入，請使用
--no-tools— 委派者將無法存取檔案或 shell，僅能進行推理。 - CLI 是 npm 上的
@aibridge/cli，透過 OIDC 從公共儲存庫 (https://github.com/ycmjason/aibridge) 發布，具有 SLSA 來源證明。其套件沒有安裝時腳本，並且具有一個可稽核的單一執行階段依賴樹。 - 在使用者安裝此技能且 CLI 透過 npx/npm 在其自己的帳戶下執行之前，不會運行任何內容。