読まずにマージしない:AIが書いたコードの見直し方
AIが出してくるコードは量が多く、全部を読むのは大変です。つい「動いたからいいか」と取り込んでしまいがちですが、それを続けると、自分のサービスなのに中身を誰も知らない、という状態になります。
全部を読まなくてもいい。でも、ここは読む
時間は限られているので、読む場所に優先順位をつけましょう。
- お金や個人情報を扱う部分:決済、会員情報、パスワード
- 権限を確かめる部分:誰が何を見られるか、変えられるか
- 外とやりとりする部分:APIの呼び出し、ファイルのアップロード、メール送信
- データを消す・書き換える部分:まちがえると取り返しがつかない処理
- 新しく入れたライブラリ:本当に存在し、信頼できるものか
読むときに見るポイント
- 頼んだこと以外をしていないか:関係のないファイルまで書き換えていないかを、差分(変更点)で確かめます。
- エラーのときにどうなるか:失敗したときに、データが中途半端に残ったり、詳しすぎるエラーが表示されたりしないか。
- 決めたルールに沿っているか:名前の付け方や、使うと決めた部品から外れていないか。
- 説明できるか:自分の言葉で「この部分は何をしているか」を説明できないなら、まだ取り込むべきではありません。
AIを見直し役にも使う
書いたAIとは別に、見直し役としてAIを使うのも効果があります。
- 「このコードを、意地悪な見直し役の立場で批評して」と頼む
- 「この変更で壊れそうな場所を挙げて」と聞く
- 「この関数を、初めて読む人向けに説明して」と頼み、自分の理解と合っているか確かめる
ただし、AIの見直しは「見落としを減らす」ためのものです。最後に取り込むかどうかを決めるのは、人の役目です。
小さく頼むと、読みやすくなる
「ログイン機能を全部作って」と頼むと、大量のコードが一度に出てきます。「まず入力欄だけ」「次にパスワードの確かめだけ」と小さく分けて頼むと、1回あたりの量が減り、読みやすくなります。
まとめ
AIのコードを読むのは、AIを疑うためではなく、自分のサービスに責任を持つためです。大事な部分から、小さく、説明できるまで読む習慣をつけましょう。
