techdebt

用途：在代码库中识别并修复技术债，适合会话结束时执行清理。主要能力包括四类检查——代码重复（相似逻辑函数、复制粘贴块、可抽象重复模式）、死代码（未使用导入、未使用函数或类、注释掉的代码、不可达路径）、过时写法（废弃 API、旧式 % 或 .format 字符串、typing.List 而非 list、公有函数缺类型标注）、代码坏味道（函数超 50 行、参数超 5 个、嵌套超 3 层、魔法数字、过于复杂的条件）、缺失最佳实践（公有函数缺 docstring、缺错误处理、硬编码值未配置化、关键路径缺测试）。工作流为：扫描代码库并按影响与修复难度排序；按类别报告问题，含文件路径、行号与严重程度；优先修复高严重度且易改的问题，每个修复做原子提交并跑测试；最后运行 ruff check . 与 pytest 验证不引入新问题。用法：/techdebt 扫描整个项目；/techdebt src/ 扫描指定目录；/techdebt src/utils.py 扫描指定文件。输出为已发现问题（按类别）、已修复问题、留待后续会话处理事项的摘要。限制：资料未提供安装方式、具体收费、适用平台或效果保证，暂未提供。