减注释靠步骤不靠规则
Skills Beat Rules For Comments
要点
- 把“只写不可还原信息”放进 rules 或全局 CLAUDE.md，评论占比几乎没降。
- 同一套清单写进 /pr skill：用 git diff 抽出新增注释再逐行判定去留。
- 改成步骤后每 PR 注释中位数从 27 行降到 21 行，长注释块也变少。
- 靠主观判断的条目例如变更历史，即使用步骤仍会留下。
原帖开头
🧹 ピックアップ ✨ Claude Codeのコメント過多に対し、ルールを設定ファイルに書くだけでは効果がなかったが、same内容を手順としてskillに組み込んだところ、コメント量が実際に減ったという検証結果を共有しています。 https://zenn.dev/uzu_tech/articles/58a84a9346b910
