SuperAPI AI 工具集

vibe-code-cleanup

编程与开发

查看项目

更新于 10-16 03:37

技能介绍

用途:面向快速搭建、能运行但存在失效导入、重复逻辑、死代码、环境变量不清等问题的全栈应用,在发布或交接前进行安全、增量的清理,使其达到可维护的生产基线。核心原则是“做手术而非拆房”:只移除可证明已死的代码,保留其他一切,不因外观原因重写可用系统,不改动路由、slug、API 端点、工具输入输出、API 契约、数据库 schema 与认证流程。

主要能力与使用方式:

  1. 侦察:先只读不改,用 find 列出页面路由,用 npx tsc --noEmit 找失效导入,用 npx ts-prune 找未使用导出,用 grep 搜索 console.log、debugger、TODO、FIXME、HACK 等调试残留。
  2. 先修失效导入:按 tsc 报错修复引用,不删除被引用文件,除非确认全局未使用。
  3. 验证后删死代码:仅当无文件导入、未在配置/站点地图/路由清单中出现、且非公开页面路由时,才可移除;用 grep 确认。
  4. 合并重复逻辑:对出现 3 次以上的模式(如 SEO 元数据、带错误处理的 fetch 包装、slugify/formatDate/truncate 等工具函数)提取共享 helper;一次性业务逻辑、不同契约的路由处理器、涉及 DB 或认证的代码不合并。
  5. 环境变量审计:用 grep 提取 process.env 变量,与 .env.example 比对,标记缺失项;绝不要把密钥提交进版本控制。
  6. 每批改动后验证:运行 npx tsc --noEmit、npx eslint . --ext .js,.jsx,.ts,.tsx --max-warnings 0、npm run build、npm test -- --runInBand --passWithNoTests;若构建或类型检查失败,回退上一批。
  7. 提交策略:每次提交只做一个逻辑单元,例如 fix: remove broken import in app/blog/page.js、refactor: consolidate social metadata into lib/socialMetadata.js,不要把 UI 改动、逻辑改动与文件删除混在一个提交中。

适用场景:AI 生成应用上线前、交接前,或需要整理探索性代码、保持向后兼容且避免大规模重写时。

限制:仅凭代码无法推断产品意图,删除路由、组件、API 契约或数据模型前必须确认行为;清理应以小批量、可审查方式进行,因为大范围重构会掩盖回归;在缺少明确需求与测试时,不应改动认证、计费、持久化或第三方集成行为。具体支持的框架范围与命令细节以资料为准,其他价格、平台与效果信息暂未提供。