该技能用于系统化地调查、修复并记录缺陷,适合需要深入分析、测试覆盖和正式缺陷修复报告的场景。简单缺陷直接修复;复杂缺陷会生成多个互相竞争的实现方案以择优。
用途:按流程修复缺陷,保证回归测试覆盖与文档记录。
主要流程:确定缺陷名称(kebab-case)→ 分支创建(如提到 T-[编号] 工单,则自动创建 T-{number}/bugfix-{bug-name} 分支并将工单置为 in-progress,无需询问;无工单时用 AskUserQuestion 提供 bugfix/{bug-name} 或跳过分支选项)→ 调用 systematic-debugger 技能做结构化根因分析(含初始概览、系统检查、五问法根因分析、方案与验证四阶段)→ 在实现修复前编写失败的回归测试(红/绿 TDD 的红)→ 依据 references/report-template.md 生成 specs/bugfixes/<bug-name>/report.md → 用 /commit 技能提交调查检查点 → 评估缺陷难度。简单缺陷直接实现并跑回归测试、全量测试与 lint;复杂缺陷则并行启动多个隔离工作区中的智能体:Agent 1 用 Agent 工具(subagent_type: general-purpose,isolation: worktree)实现主要方案,Agent 2 用同样工具实现替代方案,Agent 3 用 mcp__devtools__kiro-agent(agent: kiro,yolo-mode: true)先手动创建 worktree:git worktree add ../{repo-name}-worktrees/fix-{bug-name}-kiro -b fix-{bug-name}-kiro HEAD。比较后按正确性、最小改动、代码质量、安全性、可维护性择优,可写 solution-comparison.md,并用 git cherry-pick 整合胜出方案,最后清理工作区(git worktree remove …、git branch -D fix-{bug-name}-kiro)。
Transit 集成:识别 T-[编号] 后自动建分支、更新状态并附评论;PR 创建后置为 ready-for-review 并评论 PR 链接;无工单时跳过所有 Transit 步骤,不主动提交或建 PR。
输出:缺陷修复并验证、回归测试通过、全量测试通过、报告存于 specs/bugfixes/<bug-name>/report.md;复杂路径另生成 solution-comparison.md;有工单时提交、建 PR 并用 /pr-review-fixer 处理首轮评审反馈。
限制:仅当提到 Transit 工单时才执行工单相关状态与 PR 操作;无工单时除非要求否则不提交代码。具体依赖的工具名称、MCP 工具与路径均如上述,未提供的内容暂未说明。