代码注释变成「AI垃圾」?这个Skill专门清理废话注释
你的代码里,是不是有那种「这行代码实现了XX功能」——明眼人一看就知道在干啥,还要硬塞一句注释?
更别提那种「// 修复了bug」「// 优化了性能」的决策日志注释,搞得代码历史比代码本身还长。
comments-audit 就是来解决这个问题的。
这个 Skill 会自动扫描代码仓库里的注释,识别出 5 种典型的「AI 垃圾注释」:
- 重述型:注释只是把代码翻译了一遍,傻子都看得懂
- 决策日志型:大段记录「为什么要这么写」,放 changelog 更合适
- 自夸型:「这个实现很优雅」「太聪明了」,代码不需要掌声
- Docstring 越界型:本该简洁的地方写成了小作文
- 分割 Banner 型:满屏
// ==========// -----的视觉污染
它的工作方式是:先用 Shiki 语法高亮引擎提取注释,再让 Claude 逐条判断质量,最后生成一份「需要清理」的清单,还支持 --fix 直接帮你修。
GitHub 只有 16 星——这个数量级的 Star 说明什么?说明这个 Skill 还藏在水面下,没被大多数人发现。但它解决的是真实痛点:代码 review 时那些让人皱眉的注释,AI 写的代码尤其容易出现这种问题。
使用方式:装好后,在 Claude Code 里直接喊 /comments-audit,或者加参数控制范围,比如 --all 全扫、--path src/ 只扫某目录。
npx skills add https://github.com/bendrucker/claude --skill comments-audit
适合谁用:代码审查洁癖患者、团队代码规范负责人、以及每次 PR 看到满屏废话注释就血压升高的人。
GitHub:https://github.com/bendrucker/claude
评论区
0 条评论
登录后可评论。