ChatGPTでコードレビューする方法|初心者が安全に確認する質問例

ChatGPTでコードレビューする方法を解説するアイキャッチ ChatGPT

「ChatGPTにコードを作ってもらったけれど、このまま使ってよいか不安」と感じていませんか。

ChatGPTは、コードの読みやすさ、想定外の入力、エラー処理、セキュリティ上の注意を洗い出す補助に使えます。ただし、指摘も修正版も必ず正しいとは限りません。大切なのは、目的と環境を伝える→問題を再現する→指摘を分類する→小さく直す→テストするの順に進めることです。

コードを一から作る段階なら、先にChatGPTでプログラミングする方法を確認してください。

コードレビューとは

コードレビューは、作成したプログラムを別の視点で読み、バグ、危険な処理、読みづらさ、要件とのずれを見つける作業です。ChatGPTへ依頼するときも、「正しいですか」だけではなく確認範囲を分けます。

観点 確認すること 初心者向けの例
動作 要件どおりに結果が出るか 空欄や0でも動くか
安全性 危険な入力や情報漏えいがないか パスワードを表示していないか
保守性 後から読み直せるか 変数名と処理が一致するか
影響範囲 修正で別機能が壊れないか 呼び出し元も変える必要があるか
検証 指摘を確かめる方法があるか 再現手順とテスト例があるか

OpenAIの案内でも、AIのコードレビューは人の最終判断を置き換えるものではなく、出荷前の追加確認として使う考え方が示されています。

送る前に用意する4点

1. コードの目的

「フォームの入力を受け取り、合計金額を表示する」のように、期待する動作を一文で書きます。目的が曖昧だと、動いている処理まで別物へ書き換えられることがあります。

2. 実行環境

言語、バージョン、OS、フレームワーク、ブラウザなど、分かる範囲を添えます。分からない項目は「不明」と明記し、推測で決めさせません。

3. 起きている問題と再現手順

エラーメッセージ、入力した値、期待した結果、実際の結果を分けます。秘密鍵、APIキー、パスワード、顧客情報、社外秘のURLは削除してください。

4. 今回見てほしい範囲

「まず実行時エラーだけ」「安全性を優先」「構造の大幅変更はしない」のように範囲を絞ります。全体を一度に直すより、変更理由を理解しやすくなります。

ChatGPTでコードレビューする5ステップ

ChatGPTでコードレビューする5ステップ

1. 元の状態を保存する

修正前のファイルをコピーするか、Gitを使っている場合は変更前の状態を確認します。戻せる状態がないまま修正を重ねると、どこで壊れたか分からなくなります。

2. 目的・環境・症状とコードを渡す

コードだけでなく、期待する動作と実際の症状を添えます。長いプロジェクトは関連ファイルだけに絞り、どのファイルのどの部分かを説明します。

3. 指摘を4項目で返してもらう

指摘は「重大度・根拠・確認方法・最小修正」に分けます。根拠や再現方法がない断定は、すぐ反映せず「要確認」にします。

4. 一つずつ最小修正する

重大度が高く、再現できた問題から一つずつ直します。全ファイルの書き換えではなく、変更箇所と理由を先に示してもらいます。

5. テストし、人が差分を確認する

正常な入力だけでなく、空欄、上限、誤った形式も試します。最後に元のコードとの差分を読み、意図していない削除や新しい外部通信がないか確認します。

そのまま使える基本プロンプト

あなたはコードレビューの補助者です。
次の情報とコードだけを使って確認してください。

目的:(ここに期待する動作を書く)
実行環境:(言語・バージョン・OSなどを書く)
問題:(期待した結果と実際の結果を書く)
再現手順:(ここに操作手順を書く)
優先する観点:(動作・安全性・読みやすさなどを書く)
変更したくない部分:(ここに範囲を書く)
コード:(秘密情報を削除して貼り付ける)

指摘を次の表で返してください。
1. 重大度(高・中・低)
2. 問題箇所
3. 根拠
4. 確認方法
5. 最小の修正案

分からない前提は推測で補わず「要確認」としてください。
コード全体を書き換える前に、変更箇所と理由を説明してください。

続けて、次のように依頼します。

重大度が高く、こちらで再現できた問題を一つだけ修正してください。
変更前と変更後の差分、影響する可能性がある箇所、確認用のテスト例を示してください。

指摘の読み方

分類 対応 判断の目安
利用・公開前に確認 情報漏えい、データ破損、主要機能停止
再現して順に修正 特定条件の誤動作、エラー処理不足
目的と工数で判断 名前、コメント、重複処理の整理
要確認 情報を追加する 環境や要件が不足し断定できない

重大度はAIの表現だけで決めません。実際に再現するか、利用者への影響、元に戻せるかを人が確認します。

コードレビューの指摘を安全に直す4段階

よくある失敗と直し方

コードだけを貼り付ける

目的がないと「好みの書き換え」が増えます。期待する動作、症状、見てほしい範囲を先に書いてください。

AIの修正版を丸ごと置き換える

問題と無関係な部分まで変わると、別の不具合が入り込みます。一つの問題に対する最小差分を求めます。

エラーが消えたら完了にする

表示されないだけで、データや他の機能が壊れている可能性があります。正常・異常・境界値のテストを分けます。

秘密情報を貼る

APIキーや個人情報を伏せ字にし、必要なら変数名とダミー値へ置き換えます。ChatGPTを安全に使う注意点も確認してください。

ChatGPTとCodexの操作を混同する

短いコードを会話内で確認する方法と、リポジトリの差分を扱うCodexのレビュー機能は別です。ChatGPTのコードブロックではコピー、編集、対応する内容のプレビューや実行が利用できますが、利用可能な操作はプラン・端末・設定で異なります。プロジェクト全体の変更では、対象ブランチやファイル、レビュー基準を明示し、最終判断は人が行います。

Webページの表示まで確認したい場合は、ChatGPTでWebサイトを作る方法も参考になります。

公開・共有前チェックリスト

  • 元のコードへ戻せる
  • 目的、環境、期待値、実際の結果を説明できる
  • 秘密情報と個人情報を削除した
  • 指摘に根拠と確認方法がある
  • 再現できた問題だけを優先した
  • 修正を一つずつ反映した
  • 正常値、異常値、境界値をテストした
  • 元との差分を人が読んだ
  • 不要な外部通信、ライブラリ、権限追加がない

まとめ

ChatGPTのコードレビューは、見落としを探し、確認項目を整理する補助として役立ちます。しかし、自然な説明や動くように見える修正版が、安全性まで保証するわけではありません。

目的と環境を伝え、問題を再現し、重大度・根拠・確認方法・最小修正で指摘を整理し、一つずつテストする。 この流れなら、初心者でも修正理由を見失わずに確認できます。

参考:OpenAI「コードレビュー」OpenAI「ChatGPTでのライティングブロックとコードブロックの使用」OpenAI「Introducing upgrades to Codex」

コメント

タイトルとURLをコピーしました