メインコンテンツへスキップ
見出し画像

AIが書いたコードのレビューチェックリスト46|本番前に見る危ない例6つと確認プロンプト5本

    「AIに書かせたコード、動いたけれど、このまま納品して大丈夫だろうか」

    「テストデータでは問題なかったのに、本番のデータで何が起きるか分からない」

    「レビューしたいけれど、どこから見ればいいのか決まっていない」

    ChatGPT・Claude・Gemini・GitHub Copilotなどに頼むと、それらしく動くコードがすぐに出てきます。ただ、「動く」と「本番に出してよい」は別の話です。AIが書いたコードには、こんな落とし穴がまざることがあります。

    ・存在しない関数やライブラリを、もっともらしく使っている

    ・APIキーやパスワードが、コードに直接書かれている

    ・削除や上書き、メール送信の対象が、条件しだいで全件になる

    ・エラーを握りつぶしていて、失敗しても気づけない

    ・件数が少ないときは動くが、本番の件数では上限や時間切れにぶつかる

    どれも、短いテストでは見つかりにくいものです。しかも、AIのコードは読みやすく整っているぶん、なんとなく正しく見えてしまいます。

    この記事は、AIが書いたコードを仕事や副業の納品で使う前に、人が確かめるためのチェックリストです。GAS・Python・JavaScript・SQL・シェルなど、言語を問わず使える形にしました。

    この記事でできること

    ・5分で見る「最低限」の10項目で、まず大きな事故の芽をつぶす

    ・本番前の「しっかり」チェック46項目で、分類ごとに抜けなく確かめる

    ・AIが書きがちな危ないコード6つを、「危ない→直した例」で見分けられるようになる

    ・AIに自分のコードをレビューさせるプロンプト5本で、確認の手間を減らす

    ・レビューの結果を、コピーして使える記録表に残す

    画像

    無料の情報との違い

    コードレビューの観点やセキュリティの注意点は、ネット上にもたくさんあります。この記事は、次の4つを決めて作りました。

    1. 「AIが書いたコード」でつまずきやすいところに絞った

    存在しないAPI、古い書き方、条件しだいで全件が対象になる処理など、AIのコードで目立ちやすい形を中心に並べています。

    2. 各項目に「なぜ」と「どう確かめるか」がある

    「エラー処理を確認する」だけでは、何をすれば確認したことになるのか分かりません。項目ごとに、見る場所と確かめ方を短く書きました。

    3. 危ない例は、実際に構文チェックと動作確認をした

    危ない例と直した例のコードは、Node.js・Python・bashで構文チェックし、ダミーのデータで「危ない例では本当に事故が起きる」「直した例では止まる」ことを確かめています。

    4. 「AIのレビューもまちがう」前提にした

    AIにレビューさせるプロンプトは、答えをそのまま信じるのではなく、人が最後に判断するための材料を出させる形にしています。

    ※業務でAIを使うときは、勤務先のルールに従ってください。社外のAIサービスにコードを貼ってよいか、AIが書いたコードを納品に使ってよいかは、会社や契約ごとに決まりがあります。

    無料で一部を公開:5分で見る「最低限」チェック(10項目のうち3つ)

    □ 知らない関数・ライブラリ名に印をつけて、公式ドキュメントで確かめた

     なぜ:AIは、ありそうな名前の関数や引数を作ってしまうことがあります。

     確かめ方:見覚えのない名前を書き出し、公式ドキュメントで1つずつ検索します。

    □ キー・パスワード・トークンが、コードに直接書かれていない

     なぜ:コードは共有・保存されるたびに、秘密も一緒に広がります。

     確かめ方:「key」「token」「secret」「password」「Bearer」でコードを検索します。

    □ 削除・上書き・送信・課金をする行を、すべて見つけた

     なぜ:取り消せない操作は、1回のまちがいが事故になります。

     確かめ方:「delete」「remove」「clear」「drop」「send」「update」「rm 」で検索し、行に印をつけます。

    残りの7項目と、本番前の46項目、危ない例6つ、レビュー用プロンプト5本、記録表は、ここから先の有料部分にまとめています。

    ほかのテンプレートは、悩み別のカタログにまとめています。自分に合う記事を探すときに使ってください。

    ここから有料(980円)

     
     
    エンジニアです。Gmailやスプレッドシートの面倒な作業を、GASで少しラクに。ひとりで働く方や小さなお店に向けて、自動化テンプレートと使い方をまとめています。記事選びに迷ったら、固定のカタログをご覧ください。 ※アフィリエイト広告(Amazonアソシエイト含む)を掲載。

    あなたへのおすすめ