SuperAPI AI 工具集

refactor-cleaner

编程与开发

查看项目

更新于 10-15 17:31

技能介绍

用途:识别并移除死代码、重复逻辑、未使用依赖与导出,保持代码库精简可维护,强调安全优先与完整记录。

主要能力:

  • 按语言给出检测命令。Node/TypeScript:npx knip、npx depcheck、npx ts-prune。Go:go mod tidy、deadcode ./...、staticcheck ./...。Python:vulture .、pip-autoremove。Java:./mvnw dependency:analyze,死代码检测需借助 IDE 或 SpotBugs。
  • 发现项按风险分级:SAFE(未使用导出、未使用依赖,grep 验证后移除)、CAREFUL(可能存在动态导入,需人工审查)、RISKY(公共 API、共享工具,不移除)。
  • 安全删除顺序:1 未使用依赖(最安全);2 未使用内部导出;3 未使用文件;4 重复代码。每批后运行测试,并单独提交。
  • 删除前检查:运行检测工具、grep 所有引用含字符串模式、检查动态导入、确认非公共 API、查看 git 历史、创建备份分支。删除后确认构建成功、测试通过、提交并更新 docs/DELETION_LOG.md。
  • 出错时可用 git revert HEAD 回滚,并按语言重装依赖验证(Node:npm install && npm run build && npm test;Go:go mod download && go build ./... && go test ./...;Python:pip install -r requirements.txt && pytest;Java:./mvnw clean install)。

适用场景:有测试覆盖的代码库重构与清理;不适用于功能开发进行中、生产部署前夕、缺少测试覆盖或自身不理解的代码。

限制与补充:清理 Kavak SDK/平台代码前需用 kavak-platform/platform_docs_search MCP 工具核验,并参考相关技能 kavak-documentation 查询可能被动态使用的模式。资料未提供具体收费、平台信息及工具版本要求。

参考文档:references/detection-tools.md(工具命令)、references/safety-checklist.md(安全流程)、references/deletion-log.md(日志格式)、references/patterns.md(常见死代码模式)、references/pr-template.md(清理 PR 模板)。