SuperAPI AI 工具集

ln-512-tech-debt-cleaner

通用与其它

查看项目

更新于 10-16 06:23

技能介绍

用途:消费代码库审计结果,自动清理安全、低风险的技术债。输入来自 docs/project/codebase_audit.md(ln-620 输出)或 ln-511 代码质量输出,可独立运行,也可由 ln-510 质量协调流水线调用。

主要能力:可自动修复未使用导入、未使用变量、未导出未使用函数、超过 5 行的注释代码块、超过 6 个月的后向兼容垫片、不支持的别名、行尾空白与空行。明确不处理 DRY 违规、上帝类、安全问题、架构违规、性能问题,以及工作量为 M 或 L 的发现。

使用方式:加载审计报告并解析死代码与代码质量部分;按类别、严重级别(仅 LOW/MEDIUM)、工作量(仅 S)过滤,跳过 node_modules、vendor、dist、build、压缩文件、生成代码与测试夹具;逐项验证并给出 0-100 置信度,仅当不低于 90 才继续。优先使用 hex-line MCP 处理代码文件、hex-graph 做死代码引用检查,不可用时回退到内置 Read/Edit/Grep。按文件自底向上应用修复,运行 lint/typecheck,通过则 git add 保留,失败则 git checkout -- 回滚该文件。最后创建单个提交并更新审计报告的 Last Automated Cleanup 部分。

适用场景:代码质量分析后的安全清理、定期代码库卫生维护。

限制:不修改函数体、条件或控制流;只操作已跟踪文件;显式按文件名暂存,禁止 git add . 或 git add -A;若未检测到 lint/type 命令则跳过逐文件验证并给出警告;置信度不足或验证失败则跳过。输出 verdict 为 CLEANED、NOTHING_TO_CLEAN 或 ALL_DISCARDED,并附统计与逐项修复状态。具体安装与调用命令资料未提供。