SuperAPI AI 工具集

fix

编程与开发

查看项目

更新于 11-06 09:09

技能介绍

用途

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、测试或代码评审发现的问题。

限制

  • 未完成同问题根因追踪前不得改代码;不得通过表面补丁绕过门槛。
  • 子代理、测试、规格、评审等阶段有固定顺序与门槛,偏离需用户批准。
  • 具体安装方式、价格和平台支持信息暂未提供。