用途:当用户明确要求修复问题、定位 bug 或进入 debug 流程时使用本技能。它提供结构化的修复与调试工作流,并声明自身拥有修复/调试主流程控制权,执行期间不调用会接管该流程的外部 skill;业务领域类安全/规范技能可按需加载作防御性参考,但不接管流程。不适用于普通功能实现、语言或框架风格规范、正式 code review、环境级风险判断。
主要能力:包含两套模式。Fix Mode 适用于问题边界较清楚、可直接修复的场景,步骤为确认期望行为与当前症状、阅读相关代码路径、做最小有效修复、对原始问题路径做定向验证、说明残余风险。Debug Mode 适用于症状明确但根因不清楚的场景,步骤为复现或描述症状、提出具体假设、用低成本检查验证假设、基于证据做最小修复、回测原始问题路径。
使用方式:进入 fix 前,若项目内已有主线任务处于进行中且本次 fix 只是临时插入,先用 cc-task-state 或直接在主线任务文件补“中断记录”,写明当前做到哪、为何切出、恢复入口和下一步。遇到前后端联调、列表页、分页、筛选项或详情页异常时,补充使用 cc-api-contract-safety;遇到外部黑盒系统异常或连续 2 轮凭代码推理修复 no-op 时,补充使用 cc-external-system-debugging,先抓真实数据再推理。若 fix 会打断主线任务,优先记录 checkpoint;只有范围独立、可能跨多轮的插入修复才单独建任务。先核对真实接口返回、统一成功响应格式和分页结构,再决定修后端根因还是保留前端临时兼容;若保留兼容分支,必须说明退出条件。
输出要求:明确区分症状、假设、修复和验证;若打断主线任务,说明是否已补 checkpoint 及主线如何恢复;没有证据时不声称已找到根因;不因调试过程顺手扩大问题范围。按需展开的参考文档包括 references/fix-mode.md、references/debug-mode.md、references/verification-after-fix.md。