用途:该技能仅用于修复程序缺陷(bug),不用于新功能开发或重构;遇到功能或重构需求应改用 run-orchestrator。其核心原则是「无根因不修复」,要求在源头修复而非处理表象症状。
流程分四步。S1 调查:由 lead(inline)使用 Read/Grep/Bash 复现缺陷,读取错误与堆栈、用 git log / git diff 查看近期改动,并反向追踪坏数据来源;为节省上下文,先 Grep 定位出错符号,再用 offset+limit 只读取命中行。S2 测试 RED:由 tester 编写能精确复现缺陷的失败测试,并按 skills/test-writer/SKILL.md#test-type-selection 选择层级——UI、用户流程、认证、支付回归用 Playwright MCP 写 e2e 规格,纯逻辑用单元测试,测试必须因正确原因失败,并由用户确认失败。S3 修复 GREEN:由 architect / frontend / mobile(经 agent-detector 按产物选择)做聚焦、最小的根因修复,由用户确认测试通过。S4 验证:由 tester 运行完整测试套件;若 S2 写了 e2e 规格,还需运行 npx playwright test 或 npx cypress run,两者均不得有回归。
每步需向用户播报进度,并更新 run-state.json#current_step(取值 investigate、test-red、fix-green、verify 之一)与 #active_agent,使状态栏反映真实情况。输出格式包含 Root Cause、Test Added、Fix Applied、Verification 四部分。
限制与升级:必须「先读输出,再声称结果」,无通过计数的「测试通过」等于未收集到测试;「先临时修一下」「大概就是 X」「看起来修好了」等表述均为红灯信号,须回到第 1 步。若缺陷为间歇性、竞态条件、仅本地可复现或存在多种可能原因,应升级到 skills/deep-debugging/SKILL.md。相关规则包括 tdd-workflow.md、verification.md、execution-rules.md、simplicity-over-complexity.md。该资料未提供独立的安装命令、收费或平台信息。