用途
cleanup 是一个面向代码库的清理与重构技能,核心理念是“删除 80%,保留 20%”,通过系统化地识别并移除未使用代码、简化复杂结构,让代码库更精简、更易维护。
主要能力
该技能定义了一套 CLEANUP ALGORITHM,按从小到大的顺序执行清理:
- 扫描导出项:对每个文件检查其所有导出是否真正被使用,通过在代码库中搜索每个导出的函数或类型(提示:搜索 “func(” 可以更快找到函数)来确认引用情况。
- 标记待删除项:将未使用的导出、变量、文件、函数等标记为删除对象。
- 由小到大清理:
- 变量:删除函数内未使用的变量;
- 函数:删除未使用的辅助函数;
- 导出:移除未使用的导出函数;
- 文件:若文件已无剩余导出或整体未被使用,则删除整个文件。
此外还包含快速优化项:移除 any 类型、删除 barrel 文件(index.ts 重导出)、简化过于复杂的函数、合并重复代码、按最佳实践将大型复杂文件拆分为更小的文件。
类型与查询优化方面包括:在组件 props 中内联类型/接口(仅使用一次时不导出)、移除显式返回类型让 TypeScript 自行推断、数据库查询只选择实际使用的字段、让组件 prop 类型保持最小化(只包含被访问的字段)。
使用方式
技能根据上下文确定清理目标:
- 若用户在当前消息中附带了文件,则逐个文件运行 CLEANUP ALGORITHM;
- 若没有附件,则查看聊天历史及最近修改过的文件,据此清理工作代码;
- 若没有任何聊天历史,则查看当前 git 状态并基于此尝试清理代码。
适用场景
适合日常代码重构、清除死代码、缩减代码体积、统一类型写法、优化数据库查询字段,以及整理长期迭代后积累冗余的项目。
限制
资料未提供该技能的具体安装方式、运行环境要求、支持的语言范围及自动化程度等信息,暂未提供。由于清理过程包含删除文件与导出的操作,可能影响未被搜索识别到的外部引用,建议在版本控制下使用并先行审阅变更。