跳到正文
灵动桌面框架
Esc
本栏目菜单

多模型协作

灵动桌面框架以 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-codexOpenAI Codex CLIpython .claude/skills/collaborating-with-codex/scripts/codex_bridge.py --cd . --PROMPT "..."npm install -g @openai/codex,已配置 OpenAI API Key
collaborating-with-geminiGoogle Gemini CLIpython .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-antigravityGoogle Antigravity CLIagy -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 核对后再落地,代码仍遵循框架规范