読み込み中

コードレビュー

レッスン 710 分

Claude Codeにコードベース内のタスクを与えると、Claudeはしばしば簡潔に結果を報告します。Claudeが変更した内容の説明の下には、小さなものから大きなものまで、さまざまなファイルの変更が含まれていることがあります。多くの場合、コードの変更を書いて(そしてそれを説明した)セッション自身は、その変更を判断する上で最も質の高い審査者ではありません。変更を保持する前に自分自身で目を通し、その後、このセッションの履歴を持たないクリーンなコンテキストからClaudeに再度レビューさせるのが良い習慣です。

実際の変更をレビューする

diff(差分)とは、変更の前後を示すもので、ファイルごとに削除された行と追加された行を表します。/diff コマンドは、その形式でコミットされていない変更のインタラクティブなビューアーを開き、Claudeの各ターンで何が変更されたかも表示できます。上下の矢印キーでファイル間を移動し、Enter キーでファイルを開きます。

/diff

毎回、特に注意して見直す価値があるのは次のような点です。

  • 依頼していない変更。 Claudeがファイルを編集している間に変更された設定値や、あなたが言及していないのに書き換えられたヘルパーメソッドなど。
  • 弱くなったテスト。 作業しているプロジェクトにテストが含まれている場合、スキップされたり、削除されたり、通過するまで緩められたりしたテストがないか確認してください。
  • 新しいパッケージとハードコードされた値。 1つの関数のためだけに追加された依存関係や、コードに直接書き込まれたURLやキーなど。

変更全体が間違っている場合は、/rewind を実行する(または空のプロンプトで Esc を2回押す)か、その変更を生み出したプロンプトを選択し、Restore code and conversation を選んでください。知っておくべき制限が1つあります。パッケージのインストールなど、Claudeが実行したシェルコマンドによって変更されたファイルは、元に戻されません。

以下の演習では、小さなサインアップフォームのタスクを使用します。上にはClaudeの要約、その下にはClaudeが触れた8つのファイルがあります。

読み込み中

セカンドオピニオンを求める

Explore → Plan → Code → Commitレッスンでは、変更をコミットする前に2人目のレビュアーを用意するよう述べました。長いセッションは、それまでに読んで判断したすべての内容を引きずっています。それは前のレッスンで管理方法を学んだコンテキストであり、まさにレビュアーに持ち込みたくない履歴です。/code-review はその2人目のレビュアーです。セッションの履歴を一切持たないクリーンなコンテキストで変更をレビューし、見つけた内容を報告します。依頼しない限り、何も編集しません。

/code-review

レビューはバックグラウンドで実行され、数秒から数分かかり、他のタスクと同様に使用量にカウントされるため、見直す価値のある変更のために取っておきましょう。完了すると、結果が会話に届きます。平易な言葉で依頼することもでき、その依頼からClaudeが同じレビューを開始することもできます。Claudeがレビューを開始せずにその場で回答した場合は、自分でコマンドを実行してください。

先ほど行った変更をレビューしてください。問題点を報告してください。まだ何も修正しないでください。

サインアップフォームの変更について、レビューは4つの指摘を返しました。

読み込み中

各指摘にどう対応するかを決める

各指摘を次の3つの山のいずれかに分類します。

  1. 今すぐ修正する。 これは実際の問題であり、重要であり、修正する必要があります。
  2. 理由を尋ねる。 これは、十分に検証できない、あるいはどこかおかしいと感じる指摘のための山です。コードの変更を予備知識なしに読むレビュアーも、見落とすことがあり得ます。
  3. そのままにする。 これは実際の問題ですが、小さく、重要ではありません。これらはしばしば、将来の1つのセッションでまとめて対応する修正のグループにまとめることができます。

理由を尋ねるには、指摘をClaudeに引用して、もう一度確認するよう依頼します。上記の2番目の指摘については、次のように入力します。

isValidEmailがスペースをトリムしないと報告しましたが、4行目でtrim()が呼び出されています。もう一度確認して、その指摘が正しいかどうか教えてください。

修正を依頼するときは、その根拠も一緒に求めるとよいでしょう。

最初の指摘を修正してください。空のメールアドレスのテストをスキップせず、元のアサーションを復元してください。その後テストを実行し、出力を見せてください。

修正が最終的にそれ自体で大きな変更に成長した場合は、もう一度レビューを実行してください。

より詳しくレビューする価値があるとき

単純な1行の変更であれば、多くの場合、差分をさっと見るだけで十分です。変更が頭の中で把握しきれないほど大きい場合、機密性の高いものに触れる場合や破壊的な操作を行う場合、そしてチームメイトに作業を引き渡す前には、人間によるレビューとClaudeによるレビューの両方を使うべきです。

試してみる: 4つの指摘を分類する

読み込み中

まとめ

  • 要約だけを信用する前に、ファイル変更の実際の差分を読みましょう。/diff を実行し、依頼していない変更、弱くなったテスト、新しいパッケージやハードコードされた値がないか確認してください。
  • /code-review を使ってクリーンなコンテキストからセカンドオピニオンを得ましょう(または平易な言葉で依頼し、Claudeに開始させましょう)。レビュアーは報告するだけで、依頼しない限りClaudeは編集しません。
  • 各指摘を「今すぐ修正する」「理由を尋ねる」「そのままにする」のいずれかとして扱い、修正のたびに根拠を求めましょう。

レビュアーが同じ問題を何度も指摘する場合は、Claudeがすべてのセッションの開始時に読むルールを書いておくとよいかもしれません。そのファイルが CLAUDE.md であり、それが次のトピックです。