用途:从代码库中外科手术式地移除无用注释。判定标准是:有用注释应告诉未来读者无法从代码本身获得的信息,其余视为噪音。此技能只编辑注释,绝不改动代码逻辑;若“修复注释”需要改代码,应上报用户。
主要能力:检测五类高置信度垃圾注释——复述代码的注释、描述编辑过程的旁白式注释、无 TODO 的桩标记、AI 式空泛前言、空 docstring;使用 grep 与启发式规则匹配,非精确工具。保留带问题/PR/工单编号的引用、变通方案及其原因、不变量、非显而易见行为警告、规范/RFC 引用、许可证与版权、类型 pragma 与 lint 禁用、公共 API 的 JSDoc/TSDoc。
使用方式:预检需检测语言、Git 状态(脏工作树则拒绝)、确保报告目录存在。检测后写入 .claude/cleanup-reports/cleanup-slop-{YYYY-MM-DD}.md 评估报告,按 HIGH(删除)、MEDIUM(仅报告)、PRESERVED 分级。仅自动删除 HIGH,保持周围代码缩进;整块皆为垃圾则整块删除,若垃圾前言后附带有用警告则只删前言。单次提交:chore(cleanup): cleanup-slop — removed N unhelpful comments。验证可运行 bunx biome check . 或 npx eslint .、ruff check .,以及文档构建脚本(如 bun run docs / npm run docs),失败则回滚该文件并降级。输出报告路径与验证状态。
限制:不会删除引用编号、不变量警告、pragma、公共 API 文档注释、许可证,也不会改写注释或误删字符串中的伪注释。删除公共 API 注释可能影响文档生成器。收费、价格与具体平台支持暂未提供。