SuperAPI AI 工具集

fix

编程与开发

查看项目

更新于 10-15 21:11

技能介绍

用途:当用户明确要求修复问题、定位 bug 或进入 debug 流程时使用本技能。不适用于普通功能实现、语言或框架风格规范、正式 code review、环境级风险判断。

主要能力:提供两种模式。Fix Mode 适用于问题边界较清楚、可直接修复的场景,步骤为确认期望行为与当前症状、阅读相关代码路径、做最小有效修复、对原始问题路径做定向验证、说明残余风险。Debug Mode 适用于症状明确但根因不清楚的场景,步骤为复现或描述症状、提出具体假设、用低成本检查验证假设、基于证据做最小修复、回测原始问题路径。

使用方式:进入 fix 前,若项目内已有主线任务处于进行中且本次 fix 只是临时插入事项,先用 cc-task-state 或直接在主线任务文件里补“中断记录”,写明当前做到哪、为何切出、恢复入口和下一步,再进入修复流程。遇到前后端联调、列表页、分页、筛选项或详情页异常时,补充使用 cc-api-contract-safety;若 fix 会打断当前主线任务,优先记录 checkpoint,只有范围独立、可能跨多轮的插入修复才单独建任务;先核对真实接口返回、统一成功响应格式和分页结构,再决定修后端根因还是保留前端临时兼容;若保留兼容分支,必须说明退出条件,不把双格式兼容长期固化。

输出要求:明确区分症状、假设、修复和验证;若本次修复打断主线任务,明确说明是否已补 checkpoint 以及主线如何恢复;没有证据时不声称已找到根因;不因调试过程顺手扩大问题范围。

按需展开:直接修复见 references/fix-mode.md,结构化排查见 references/debug-mode.md,修复后验证见 references/verification-after-fix.md。