SuperAPI AI 工具集

cd-fix

测试与质量

查看项目

更新于 10-15 20:09

技能介绍

用途:cd-fix 用于在范围明确、风险可控的前提下执行 bug 修复,强调根因分析、最小改动与验证。

适用前提(开始前须全部满足):存在具体问题信号(明确的失败行为、错误或回归,且有日志、堆栈、失败测试或可复现步骤等证据);修复路径可能局部化(问题限于小范围,无跨系统重设计或迁移预期);架构风险低到中等(无需基础性改动,无分阶段发布或功能开关策略);验证路径直接(可实际复现并做修复后检查,成功标准可直接验证)。任一条件不满足,应升级到 brainstorm 或 write-plan。

硬性停止升级条件:聚焦调查后根因仍不清晰;修复需要横切架构或数据模型改动;范围扩大为大型重构或多模块迁移;涉及安全/合规敏感行为;验证发现需要分阶段缓解的大范围回归;多次修复尝试仍无法收敛到根因。出现上述情况时须停止实现,并输出指定信息,建议先 brainstorm 或 write-plan 以定义分阶段诊断、实现与风险控制。

工作流程:1)接收与上下文,明确期望行为,确认 bug 报告最小字段(标题、期望行为、实际行为、复现步骤、证据、环境、影响/严重度);2)复现与诊断,稳定复现,定位失败点,追踪控制/数据流找出根因,形成并确认修复假设;3)判断小修还是大修,若根因清晰、改动面窄、回归风险有限则继续本技能,否则升级;4)实现,给出 1-3 条简要计划,做最小针对性改动,严格限定范围,避免无关重构,补充或更新回归测试;5)验证,按范围递增执行聚焦检查、邻近回归检查及相关项目检查(lint/typecheck/tests/build);6)完成与报告,说明根因、改动内容、为何有效、验证结果及残余风险/后续事项。

规则:关键上下文缺失时不要猜测,应通过 Question Tool 询问;始终优先根因修复;保持影响范围最小;未验证不得标记完成;范围或风险超出本技能时尽早升级。报告不完整时可使用内置 bug 报告模板补充标题、期望行为、实际行为、复现步骤、错误日志/堆栈、环境、影响/严重度及附加上下文。具体命令与代码资料暂未提供。