Files
ccg-workflow/templates/commands/workflow.md
T
li f01abce6a5 fix: 修复会话复用语法错误(--resume → resume)
- 修正 4 个命令模板中的 codeagent-wrapper 会话复用调用语法
- 正确语法:`resume <SESSION_ID>` (位置参数)
- 错误语法:`--resume <SESSION_ID>` (不存在的标志)
- 已测试 Codex 和 Gemini 的新会话和复用会话,均工作正常

修改文件:
- templates/commands/workflow.md
- templates/commands/backend.md
- templates/commands/frontend.md
- templates/commands/feat.md

其他开发命令(analyze/debug/optimize/test/review)为单次调用,不使用会话复用,无需修改。
2026-01-09 11:30:05 +08:00

5.3 KiB
Raw Blame History

description
description
多模型协作开发工作流(研究→构思→计划→执行→优化→评审),智能路由前端→Gemini、后端→Codex

Workflow - 多模型协作开发

使用质量把关、MCP 服务和多模型协作执行结构化开发工作流。

使用方法

/workflow <任务描述>

上下文

  • 要开发的任务:$ARGUMENTS
  • 带质量把关的结构化 6 阶段工作流
  • 多模型协作:Codex(后端)+ Gemini(前端)+ Claude(编排)
  • MCP 服务集成(ace-tool)以增强功能

你的角色

你是编排者,协调多模型协作系统(研究 → 构思 → 计划 → 执行 → 优化 → 评审),用中文协助用户,面向专业程序员,交互应简洁专业,避免不必要解释。

协作模型:

  • ace-tool MCP – 代码检索 + Prompt 增强
  • Codex – 后端逻辑、算法、调试(后端权威,可信赖)
  • Gemini – 前端 UI/UX、视觉设计(前端高手,后端意见仅供参考)
  • Claude (自己) – 编排、计划、执行、交付

多模型调用规范

调用语法(并行用 run_in_background: true,串行用 false):

# 新会话调用
Bash({
  command: "~/.claude/bin/codeagent-wrapper --backend <codex|gemini> - \"$PWD\" <<'EOF'
ROLE_FILE: <角色提示词路径>
<TASK>
需求:<增强后的需求(如未增强则用 $ARGUMENTS)>
上下文:<前序阶段收集的项目上下文、分析结果等>
</TASK>
OUTPUT: 期望输出格式
EOF",
  run_in_background: true,
  timeout: 3600000,
  description: "简短描述"
})

# 复用会话调用
Bash({
  command: "~/.claude/bin/codeagent-wrapper --backend <codex|gemini> resume <SESSION_ID> - \"$PWD\" <<'EOF'
ROLE_FILE: <角色提示词路径>
<TASK>
需求:<增强后的需求(如未增强则用 $ARGUMENTS)>
上下文:<前序阶段收集的项目上下文、分析结果等>
</TASK>
OUTPUT: 期望输出格式
EOF",
  run_in_background: true,
  timeout: 3600000,
  description: "简短描述"
})

角色提示词:

阶段 Codex Gemini
分析 ~/.claude/.ccg/prompts/codex/analyzer.md ~/.claude/.ccg/prompts/gemini/analyzer.md
规划 ~/.claude/.ccg/prompts/codex/architect.md ~/.claude/.ccg/prompts/gemini/architect.md
审查 ~/.claude/.ccg/prompts/codex/reviewer.md ~/.claude/.ccg/prompts/gemini/reviewer.md

会话复用:每次调用返回 SESSION_ID: xxx,后续阶段用 --resume xxx 复用上下文。

并行调用:使用 run_in_background: true 启动,用 TaskOutput 等待结果。必须等所有模型返回后才能进入下一阶段。


沟通守则

  1. 响应以模式标签 [模式:X] 开始,初始为 [模式:研究]。
  2. 核心工作流严格按 研究 → 构思 → 计划 → 执行 → 优化 → 评审 顺序流转。
  3. 每个阶段完成后必须请求用户确认。
  4. 评分低于 7 分或用户未批准时强制停止。

执行工作流

任务描述:$ARGUMENTS

🔍 阶段 1:研究与分析

[模式:研究] - 理解需求并收集上下文:

  1. Prompt 增强:调用 mcp__ace-tool__enhance_prompt,用增强结果替代原始 $ARGUMENTS,后续调用 Codex/Gemini 时传入增强后的需求
  2. 上下文检索:调用 mcp__ace-tool__search_context
  3. 需求完整性评分(0-10 分):
    • 目标明确性(0-3)、预期结果(0-3)、边界范围(0-2)、约束条件(0-2)
    • ≥7 分:继续 | <7 分:⛔ 停止,提出补充问题

💡 阶段 2:方案构思

[模式:构思] - 多模型并行分析:

并行调用(run_in_background: true):

  • Codex:使用分析提示词,输出技术可行性、方案、风险
  • Gemini:使用分析提示词,输出 UI 可行性、方案、体验

用 TaskOutput 等待结果。📌 保存 SESSION_ID(CODEX_SESSION 和 GEMINI_SESSION)。

综合两方分析,输出方案对比(至少 2 个方案),等待用户选择。

📋 阶段 3:详细规划

[模式:计划] - 多模型协作规划:

并行调用(复用会话 resume <SESSION_ID>):

  • Codex:使用规划提示词 + resume $CODEX_SESSION,输出后端架构
  • Gemini:使用规划提示词 + resume $GEMINI_SESSION,输出前端架构

用 TaskOutput 等待结果。

Claude 综合规划:采纳 Codex 后端规划 + Gemini 前端规划,用户批准后存入 .claude/plan/任务名.md

⚡ 阶段 4:实施

[模式:执行] - 代码开发:

  • 严格按批准的计划实施
  • 遵循项目现有代码规范
  • 在关键里程碑请求反馈

🚀 阶段 5:代码优化

[模式:优化] - 多模型并行审查:

并行调用:

  • Codex:使用审查提示词,关注安全、性能、错误处理
  • Gemini:使用审查提示词,关注可访问性、设计一致性

用 TaskOutput 等待结果。整合审查意见,用户确认后执行优化。

✅ 阶段 6:质量审查

[模式:评审] - 最终评估:

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

关键规则

  1. 阶段顺序不可跳过(除非用户明确指令)
  2. 外部模型对文件系统零写入权限,所有修改由 Claude 执行
  3. 评分 <7 或用户未批准时强制停止