AIのコードが壊れたら:デバッグ入門
AIが書いたコードは一発で正しいとは限らない。エラーを読み、範囲を狭め、正しい手がかりをAIに返す——初心者のための体系的デバッグ法。
ひとことで言うと
デバッグは当てずっぽうではなく「範囲を狭めて、正しい手がかりをAIに返す」こと。これを覚えればAIは直せる。
作れるもの
壊れたコードに対する決まった手順:エラーの読み方、範囲の狭め方、AIに渡す手がかりの作り方。
壊れるのは普通
AIが書いたコードは一発で正しいとは限りません——あなたのせいではなく、普通のことです。違いは、デバッグできる人は直せて、できない人はAIに「もう一度」と繰り返して散らかすこと。デバッグはひらめきではなく、学べる体系的な方法です。
第1歩:エラーメッセージを読む(飛ばさない)
壊れると、画面やブラウザの Console(コンソール) に赤いエラーが出ます。初心者にありがちな失敗は、赤字に慌ててすぐAIに「壊れた」と貼ること。まず自分で読む:エラーはたいていどのファイル・何行目・何の問題かを直接教えてくれます。分からなくてよいので、全文を控えましょう。
第2歩:範囲を狭める(二分法)
全体を一度に睨まない。問う:「最後に動いたのはいつ?今回何を変えた?」疑わしい範囲を半分に切る——怪しい一部を外す/コメントアウトして、まだ壊れるか確認。小さな範囲で安定して再現できれば、原因はすぐ掴めます。
第3歩:正しい手がかりをAIに返す
AIが直せないのは、たいてい渡した情報が少なすぎるから。次の3つをまとめて渡すと命中率が上がります:
- エラーメッセージ全文(「壊れた」ではなく全体)。
- 再現手順:何をすると起きるか、期待と実際。
- すでに試したこと:AIが試して効かなかった方法を繰り返さないように。
よくある落とし穴
- 一度に変えすぎる:壊れたとき、どの変更が原因か分からない。一度に1か所、変えたらテスト。
- Console を開かない:多くのエラーはコンソールにだけ出て、画面は「何となく変」に見えるだけ。
- 無限の「もう一度」:AIが直せないなら、一歩引いて自分で範囲を狭め、新しい手がかりを渡す方が有効。
次のステップ
- 変える前にバージョンを保存し、戻せるように:Gitでコードを管理する
- AIともっとうまく組む:AI協働プレイブック
よくある質問
AIが同じバグをずっと直せないときは?
無限の「もう一度」に陥らないこと。一歩引いて自分で範囲を狭め(二分法で原因の箇所を特定)、「エラー全文+再現手順+試したこと」をまとめて渡す。情報が具体的なほどAIは直せます。「まだ壊れてる」だけではほぼ堂々巡り。
エラーメッセージが分からなくてもデバッグできる?
できます。一字一句分からなくてよいですが、**全文**を控えてAIに渡す——たいてい読めます。エラー自体より有用なのは「どう操作すると起きる・期待・実際」の再現手順。これを一緒に渡すと命中率が最も高い。
参考資料
- Chrome DevTools — Google
- JavaScript error reference — MDN — Mozilla