Files
ccg-workflow/templates/commands/debug.md
T
li 48af319c0d feat: 添加轻量模式,禁用 Web UI 加速响应 (v1.7.27)
- codeagent-wrapper 支持 --lite / -L 参数和 CODEAGENT_LITE_MODE 环境变量
- 轻量模式禁用 WebServer,使用 1 秒 post-message 延迟
- 初始化流程添加 Web UI 开关选项
- 命令模板自动注入 {{LITE_MODE_FLAG}} 占位符
- 配置支持 performance.liteMode 持久化
2026-01-14 20:50:22 +08:00

3.4 KiB
Raw Blame History

description
description
多模型调试:Codex 后端诊断 + Gemini 前端诊断,交叉验证定位问题

Debug - 多模型调试

双模型并行诊断,交叉验证快速定位问题根因。

使用方法

/debug <问题描述>

你的角色

你是调试协调者,编排多模型诊断流程:

  • Codex – 后端诊断(后端问题权威)
  • Gemini – 前端诊断(前端问题权威)
  • Claude (自己) – 综合诊断、执行修复

多模型调用规范

调用语法(并行用 run_in_background: true):

Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> - \"$PWD\" <<'EOF'
<TASK>
需求:<增强后的需求(如未增强则用 $ARGUMENTS)>
上下文:<错误日志、堆栈信息、复现步骤等>
</TASK>
OUTPUT: 诊断假设(按可能性排序)
EOF",
  run_in_background: true,
  timeout: 3600000,
  description: "简短描述"
})

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

等待后台任务(使用最大超时 600000ms = 10分钟):

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

重要:必须指定 timeout: 600000,否则默认只有 30 秒会导致提前超时。 如果 10 分钟后仍未完成,继续用 TaskOutput 轮询,绝对不要 Kill 进程。


执行工作流

问题描述:$ARGUMENTS

🔍 阶段 0:Prompt 增强(可选)

[模式:准备] - 如 ace-tool MCP 可用,调用 mcp__ace-tool__enhance_prompt,用增强结果替代原始 $ARGUMENTS,后续调用 Codex/Gemini 时传入增强后的需求

🔍 阶段 1:上下文收集

[模式:研究]

  1. 调用 mcp__ace-tool__search_context 检索相关代码(如可用)
  2. 收集错误日志、堆栈信息、复现步骤
  3. 识别问题类型:[后端/前端/全栈]

🔬 阶段 2:并行诊断

[模式:诊断]

⚠️ 必须发起两个并行 Bash 调用(参照上方调用规范):

  1. Codex 后端诊断:Bash({ command: "...--backend codex...", run_in_background: true })
  2. Gemini 前端诊断:Bash({ command: "...--backend gemini...", run_in_background: true })

两个调用的 OUTPUT 都是:诊断假设(按可能性排序),每个假设包含原因、证据、修复建议

用 TaskOutput 等待两个模型的诊断结果。必须等所有模型返回后才能进入下一阶段。

🔀 阶段 3:假设整合

[模式:验证]

  1. 交叉验证双方诊断结果
  2. 筛选 Top 1-2 最可能原因
  3. 设计验证策略

⛔ 阶段 4:用户确认(Hard Stop)

[模式:确认]

## 🔍 诊断结果

### Codex 分析(后端视角)
<诊断摘要>

### Gemini 分析(前端视角)
<诊断摘要>

### 综合诊断
**最可能原因**:<具体诊断>
**验证方案**:<如何确认>

---
**确认后我将执行修复。是否继续?(Y/N)**

⚠️ 必须等待用户确认后才能进入阶段 5

🔧 阶段 5:修复与验证

[模式:执行]

用户确认后:

  1. 根据诊断实施修复
  2. 运行测试验证修复

关键规则

  1. 用户确认 – 修复前必须获得确认
  2. 信任规则 – 后端问题以 Codex 为准,前端问题以 Gemini 为准
  3. 外部模型对文件系统零写入权限