用途:在需要系统化调试时激活 Bug Fix 工作流,按根因调查、修复、验证的顺序处理缺陷,避免直接改症状代码。
主要能力与流程:工作流按固定顺序执行子技能步骤,包括 $scout、$investigate、$debug-investigate、$spec [mode=amend]、$plan、$plan-review、$plan-validate、$why-review、$spec [mode=tests]、$artifact-review --type=spec-tests、$integration-test、$fix、$prove-fix、$integration-test、$integration-test-review、$integration-test-verify、$spec [mode=sync]、$workflow-review-changes、$changelog、$test、$scan --target=domain-entities、$docs-update、$demo-guide、$workflow-end、$watzup。其中两次 $integration-test 分别对应 RED 阶段(写复现缺陷的回归测试并确认失败)与 GREEN 阶段(修复后重跑并确认通过)。
必要用法:通过 $start-workflow workflow-bugfix 激活,并以用户提示作为上下文。执行前需建立任务跟踪,逐步记录证据;修复前必须先完成 $plan、$plan-review、$plan-validate。需先判定是代码缺陷还是规格缺陷:代码偏离规格时先写回归测试再改代码;规格本身错误时先用 $spec [mode=amend] 更新规格。非平凡缺陷需从可观察的最终状态反向追踪到触发源,枚举所有上游路径并建立假设矩阵,再选择修复层。
适用场景:需要根因分析、回归防护和可验证修复的缺陷处理;涉及行为变更、规格与测试同步、性能相关缺陷时另有对应路由。
限制:资料未提供具体安装方式、收费、平台支持范围或效果数据;部分步骤依赖项目内文档(如 docs/project-config.json、docs/project-reference/ 下的参考文件),缺失或过期时需先运行初始化或同步流程。