Fix

当用户明确要求修复问题、定位 bug 或进入 debug 流程时，使用本技能。

不要用于：

• 普通功能实现
• 语言或框架风格规范
• 正式 code review
• 环境级风险判断

模式

进入 fix 前，若项目内已有主线任务处于 进行中，且本次 fix 只是临时插入事项，先用 cc-task-state 或直接在主线任务文件里补“中断记录”，写明当前做到哪、为何切出、恢复入口和下一步，再进入修复流程。

Fix Mode

适用于问题边界较清楚、可以直接修复的场景。

1. 确认期望行为和当前症状。
2. 阅读相关代码路径。
3. 做最小有效修复。
4. 对原始问题路径做定向验证。
5. 说明残余风险。

Debug Mode

适用于症状明确但根因不清楚的场景。

1. 复现或描述症状。
2. 提出具体假设。
3. 用低成本检查验证假设。
4. 基于证据做最小修复。
5. 回测原始问题路径。

补充检查

• 遇到前后端联调、列表页、分页、筛选项或详情页异常时，补充使用 cc-api-contract-safety
• 若 fix 会打断当前主线任务，优先记录 checkpoint；只有范围独立、可能跨多轮的插入修复才单独建任务
• 先核对真实接口返回、统一成功响应格式和分页结构，再决定修后端根因还是保留前端临时兼容
• 若保留兼容分支，必须说明退出条件，不把双格式兼容长期固化

输出要求

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

按需展开

• 直接修复：references/fix-mode.md
• 结构化排查：references/debug-mode.md
• 修复后验证：references/verification-after-fix.md