用途
fix 是一个面向“根因修复”的实现技能,适用于工作流中的某个步骤,或用户直接要求以根因方式修复问题并补充回归覆盖的场景。核心目标:消除每个问题的根因,而不是修改表面症状。
主要能力
- 根因前置门槛:直接调用时,必须先通过 $investigate --mode=debug 在同一次会话中针对当前问题产出根因追踪(file:line 证据、假设矩阵、正向证明),否则禁止编辑代码。
- 调试思维:每个结论都需要 file:line 证据,未追踪的结论只能标注为假设。
- 置信度与证据门槛:必须声明 Confidence: X% 并附证据,低于 70% 需停止并补充证据。
- 影响分析与修复计划:复杂修复前先生成计划并经过批准。
- 底层修复:修复应落在持有不变量的最底层,而非崩溃点。
- 回归覆盖:独立调用时通过 $integration-test 添加或更新回归测试;必要时使用 $test 并记录理由。
- 规格一致性检查:按情况修正或同步 spec 文档与测试用例。
- 变更审查与验证:生产代码修复需经过 $changes-review,随后由 $why-review 审签,最后执行一次验证(含变异检查,即回退修复后回归测试必须失败)。
使用方式
- 无标志运行完整诊断→修复主线。
- 使用 --target={ci|issue|logs|review|test|types|ui} 选择自包含的分支,将诊断与修复限定到对应领域。
- 默认模式为 HARD;仅当 5 个“简单缺陷”条件全部满足时才可进入快速模式。
- 工作流内嵌套调用(nested=true)时,可复用工作流已完成的 investigate --mode=debug 追踪与计划,测试在后续 verify 步骤统一运行。
适用场景
需要定位并消除缺陷根因、补充回归测试、并保持规格与代码一致的开发修复任务,尤其是涉及生产代码、CI、日志、类型、UI、测试或代码评审发现的问题。
限制
- 未完成同问题根因追踪前不得改代码;不得通过表面补丁绕过门槛。
- 子代理、测试、规格、评审等阶段有固定顺序与门槛,偏离需用户批准。
- 具体安装方式、价格和平台支持信息暂未提供。