Files
ccg-workflow/commands/ccg/debug.md
T
li c74c8c927b feat: 新增 MCP 动态选择系统 v1.3.0
## 主要更新

### 1. MCP 动态选择
- ✨ 支持安装时选择 MCP 提供商(ace-tool 或 auggie)
- 🔧 自动生成 ~/.ccg/config.toml 配置文件
- 🔄 命令模板根据配置动态路由 MCP 工具

### 2. 命令模板简化
- 📝 移除外部文档引用(memorys/MCP_USAGE.md)
- 🎯 自包含配置读取说明,减少 50% 提示词长度
- 🔍 统一模式:读取 config → 获取 provider → 调用对应工具

### 3. 配置驱动架构
- 🗂️ 新增 [mcp.tools] 工具名称映射
- 🏷️ 参数名映射(query vs information_request)
- 🚫 优雅处理缺失功能(auggie 无 prompt enhancement)

### 4. 文件更改
- 修改: install.py(新增 MCP 选择逻辑)
- 修改: config.json(operation: install_mcp)
- 修改: 12 个命令模板(dev, enhance, code, analyze, etc.)
- 删除: SLASH_COMMAND_FORMAT.md, UPDATES.md(已合并到文档)
- 更新: CHANGELOG.md, README.md, CLAUDE.md

### 5. 兼容性
- ✅ 向后兼容:默认使用 ace-tool
- ✅ 支持跳过 MCP 安装
- ✅ 配置不存在时使用默认值

Breaking Changes: 无
2026-01-05 19:42:44 +08:00

3.4 KiB
Raw Blame History

description
description
UltraThink 多模型调试(Codex 后端诊断 + Gemini 前端诊断)

/ccg:debug - UltraThink 多模型调试

Usage

/ccg:debug <问题描述>

Context

  • 问题描述: $ARGUMENTS
  • 使用 ace-tool 检索相关代码上下文
  • Codex 专注后端/逻辑问题,Gemini 专注前端/UI问题

工作流程

注意: 本命令使用 MCP 代码检索工具。请先读取 ~/.ccg/config.toml 确定 MCP 提供商(ace-tool 或 auggie),然后使用对应的工具。

Phase 1: 上下文检索

  1. 调用代码检索工具:
    • 根据 ~/.ccg/config.toml 中 [mcp.tools] code_search_{provider} 调用对应工具
    • 参数:project_root_path(项目根目录), 查询参数使用配置中 query_param_{provider} 对应的名称
    • 查询参数名使用 query_param_{provider} 的值("query" 或 "information_request")
  2. 收集错误日志、堆栈信息、复现步骤
  3. 识别问题涉及的模块(前端/后端/全栈)

Phase 2: 并行诊断

同时启动两个后台任务(run_in_background: true):

注意:调用前先读取对应角色提示词文件,将内容注入到 <ROLE> 标签中。

Codex 后端诊断

codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
<ROLE>
{{读取 prompts/codex/debugger.md 的内容}}
</ROLE>

<TASK>
Debug: <问题描述>

Context:
<相关代码>
</TASK>

OUTPUT: Structured diagnostic report. No code modifications.
EOF

Gemini 前端诊断

codeagent-wrapper --backend gemini - $PROJECT_DIR <<'EOF'
<ROLE>
{{读取 prompts/gemini/debugger.md 的内容}}
</ROLE>

<TASK>
Debug: <问题描述>

Context:
<相关代码>
</TASK>

OUTPUT: Structured diagnostic report. No code modifications.
EOF

Phase 3: 假设整合

  1. 收集两个模型的诊断报告(使用 TaskOutput)
  2. 交叉验证:识别重叠和互补的假设
  3. UltraThink 综合:
    • 整合所有假设,按可能性排序
    • 筛选出 Top 1-2 最可能原因
    • 设计验证策略

Phase 4: 用户确认(Hard Stop)

输出格式:

## 🔍 诊断结果

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

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

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

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

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

Phase 5: 修复与验证

  1. 根据确认的诊断实施修复
  2. 修复完成后,强制并行调用 Codex + Gemini 审查修复
  3. 综合审查意见,确认问题解决

输出格式

## Phase 1: 上下文检索
- 检索到 X 个相关文件
- 问题类型: [前端/后端/全栈]

## Phase 2: 并行诊断
### Codex 诊断
<诊断内容>

### Gemini 诊断
<诊断内容>

## Phase 3: 综合分析
### Top 假设
1. [最可能原因] - 可能性: High
2. [次可能原因] - 可能性: Medium

### 验证策略
- [具体验证步骤]

## Phase 4: 确认
**是否按此诊断进行修复?(Y/N)**

## Phase 5: 修复验证(用户确认后)
- 修复内容: <具体修改>
- 双模型审查: <审查结果>

关键原则

  1. 不假设,先验证 - 所有假设需要证据支持
  2. 并行诊断 - 充分利用双模型的不同视角
  3. 用户确认 - 修复前必须获得确认
  4. 交叉审查 - 修复后双模型验证