forge-fix

Forge Fix - 独立 Bug 修复

描述 bug → 对抗调试定位根因 → TDD 修复 → 独立验证 → 循环直到修好。

这是 forge-teams 的独立 bug 修复入口。复用已有的对抗调试引擎（hypothesis-investigator、devils-advocate、evidence-synthesizer、issue-fixer），但提供独立编排、快速路径分流和三层迭代控制。

Announce at start: "I'm using the forge-fix skill to create an agent team that will locate and fix this bug through adversarial debugging and TDD."

前置条件: 需要启用 Agent Teams 实验性功能。 在 settings.json 中添加: "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" }

用法

/forge-fix <bug-description> [options]

参数说明

参数	说明	默认值
<bug-description>	bug 描述（文本、文件路径、或错误日志）	必填
--loop <N>	最大修复-验证循环次数	3
--quick	快速路径：跳过对抗调试，直接用 issue-fixer 修复（适用于简单 bug）	不启用
--team-size <size>	假设调查团队规模（small=3 假设, medium=4, large=5）	medium
--no-verify	修复后跳过独立验证（不推荐）	启用验证

示例

# 直接描述 bug
/forge-fix "支付回调间歇性超时，大约每10次失败2次"

# 简单 bug，快速路径
/forge-fix "登录页面 CSS 错位" --quick

# 复杂 bug，加大团队 + 增加循环
/forge-fix "高并发下 Redis 连接池泄漏" --team-size large --loop 5

# 从错误日志修复
/forge-fix "npm test 报错: TypeError: Cannot read property 'id' of undefined at src/user.ts:42"

输出目录

docs/forge-fix/
└── [bug-slug]-[timestamp]/
    ├── intake.md              # 问题信息收集
    ├── hypotheses.md          # 假设列表（非 quick 模式）
    ├── debate-log.md          # 对抗辩论记录（非 quick 模式）
    ├── verdict.md             # 根因判定
    ├── fix-report.md          # TDD 修复报告
    ├── verification.md        # 独立验证报告
    └── summary.md             # 最终修复摘要

---

Quick vs Full Path Decision (快速路径分流)

用户描述 bug
    │
    ├── --quick 指定 → 快速路径
    │
    └── 未指定 → Lead 评估复杂度
        │
        ├── 简单信号 → 建议快速路径（用户确认）
        │   - 单文件、单函数问题
        │   - 错误信息直接指向根因（如 TypeError at file:line）
        │   - 纯 UI/CSS 问题
        │   - typo 或明显逻辑错误
        │
        └── 复杂信号 → 完整对抗调试路径
            - 间歇性故障
            - 多个可能根因
            - 涉及并发/状态/竞态
            - 跨模块/跨服务
            - "时有时无"、"偶尔"、"不稳定"

---

Quick Path (快速路径)