ルールではなくskillに指示を書くことで、Claudeのコメントを減らせた

はじめに 株式会社Sally 所属エンジニアの @wellPicker です。 弊社では、スマホやパソコンでマダミスを遊べるアプリであるウズや、マダミス情報・予約管理サイトマダミス.jp、マダミス開発ツールウズスタジオを開発しています。 マダミスについてはこちらをご覧ください。 Claude Code に実装させると、コメントがやたら長くなります。設定 1 行に 18 行のコメントが付くこともあります。書いてある内容自体は正しく、ライブラリの仕様や過去の事故の経緯が並んでいるのですが、そのぶんコードが読みにくくなります。 これを減らすために「コードから復元できない情報だけを書く」というルールを作り、プロジェクトの .claude/rules/ に、後からグローバルの ~/.claude/CLAUDE.md に置きました。その経緯は前回の記事に書かれています。 しかし後から計測したところ、実

[natsuvien]

AI生成ブログで主張不明。コメントは簡潔にと書けば良いものを冗長に書き、内容を延々と引き伸ばしているだけ。

[jb8079431525325]

「ルールに指示を書いても変わらなかった」としてコメント比率なるものを書いているが、「期間も本数も大きく広げて測り直した」のならその期間と本数も書けよと。便所にでも書いてろやって内容をよくもまあ

[hogetax]

全てが間違っている。仕様・挙動の担保はテスト、冗長コメントの抑止はHooks / Linter / CI、そもそものWhy（文脈）の記録はCommit Message / PR Descriptionで管理すべき

[jintrick]

rulesに書いたって言うけどpathsは*かな？それCLAUDE.mdに書くのと意味同じかそれ以下なんだけど。多分アンチパターン。