AIのバグ修正を失敗テストから始める実証プロンプト

AIコーディング支援へエラーメッセージを貼り、「直してください」と頼むと、動きそうなコードは返ってきます。ところが、症状だけを隠したのか、原因を直したのか、別の機能を壊していないかは、その回答だけでは分かりません。

今回は、修正より先に失敗するテストを固定するプロンプトを、ページ番号から配列の一部を取り出す小さなJavaScript関数で試しました。GitHub Copilotの公式ガイドを設計根拠にしていますが、実行検証はこの制作環境のCodexとNode.jsで行っています。Copilot上で実行済みとは主張しません。

検証日：2026年7月18日。修正前コード、修正後コード、5項目のテストを記事制作フォルダへ保存し、Node.js 24.15.0で再実行しました。

今回のバグは1ページ目からずれる

テスト対象は、配列、ページ番号、1ページあたりの件数を受け取り、該当範囲を返す関数です。修正前は開始位置を「ページ番号×件数」で計算していたため、1ページ目なのに3件目から返していました。

先に5つの期待動作を固定しました。通常の1ページ目と2ページ目、空配列、0ページ、0件指定です。修正前の実装へテストを実行すると、最初の期待値で失敗し、実際には [‘c’]、期待値は [‘a’,’b’] と確認できました。

段階	結果	意味
修正前	終了コード1	1ページ目の期待値で失敗を再現
最小修正	開始位置を (page – 1) × pageSize へ変更	ページ番号を1始まりとして扱う
入力確認	0以下をRangeError	曖昧な入力を黙って補正しない
修正後	5 assertions passed	正常系・境界値・例外を確認

実際に使った失敗テスト先行プロンプト

失敗テスト先行のバグ修正プロンプト

対象コードのバグ修正を手伝ってください。ただし、最初からコードを書き換えないでください。

次の順序を守ってください。
1. 対象ファイルと関数、現在の入出力、期待する動作を短く整理する。
2. エラーを再現する最小入力を示す。
3. 既存のテスト方式に合わせ、修正前に必ず失敗するテストを追加または提示する。
4. テストを実行し、失敗したコマンド、終了状態、期待値、実値を記録する。
5. 原因仮説を、確認済みと未確認に分ける。
6. 依存関係、公開API、無関係なファイルを変えず、必要最小限の修正案を示す。
7. 修正後に、新しいテストと既存テストをすべて再実行する。
8. 変更ファイル、変更理由、実行コマンド、成功件数、未検証範囲を報告する。

禁止事項：テスト失敗を確認する前の修正、テストの削除や弱体化、依存関係の無断更新、破壊的コマンド、秘密ファイルの読取り。