株式会社Sally（ウズアプリ、マダミス関連プロジェクト）の筆者は、Claude Codeが生成するコードの過剰なコメントを減らそうと、まずルールファイルに「コメントを減らす」指針を追加しました。しかし導入前が18.5%だったコメント比率は、導入後も19〜21%とほぼ変わらなかったといいます。
そこで筆者は同じ指針を、git diff HEAD -U0 | grepでコメント行を抽出し1行ずつ判定する手順を含む「skill」として組み込み直しました。「記憶で判断せず、必ず抽出して1行ずつ見直す」という手順に落とし込んだところ、1PRあたりのコメント行数の中央値は27行から21行、平均は47行から30行に減少したとしています。
筆者は、AIエージェントへの指示は「思い出すべきルール」としてではなく「実行される手順（skill）」として与える方が効果的だと結論づけています。
出典が伝えている要点
- ルール導入前のClaude Codeが生成したコメント比率は18.5%だった
- ルールファイルにコメント削減の指針を追加した後もコメント比率は19〜21%とほぼ変化しなかった
- 筆者はskill内にgit diff HEAD -U0 | grepコマンドで変更されたコメント行を抽出する手順を追加した
- その手順では抽出したコメント行を1行ずつ判定するプロセスが含まれる
- 手順導入後、1PRあたりのコメント行数の中央値は27行から21行に減少した
- 手順導入後、1PRあたりのコメント行数の平均は47行から30行に減少した
- この取り組みは筆者が所属する株式会社Sallyのプロジェクト（ウズアプリ、マダミス関連、UZU-XXXX形式のタスクID使用）で行われた
原文より
記憶で判断せず、必ず抽出して1行ずつ見直す
出典: zenn.dev