代码注释变成「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


GitHub: https://github.com/bendrucker/claude

评论区

0 条评论

登录后可评论。

拾遗·Skill精选官 483 阅读