多模型协作
灵动桌面框架以 Claude Code 为主控,内置三个协同技能,可以把指定任务交给 Codex CLI、Gemini CLI 或 Antigravity CLI(agy)执行,再由 Claude Code 整合结果。
只在你点名时才协作
三个协同技能都写明了「未点名一律不激活」:只有你在需求里明确说出「用 Codex」「让 Gemini 看看」「用 agy」这类话,Claude Code 才会把任务委托出去。需求里出现「UI 设计」「原型」「算法」「代码审查」「交叉验证」等字样,不会自动触发委托,仍由 Claude Code 按对应技能(ui-frontend、bug-detective、code-patterns 等)自己完成。
协作架构
┌─────────────────────────────────────────────────────┐
│ 开发者需求 │
│ "用 Codex 审一下 src-tauri/src/services" │
└──────────────────────┬──────────────────────────────┘
↓
┌──────────────────────────────────────────────────────┐
│ Claude Code(主控) │
│ │
│ 1. 强制技能评估:识别到点名 → 激活对应协同技能 │
│ 2. 前置检查:CLI 已安装、已认证 │
│ 3. 用英文写委托提示词,调用外部 CLI │
│ │
│ ┌────────────────┐ ┌────────────────┐ ┌───────────┐ │
│ │ codex_bridge.py│ │gemini_bridge.py│ │ agy -p │ │
│ │ → Codex CLI │ │ → Gemini CLI │ │ (直调) │ │
│ └────────────────┘ └────────────────┘ └───────────┘ │
│ │
│ 4. 解析 JSON 结果 → 整合、落地、质量把控 │
└──────────────────────────────────────────────────────┘
三个协同技能
| 技能 | 外部工具 | 调用方式 | 前置要求 |
|---|---|---|---|
collaborating-with-codex | OpenAI Codex CLI | python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py --cd . --PROMPT "..." | npm install -g @openai/codex,已配置 OpenAI API Key |
collaborating-with-gemini | Google Gemini CLI | python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py --cd . --PROMPT "..." | npm install -g @google/gemini-cli,已配置 GEMINI_API_KEY 或 gemini auth login |
collaborating-with-antigravity | Google Antigravity CLI | agy -p '...' --output-format json(原生非交互,无需桥接脚本) | 已安装 agy,agy models 能列出模型即已认证 |
前置检查不通过时,Claude Code 会停下告诉你,而不是自己去安装或换用别的 CLI。
Codex 协同
- 桥接脚本返回 JSON:
success、SESSION_ID、agent_messages,失败时带error。 - 默认沙箱
read-only,可选workspace-write/danger-full-access;--yolo跳过全部审批与沙箱(危险)。 - 保存
SESSION_ID可多轮续聊;支持--image附图、按需让 Codex 产出 Unified Diff 补丁。 --model只在你明确指定模型时才传。
Gemini 协同
- 返回格式同 Codex 桥接:
success、SESSION_ID、agent_messages、error。 - 默认开启只读沙箱,
--no-sandbox允许 Gemini 执行工具;--include-directories可追加跨项目目录。 --SESSION_ID传会话索引号或latest续接上次会话。- 技能里明确提示:后端逻辑任务 Gemini 理解有缺陷,此类任务优先点名 Codex。
Antigravity 协同
- 一个入口能调到多家厂商的模型(Gemini、Claude、GPT-OSS),适合点名做「同一份设计让不同模型各评一遍」。
--output-format json返回conversation_id、status、response、usage(真实 token 用量)。--json-schema强制结构化输出,结果在structured_output字段——这是另外两个桥接没有的能力。--continue接最近一次对话,--conversation <ID>恢复指定对话;--mode plan只读规划不落盘。- print 模式默认超时只有 5 分钟,长任务要加
--print-timeout。
协作场景示例
场景一:点名 Codex 审查后端
开发者:"用 Codex 审一下 src-tauri/src/services 的错误处理"
Claude Code:
├── 1. 激活 collaborating-with-codex,检查 Codex CLI 可用
├── 2. 用英文写审查提示词,read-only 沙箱调用 codex_bridge.py
├── 3. 解析 agent_messages,逐条核对审查意见是否成立
└── 4. 采纳的意见由 Claude Code 自己改代码并验证
场景二:点名 Gemini 出 UI 方案
开发者:"让 Gemini 给设置页出两个布局方案"
Claude Code:
├── 1. 激活 collaborating-with-gemini
├── 2. 调用 gemini_bridge.py,拿到布局方案
├── 3. 按 ui-frontend、theme-system 技能把方案落成 React + Ant Design 代码
└── 4. 保存 SESSION_ID,需要调整时续接同一会话
场景三:点名 agy 做多模型交叉验证
开发者:"用 agy 让两个不同厂商的模型分别评一下这份 IPC 设计,按 JSON 返回结论"
Claude Code:
├── 1. 激活 collaborating-with-antigravity,agy models 确认已认证
├── 2. 写 JSON Schema(结论 / 评分 / 理由),分别指定 --model 调用两次
├── 3. 读取 structured_output,对比两份结论
└── 4. 汇总分歧点,给出统一建议
与 /dev-orchestrate 的关系
在智码 AICoder 里跑 /dev-orchestrate 时,验收子会话默认交给 Codex 做异构验收(实现和验收用不同模型,减少同一模型的盲区)。这是编排命令自己的机制,不经过上面的协同技能,也不需要你逐次点名。详见 快捷命令。
优势总结
| 优势 | 说明 |
|---|---|
| 按需委托 | 只在你点名时调用外部 CLI,不会擅自消耗其他平台的额度 |
| 交叉验证 | 点名让不同厂商的模型独立评审,减少单一模型盲区 |
| 结构化返回 | 统一返回 JSON,agy 还能按 JSON Schema 强制输出 |
| 可续接 | 保存会话 ID,多轮迭代不丢上下文 |
| 主控兜底 | 外部结果由 Claude Code 核对后再落地,代码仍遵循框架规范 |