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（语义化版本）进行比较。 - 通过 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。在运行全局安装前请询问用户。
需要在 PATH 中并已认证的后端 CLI：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、effort、图像格式） | — |
路由
-
第一个词是子命令名称 → 加载该参考文件并遵循它。这是不可协商的：参考文件中包含了使输出质量良好的提示词设计——跳过它会产生泛泛的结果。
-
未给出子命令 → 根据请求推断：
- 图像/图标/图形制作 →
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] 获取精确的每席位信息（接受的 effort、图像格式、固定模型 ID）。aibridge <command> --help 列出所有席位。
- grok 有严格的限制（约 30 请求/分钟，约 1k 消息/天；
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 在其自己的账户下执行之前，什么也不会运行。