SuperAPI AI 工具集

techdebt

通用与其它

查看项目

更新于 10-16 00:23

技能介绍

用途:在代码库中识别并修复技术债,适合在开发会话结束时做清理。

主要能力(按资料):查找代码重复(逻辑相似的函数、复制粘贴块、应抽象化的重复模式);死代码(未使用的导入、未使用的函数或类、被注释掉的代码块、不可达路径);过时写法(已废弃 API、旧式字符串格式化 % 或 .format 与 f-string、typing.List 与 list、公共函数缺少类型标注);代码坏味道(函数超过 50 行、参数超过 5 个、嵌套超过 3 层、魔法数字、过于复杂的条件);缺失最佳实践(公共函数缺 docstring、缺错误处理、硬编码值应改为配置、关键路径缺测试)。

工作流:扫描代码库并按影响与修复难度排优先级;报告发现(按类别列出,含文件路径与行号,评估严重程度高中低);修复问题(从高严重度且易修复的开始,每次修复创建原子提交,每次改动后运行测试);验证(运行 linter:ruff check .;运行测试:pytest;确保未引入新问题)。

用法:可选指定目录或文件作为焦点。 /techdebt - 扫描整个项目 /techdebt src/ - 扫描指定目录 /techdebt src/utils.py - 扫描指定文件

输出:总结发现的问题(按类别)、已修复的问题、留给后续会话的遗留项。

限制:资料未提供收费标准、支持语言范围、安装方式与效果保证等信息。