用途:这是一个“技术债模式”技能,用于识别、编目并消除技术债务,适用于查找代码异味、审计 TODO、删除死代码、清理未使用导入或评估代码质量。触发方式为“use tech-debt mode”,也可在相关场景下触发。
核心理念:删除是最强大的重构。资料提出 40% 规则:AI 辅助编码中,预期花 30-40% 时间用于代码健康(评审、异味检测、重构),否则会产生隐形债务。
主要能力:识别以下债务指标——注释类(TODO、FIXME、HACK、XXX、“temporary”)、代码异味(重复块、超过 50 行的长函数)、类型问题(缺少类型提示、Any 类型、type: ignore)、死代码(未使用函数、不可达分支)、依赖(过时包、未使用导入)、复杂度(深层嵌套、长参数列表)。
处理流程:1)扫描:用 grep 查找 TODO/FIXME,查找超长函数、类型错误文件、未使用导出。2)分类:评估严重性、修复工作量与风险。3)优先级:先做低投入高影响的快速修复、先修风险债、优先高频改动代码。4)修复或记录:简单修复直接做(带测试),复杂修复制定后续计划。
报告格式:包含摘要(问题总数、严重、快速修复、需规划)、发现(按严重、快速修复、需规划分类,以表格列出位置、类型、问题、工作量)、建议处理顺序、本次已修复项。
修复规范:每次改动后运行测试;保持改动原子且聚焦;验证无回归;不将债务修复与新功能混在一处;不为无理由重构可运行代码。
安全删除:删除前确认未使用,可用 ag 检索用法与导入,例如:ag "function_name" --python;注意动态调用(getattr、eval)、反射框架、外部 API 契约、CLI 入口点。
清理清单:移除未用导入、未用变量、死函数、注释掉的代码、调试语句;合并重复代码;测试仍通过;类型仍检查通过。
预防建议:添加 TODO 时附 issue 链接,从一开始使用类型提示,定期评审简化机会。资料未提供价格、平台或具体安装命令。