AIが書いたコードコメントによく見られる残念な9パターン(qiita.com)

- コードを読めばわかる内容をそのまま説明するコメントが多い。原文はそうしたコメントを削除し、本当に必要なときだけ、なぜそうするのかを書くよう勧めている。 - コメントは説明対象のコードのすぐ前に置くべきだ。メソッド内の特定の処理についての説明をメソッド定義の直前に書くと、関数全体の説明と誤解されやすい。 - 過去の変更履歴や特定の呼び出し箇所といった情報は、コードコメントよりもコミットメッセージ、プルリクエストの説明、呼び出し側のコメントに書く方がよいと原文は説明している。 - 原文の筆者は、AIが書いたコメントをそのまま信用せず、人が確認すべきだと述べている。また、コメントのルールをCLAUDE.mdのようなAI向けの指示ファイルにまとめる方法も提案している。