SuperAPI AI 工具集

code-rot-cleaner

通用与其它

查看项目

更新于 10-15 23:44

技能介绍

用途:帮助识别软件项目中可能可移除的代码,避免把“正则没搜到”误当成“可以安全删除”。发现与验证阶段保持真实项目不变,把删除视为需要经受静态检查、动态引用检查和项目命令验证的主张。

主要能力:默认 report-only 模式,仅检查项目并生成报告产物,不删除、编辑、重命名、卸载或重组代码;将证据保存到 outputs/code-rot-cleaner/。提供三种模式:report-only(默认,盘点并排序候选)、prove(经批准后在一次性副本中尝试移除并重新生成报告)、apply-approved(清理检查点获批后仅修改指定真实文件并运行已批准检查)。使用 SAFE TO REMOVE、REVIEW、KEEP 三种状态保守分类;仅静态检查或仅构建通过都不能判定为 SAFE TO REMOVE。

使用方式:先映射仓库,识别语言、入口、清单、框架约定、生成目录、测试与构建命令及 Git 状态,排除依赖、构建输出、缓存等。运行捆绑扫描器:python3 scripts/analyze_code_rot.py /absolute/path/to/project outputs/code-rot-cleaner/analysis.json。候选仅作线索,需人工检查路由、脚本、配置、模板、插件加载、反射、依赖注入、glob 导入、CLI 入口、迁移、测试与部署文件。运行项目代码前须展示命令并获批准,随后可执行:python3 scripts/prove_candidates.py /absolute/path/to/project outputs/code-rot-cleaner/analysis.json outputs/code-rot-cleaner/proof.json --confirm-run-project-code --command "npm test" --command "npm run build"。生成报告:python3 scripts/generate_report.py outputs/code-rot-cleaner/analysis.json outputs/code-rot-cleaner/CODE-ROT-REPORT.md outputs/code-rot-cleaner/cleanup-plan.csv --proof outputs/code-rot-cleaner/proof.json --review outputs/code-rot-cleaner/review.json。

适用场景:需要在改动前评估死代码、生成可审计清理计划、在一次性副本中验证移除影响的项目。

限制:调用技能仅表示同意检查项目并生成报告,不表示同意删除或修改;执行仓库控制的构建、测试、lint、类型检查或包管理器命令前需批准;修改真实项目需第二次明确批准并指定候选 ID 与文件;不得重置、清理或改写历史;若检查失败,只恢复本技能自己的已批准编辑,不得丢弃无关用户工作。资料未提供具体收费、价格、平台支持范围等信息。