The Engineering of Intent 第25章:デバッグ・プレイブック
本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第25回です。前回の記事では、プロセスで起きる問題を分類しました。第25章ではコードで起きる問題を分類します──10種類のバグと、それぞれに合った調査パターンです。
物語ではなく、パラパラめくる早見帳
本章は、目の前に具体的なバグがあるときにパラパラめくる早見帳として使ってください。各項目では、バグの種類、典型的な症状、調査パターン、使うべきプロンプト、そして実例を示しています。ここでは10種類を挙げ、いくつかの実例を紹介します。
10種類のバグ
- 決定的だが誤っているバグ ── 最も簡単な種類。最小の再現手順 + バグ仮説プロンプト(Bug-Hypothesis Prompt)+ リグレッションテスト。
- 断続的なバグ ── 調査する前にパターンのデータを集める。何が失敗するかより、いつ起きるかのほうが重要です。
- リファクタリング後のリグレッション ── 二分探索で絞り込み、1行ずつ比較する。原因はほぼ必ず、気づかれなかった挙動の変化です。
- 本番環境でしか起きないバグ ── 環境の違いを見つける。その違いをステージングで再現する。
- パフォーマンスのリグレッション ── 仮説を立てる前にプロファイルを取る。ボトルネックが予想どおりの場所にあることはめったにありません。
- 並行性のバグ ── 最初の直感を信じない。インターリーブ(実行順序の組み合わせ)を列挙する。エージェントはこの作業に驚くほど根気強く付き合ってくれます。
- 外部サービスのバグ ── サードパーティのドキュメントは間違っていることが多い。リクエストとレスポンスを正確に再現する。
- 設定のバグ ── デプロイされた設定とソースの差分を取る。エージェントはこれが非常に得意です。
- データ形状のバグ ── データをサンプリングする。想定していなかったnullや余分なフィールドを探す。
- 「起こるはずがない」バグ ── その言い分が間違っています。なぜ間違っているのかを突き止める。エージェントは主張ではなく、コードを確認してくれます。
さらに2つの実例
本番環境でしか起きないバグの例:特定のUnicode文字を含むレコードでのみ発生するシリアライズのバグがありました。ステージングにはそのレコードがありませんでした。その文字を含む最小限のレコードをコピーしたところ、ステージングでも再現しました。修正はエンコーディングの1行だけでした。
設定のバグの例:ステージングでは正しく設定されている環境変数が、本番では欠けていました。両方のテンプレートを並べて渡すと、エージェントがそれを指摘しました。対処は、本番テンプレートに1行追加し、CIにテンプレートの整合性テストを加えること。テストのコストはゼロですが、インシデントになっていたら週末がまるごと潰れていたでしょう。
「『起こるはずがない』バグは、私がいちばん好きなバグです。チームから何度も『それは起こり得ない』と言われるからです。ここでエージェントが役に立つのは、あなたの確信を共有していないからです──主張を信じるのではなく、実際のコードを確認してくれます。ある合併のあと、まれな種類のユーザーが移行されてIDを2つ持つようになっており、チームが何年も信頼してきた不変条件が破られていました。」
次回 ── 第26章「現場のエンジニアのためのチェックリスト」 第23章から第25章ではパターンとプレイブックを紹介しました。第26章では、私が作業の途中で実際に手に取る短い形式の道具──出荷前チェックリスト、レビューのチェックリスト、インシデントのチェックリスト、そのほか1画面に収まるいくつか──を紹介します。
📖 さらに詳しく知りたい方へ
本章では、10種類のバグそれぞれについて、症状、調査パターンの全体、プロンプトのテンプレート、そして正確な修正内容を含む実例の全容を解説しています。
下田 昌平
開発に関するインプットをアウトプットしています。カテゴリー
タグ
検索ログ
開発・技術相談
システム開発や技術検証、要件定義の作成、アーキテクチャ設計、 テスト設計、運用設計まで、一気通貫で支援しています。 企画段階の「まず相談したい」レベルから、実装・運用まで 幅広く対応できますので、お気軽にお問い合わせください。
お問い合わせ