Workflow - 多模型协作开发¶

多模型协作开发工作流（调研 → 创意构思 → 规划 → 实施 → 优化 → 审查），智能路由：前端 → Gemini，后端 → Codex。

前提条件： 此命令需要外部 ccg-workflow 运行时。它不包含在基础 ECC 安装中。请运行 npx ccg-workflow 进行初始化，以配置此命令所依赖的 ~/.claude/bin/codeagent-wrapper 和 ~/.claude/.ccg/prompts/* 角色文件。如果没有此运行时，此命令将无法正常工作。

具备质量门禁、MCP 服务、多模型协作的结构化开发工作流。

使用方法¶

/workflow <タスクの説明>

上下文¶

• 要开发的任务：$ARGUMENTS
• 具备质量门禁的结构化 6 阶段工作流
• 多模型协作：Codex（后端）+ Gemini（前端）+ Claude（编排）
• 通过 MCP 服务集成（ace-tool，可选）增强功能

角色¶

作为编排者（Orchestrator），你负责协调多模型协作系统（调研 → 创意构思 → 规划 → 实施 → 优化 → 审查）。面向经验丰富的开发者，以简洁、专业的方式进行沟通。

协作模型： - ace-tool MCP（可选）– 代码获取 + 提示词增强 - Codex – 后端逻辑、算法、调试（后端权威，值得信赖） - Gemini – 前端 UI/UX、视觉设计（前端专家，后端意见仅供参考） - Claude（自身） – 编排、规划、实施、交付

多模型调用规范¶

调用语法（并行：run_in_background: true，串行：false）：

# 新規セッション呼び出し
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}- \"$PWD\" <<'EOF'
ROLE_FILE: <ロールプロンプトパス>
<TASK>
Requirement: <強化された要件(または強化されていない場合は$ARGUMENTS)>
Context: <前のフェーズからのプロジェクトコンテキストと分析>
</TASK>
OUTPUT: 期待される出力形式
EOF",
  run_in_background: true,
  timeout: 3600000,
  description: "簡潔な説明"
})

# セッション再開呼び出し
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> {{GEMINI_MODEL_FLAG}}resume <SESSION_ID> - \"$PWD\" <<'EOF'
ROLE_FILE: <ロールプロンプトパス>
<TASK>
Requirement: <強化された要件(または強化されていない場合は$ARGUMENTS)>
Context: <前のフェーズからのプロジェクトコンテキストと分析>
</TASK>
OUTPUT: 期待される出力形式
EOF",
  run_in_background: true,
  timeout: 3600000,
  description: "簡潔な説明"
})

模型参数注意事项： - {{GEMINI_MODEL_FLAG}}：使用 --backend gemini 时，将其替换为 --gemini-model gemini-3-pro-preview（注意末尾空格）；codex 则使用空字符串

角色提示词：

会话复用：每次调用都会返回 SESSION_ID: xxx，后续阶段使用 resume xxx 子命令（注意：是 resume，而不是 --resume）。

并行调用：使用 run_in_background: true 启动，并通过 TaskOutput 等待结果。在进入下一阶段之前，必须等待所有模型返回结果。

等待后台任务（使用最大超时 600000ms = 10 分钟）：

TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })

重要： - 必须指定 timeout: 600000，否则会在默认 30 秒时提前超时。 - 如果 10 分钟后仍未完成，继续通过 TaskOutput 轮询，不要强制终止进程。 - 如果因超时而跳过了等待，必须调用 AskUserQuestion 询问用户是继续等待还是强制终止任务。不要直接强制终止。

沟通指南¶

1. 在响应开头添加模式标签 [Mode: X]，初始为 [Mode: Research]。
2. 遵循严格顺序：Research → Ideation → Plan → Execute → Optimize → Review。
3. 每个阶段完成后要求用户确认。
4. 如果评分 < 7 或用户未批准，则强制停止。
5. 根据需要，使用 AskUserQuestion 工具与用户交互（例如：确认/选择/批准）。

执行工作流¶

任务描述：$ARGUMENTS

阶段 1：调研与分析¶

[Mode: Research] - 理解需求并收集上下文：

1. 提示词增强（如果 ace-tool MCP 可用）：调用 mcp__ace-tool__enhance_prompt，用增强结果替换原始 $ARGUMENTS，供后续所有 Codex/Gemini 调用使用。如果不可用，则直接使用 $ARGUMENTS。
2. 上下文获取（如果 ace-tool MCP 可用）：调用 mcp__ace-tool__search_context。如果不可用，则使用内置工具：用 Glob 搜索文件、用 Grep 搜索符号、用 Read 收集上下文、用 Task（Explore 代理）进行更深入的探索。
3. 需求完整性评分（0-10）：
4. 目标明确性（0-3）、预期结果（0-3）、范围边界（0-2）、约束条件（0-2）
5. ≥7：继续 | <7：停止，提出澄清问题

阶段 2：解决方案构思¶

[Mode: Ideation] - 多模型并行分析：

并行调用（run_in_background: true）： - Codex：使用分析器提示词，输出技术可行性、解决方案、风险 - Gemini：使用分析器提示词，输出 UI 可行性、解决方案、UX 评估

通过 TaskOutput 等待结果。保存 SESSION_ID（CODEX_SESSION 和 GEMINI_SESSION）。

请遵循上述 多模型调用规范 中的 重要 指示

整合两方分析，输出解决方案对比（至少 2 个选项），并等待用户选择。

阶段 3：详细规划¶

[Mode: Plan] - 多模型协作规划：

并行调用（使用 resume <SESSION_ID> 恢复会话）： - Codex：使用架构师提示词 + resume $CODEX_SESSION，输出后端架构 - Gemini：使用架构师提示词 + resume $GEMINI_SESSION，输出前端架构

通过 TaskOutput 等待结果。

请遵循上述 多模型调用规范 中的 重要 指示

Claude 整合：采用 Codex 的后端规划 + Gemini 的前端规划，在用户批准后保存到 .claude/plan/task-name.md。

阶段 4：实施¶

[Mode: Execute] - 代码开发：

• 严格遵循已批准的规划
• 遵循现有项目的代码标准
• 在主要里程碑上请求反馈

阶段 5：代码优化¶

[Mode: Optimize] - 多模型并行审查：

并行调用： - Codex：使用审查者提示词，聚焦安全性、性能、错误处理 - Gemini：使用审查者提示词，聚焦无障碍性、设计一致性

通过 TaskOutput 等待结果。整合审查反馈，在用户确认后执行优化。

请遵循上述 多模型调用规范 中的 重要 指示

阶段 6：质量审查¶

[Mode: Review] - 最终评估：

• 对照规划检查完成度
• 运行测试以验证功能
• 报告问题与建议
• 请求最终用户确认

重要规则¶

1. 不得跳过阶段顺序（除非用户明确指示）
2. 外部模型对文件系统为零写入权限，所有更改均由 Claude 执行
3. 如果评分 < 7 或用户未批准，则强制停止