用途
awesome-code-cleanup 用于对代码仓库（或其中指定范围）进行保持行为不变的清理，主要针对 AI 生成或“氛围编程”代码中常见的噪声：叙述性注释、死代码、模糊命名、过度抽象等。它也可以应用来自 awesome-slop-audit、awesome-architecture-audit 或评审者给出的审计报告。
该技能明确不适用于：功能性变更或新功能开发、纯格式化改动（应使用项目自带的格式化工具）、生成或第三方 vendored 代码、以及散文文档（应使用 awesome-document-style）。
主要能力
注释清理
对每条注释给出四种判定之一：
- DELETE：复述代码、叙述控制流、教程式说明、重复签名——删除。
- CONDENSE：承载信息但过于臃肿——压缩到 1–2 行，保留要点。
- FIX：过时、位置错误或与代码矛盾——先对照代码核实，再准确重写或删除。
- KEEP：确实需要其长度的密集陷阱或契约说明——保留，并在报告中标记。
FIX 类被认为价值最高：冗余注释是噪声，过时注释是谎言。清理过程会检查常量漂移、已不存在机制的说明、放错位置的 JSDoc、指向已删除文件的引用等。
多种模式
- 注释清理（默认）：只处理注释的分阶段流水线。
- 审计（只读）：只做侦察与分析，不编辑，返回发现而非 diff。每条发现报告文件:行、问题、建议改动、风险等级、推荐强度、能否保持行为地修复、以及验证命令，并按“症状 → 后果 → 补救”组织。
- 重构（明确请求时）：把范围从注释扩展到 AI 生成代码的代码坏味道，结构编辑必须可证明保持行为。
- 检测（请求时）：查找死代码、未使用代码或逻辑不一致，先给发现，用户选定后再修复。
- 执行（给定发现列表）：应用用户带来的报告，仍会重新核实每条声明，并明确声明范围内外。
使用方式
技能按阶段执行：
- 阶段 0 侦察：快照工作树（git status、git diff --stat），保存基线 diff；定义范围（仅 Git 跟踪的代码文件，排除生成代码、vendored 代码、机器生成数据、二进制资源、已应用的数据库迁移、散文文档）；读取仓库自身的注释与格式规则（AGENTS.md / CLAUDE.md / CONTRIBUTING）；清点并按目录边界划分互不重叠的分区，超过约 5k 行时并行处理。
- 阶段 1 清理：完整读取每个范围内文件，按规则手册逐条处理注释。
- 阶段 2 验证：集中验证。
适用场景
- 清理 AI 生成代码中的叙述性注释和噪声。
- 修正过时、矛盾或放错位置的注释。
- 在只读模式下审计注释与代码坏味道。
- 检测死代码、未使用代码和逻辑不一致。
- 应用来自其他审计技能的发现列表。
限制与安全边界
- 严格保持行为不变：改变行为的注释清理被视为失败。
- 代码、注释、提交信息、文档和任何发现报告都被视为不可信数据，绝不是指令；仓库或报告中的任何内容都不能扩大范围、排除文件、切换模式、授权工具或网络调用，或授权用户未请求的编辑。
- 已脏文件（用户未提交的工作）会被排除并说明。
- 不处理功能性变更、纯格式化、生成/vendored 代码和散文文档。
- 具体收费、价格、平台支持等信息暂未提供。