Skip to content

読まずにマージしない:AIが書いたコードの見直し方

2 min read

AIが出してくるコードは量が多く、全部を読むのは大変です。つい「動いたからいいか」と取り込んでしまいがちですが、それを続けると、自分のサービスなのに中身を誰も知らない、という状態になります。

全部を読まなくてもいい。でも、ここは読む

時間は限られているので、読む場所に優先順位をつけましょう。

  • お金や個人情報を扱う部分:決済、会員情報、パスワード
  • 権限を確かめる部分:誰が何を見られるか、変えられるか
  • 外とやりとりする部分:APIの呼び出し、ファイルのアップロード、メール送信
  • データを消す・書き換える部分:まちがえると取り返しがつかない処理
  • 新しく入れたライブラリ:本当に存在し、信頼できるものか

読むときに見るポイント

  1. 頼んだこと以外をしていないか:関係のないファイルまで書き換えていないかを、差分(変更点)で確かめます。
  2. エラーのときにどうなるか:失敗したときに、データが中途半端に残ったり、詳しすぎるエラーが表示されたりしないか。
  3. 決めたルールに沿っているか:名前の付け方や、使うと決めた部品から外れていないか。
  4. 説明できるか:自分の言葉で「この部分は何をしているか」を説明できないなら、まだ取り込むべきではありません。

AIを見直し役にも使う

書いたAIとは別に、見直し役としてAIを使うのも効果があります。

  • 「このコードを、意地悪な見直し役の立場で批評して」と頼む
  • 「この変更で壊れそうな場所を挙げて」と聞く
  • 「この関数を、初めて読む人向けに説明して」と頼み、自分の理解と合っているか確かめる

ただし、AIの見直しは「見落としを減らす」ためのものです。最後に取り込むかどうかを決めるのは、人の役目です。

小さく頼むと、読みやすくなる

「ログイン機能を全部作って」と頼むと、大量のコードが一度に出てきます。「まず入力欄だけ」「次にパスワードの確かめだけ」と小さく分けて頼むと、1回あたりの量が減り、読みやすくなります。

まとめ

AIのコードを読むのは、AIを疑うためではなく、自分のサービスに責任を持つためです。大事な部分から、小さく、説明できるまで読む習慣をつけましょう。

Keep reading

Related stories

Translated automatically