forge-bugfix
一次只修一个 bug + 独立 worktree + 双层验收(forge-qa 自动 → 用户人工)。 每次修完生成结构化验收清单文档,AI 在会话中提供路径供用户点击跳转。 铁律:不做根因分析就不写修复代码 + 修完不自动合并 + 没有验收清单不算完 + 新发现禁止当场顺手修(必须分流到 backlog)+ 多 bug 默认不串成长会话。 会话级(一次性):P0 环境探测 → P1 问题理解 + 强制读 PRD / ENG / Bugfix 历史 / Memory。 每次修复(可循环): P2 范围推荐(用户指定、用户新反馈或从 backlog.md 捞候选)→ P3 创建 worktree + 复现 → P4 根因追踪 + 5 Whys + 方案确认 → P5 worktree 内修复 + 原子提交 → P5.3 生成验收清单文档(docs/bugfix/reviews/BF-XX.md) → P6 调用 forge-qa 做自动验收,填清单 QA 列 → P6.5 用户人工验收(AI 给清单路径,用户填用户列 + 最终结论) → P7 按三选一分流(Pass 合并 / Fail 回 P5 / Pass + 新发现 合并并分流) → P7.5 新发现分流到 backlog.md(同根判定必须举证)→ P8 沉淀。 出口:强烈建议新会话或 /clear、/compact 后继续下一个 bug; 全部完成 → 建议 /forge-review、/forge-ship 或 /forge-fupan。 触发方式:用户说"bugfix"、"反馈个问题"、"修这个 bug"、"这里有问题"、"为什么不对"、"排查一下"、"investigate"、"forge-bugfix", 或用户报告错误、异常行为、功能失效时主动建议使用。