Claude が書く長いコメントは、Claude 自身の役に立っていなかった

はじめに 株式会社Sally 所属エンジニアの @wellPicker です。 弊社では、スマホやパソコンでマダミスを遊べるアプリであるウズや、マダミス情報・予約管理サイトマダミス.jp、マダミス開発ツールウズスタジオを開発しています。 マダミスについてはこちらをご覧ください。 Claude Code に実装させていると、コメントがやたら長くなります。気になって本人に聞いてみたところ、想定と違う答えが返ってきました。そこからルールを整備したのですが、思ったほど効かず、原因を調べたら「削れない理由」がはっきりしました。 その一連の記録です。 まず実物 弊社バックエンド（Go）の、WebSocket の圧縮設定です。Claude が書きました。 // WebSocket フレーム圧縮 (RFC 7692 permessage-deflate) を有効化する。 // クライアント (Dart g

[ton-boo]

変更の履歴を書き込みがち、超わかる。git log とPRに書くべき、超々わかる。で、実際にそっちに書いてくれたりもするけどほっとくとコメントにも書くんだよな。やめて欲しいからグローバルルール試してみよかな

[password1234]

“本人に聞いてみた” これ意味ないので、この方法で方針決めたらだめだよ

[devorgachem]

あるときとないときで何回か繰り返して統計取ったのかなと思ったらAIへのアンケートだった。AIへのアンケートはどこまで信用できるのだろう

[monorod]

別にコメントの情報に意味があるなら、コメントはいくら書いて貰ってもいいと思ってるので、分量の変化を見て判断すると言う考え方はどうなのと思った。why以外書かないのも大事だけど、whyをちゃんと書くのも大事

[Magicant]

何も指示しないと周りを真似るので、ちょっと変なコメントが紛れ込むとどんどん伝染する

[mska]

病的に書くよな。わざわざ言わねえと、碌でもない言い訳みたいなのつらつら書きやがる

[diveintounlimit]

これなぁ。書いても書いても無視するんだよな。文書を書くという塊に対してはスキルをロードして何とか防衛できるが。

[matarillo]

「経緯・マイグレーション履歴は書かず、最新仕様のスナップショットだけを書く。」ほぼ同様の指示をしてる。claudeの癖だろうと思う

[m50747]

実装する前に実装方針.mdを作ってもらい内容壁打ちしてOKならそれに沿って実装してもらってる。開発後は開発ログ.mdを実行したコマンド全部の粒度で残してもらって勉強している。なのでコメント長過ぎ問題は未体験です

[boxmanx99]

自信がない箇所ほど、言葉で埋めて補強しようとする←これはほんとそう。実装よりコードが長いときはバグってがち

[nori__3]

AIに聞いても意味なくない？とはいえコメント書かないならもっと読みやすいコードにしてくれ感はある。コードに限らずだけどなんかAIが書いた文章や資料が読めなくなってきている自分がいる

[strawberryhunter]

ドキュメントの変更履歴とか理由をがっつり書くのは、清書を指示しても思ったような結果にならなくて、ぐちゃぐちゃになった SKILL.md がある。まあ、ちゃんと機能しているけど、トークンは無駄になってそう。

[NetPenguin]

ん？この記事、AI生成だったりしない？ なんか生成AIっぽい言い回しが目立つ？

[Cherenkov]

自白

[jb8079431525325]

Opus5は顕著よな。大して重要でもないことをダラダラと書き連ねた挙句次のエージェントがそれを読んで情報希薄化させるのバカみたい。スコープ決めても平然と破って議論を発散させてくる。無能だった頃のChatGPTみたい

[fujixe]

企業のテックブログ、技術力アピールするつもりがこうやって逆宣伝になる場合もあるよな

[doko]

claudeは都合が悪くなると美文調というかレトリックに逃げる傾向があると思う。特にFableは大言壮語が過ぎる

[ultimatebreak]

やって、は意外とやってくれるけど、やるな、は無視しがち

[progrhyme]

ついカッとなってコーディングコメントのレビュースキル作っちゃった

[narukami]

当事者に説明させると合ってる時もあれば正解から程遠い時もあるよ

[inatax]

"本人に聞いてみた" ヽ(･ω･)/ｽﾞｺｰ

[yorkfield]

"// ユーザー ID を取得する の下に final userId = await getUserId(); があっても、情報量はゼロ" ／ 最初のコメント例はコードの説明ではなく背景を書いてるから、初手から言ってることが食い違ってない？

[nguyen-oi]

AIが自分用に長文コメント残すの完全に人間と同じ挙動で草。WHYだけ書かせないと文脈食い潰すのは納得だな

[gosho-kazuya]

コメントが無駄なの、めっちゃ分かる。何ならレビュー時に全部消してる。