ChatGPTで障害報告書を作る方法｜事実と再発防止を伝える5ステップ

ChatGPTで障害報告書を作るときは、確認済みの事実だけを入力し、文章の整理と構成をChatGPTに任せるのが安全です。原因と再発防止策は、担当者が確認して承認します。AIは文章を整えるのが得意です。一方で、わかっていない原因や影響範囲を、もっともらしく書いてしまうことがあります。障害報告書でこれが起きると、関係者の判断を誤らせ、信頼も損ないます。

この記事では、AI初心者でも実践できる5つのステップを紹介します。

1. 読者と報告段階を決める
2. 確認済み事実を集める
3. 影響と時系列を分ける
4. ChatGPTで下書きする
5. 担当者が原因と再発防止を承認する

独自の工夫として、情報を「事実カード」と「判断・仮説カード」に分けて扱います。さらに、初報・経過報告・最終報告の3段階で、情報の確度を少しずつ上げていきます。

障害報告書に必要な基本項目

多くの障害報告書には、共通する項目があります。下の表では、各項目に何を書くかと、ChatGPTに任せてよい範囲をまとめました。

この表から、ChatGPTの主な役割は「整形」と「抜け漏れの指摘」だとわかります。内容を判断する役割ではありません。

「事実カード」と「判断・仮説カード」を分ける

障害対応の現場では、確定した事実と推測がチャットやメモの中で混ざりがちです。そのままChatGPTに貼り付けると、推測が事実として書かれてしまう危険があります。そこで、入力する前に情報を2種類のカードに分けます。

カードの書き方はシンプルで構いません。たとえば、1行ずつ「【事実】10:42 決済APIのエラー率が5%を超えた（監視ツール）」「【仮説・中】10:30のデプロイが関係している可能性。ロールバック後の推移で検証する」と書くだけです。ラベルが付いていれば、ChatGPTも区別して扱えます。

初報・経過報告・最終報告の3段階で確度を上げる

障害報告書は、1回で完成させるものではありません。段階ごとに、書いてよい内容が変わります。

段階が進むたびに、判断・仮説カードを「検証済み」と「棄却」に振り分けます。検証済みのものだけを事実カードへ移してください。これで、報告の確度が段階的に上がっていきます。

ChatGPTで障害報告書を作る5ステップ

ステップ1：読者と報告段階を決める

最初に「誰が読むか」と「どの段階の報告か」を決めます。経営層向けなら、影響と今後の見通しを先に書きます。開発チーム向けなら、技術的な時系列を厚めにします。顧客向けなら、専門用語を避けて謝罪と対応状況を中心にします。この2点をプロンプトの冒頭に書くだけで、出力の精度が大きく変わります。

ステップ2：確認済み事実を集める

監視ログ、アラート履歴、対応チャット、問い合わせ件数などから情報を集め、事実カードにまとめます。原因の切り分けがまだ途中なら、ChatGPTを使ったトラブルシューティングの進め方やChatGPTでのエラー調査・デバッグ方法も参考になります。ただし、調査で得られた見立ては判断・仮説カードに入れてください。

ステップ3：影響と時系列を分ける

「影響」と「時系列」は混ざりやすい項目です。影響は「何が・誰に・どれだけ・いつからいつまで」で書きます。時系列は「時刻・出来事・実施者」で書きます。時刻のタイムゾーン（JSTなど）は統一しましょう。「影響件数は集計中」のように未確定の部分があれば、空欄にせず未確定だと明記します。

ステップ4：ChatGPTで下書きする

カードを貼り付けて、下書きを依頼します。次のプロンプトはそのままコピーして使えます。

あなたは障害報告書の編集担当です。
以下の情報から【経過報告】の下書きを作成してください。
読者：社内の部門責任者（非エンジニア含む）

ルール：
- 【事実】の内容だけを事実として記述する
- 【仮説】は「可能性」と表現し、確度を併記する
- 入力にない原因・影響件数・時刻を推測で補わない
- 不明な項目は「調査中」または「未確認」と書く
- 構成：概要／影響範囲／時系列（表）／暫定対応／原因（現時点）／今後の対応／次回報告予定
- 最後に、情報が不足している項目を箇条書きで指摘する

【事実】
（ここに事実カードを貼る）

【仮説】
（ここに判断・仮説カードを貼る）

ポイントは最後の行です。不足している項目を指摘させると、ChatGPTが空白を推測で埋めるのを防げます。さらに、次に集めるべき情報もわかります。

ステップ5：担当者が原因と再発防止を承認する

下書きができたら、原因と恒久対策は必ず担当者が確認し、承認者の名前を記録します。ChatGPTは「この再発防止策に抜けている観点を挙げて」のような、レビュー役として使うと便利です。対策には、実施する担当者と期限を必ず入れてください。最後に、ChatGPTで校正するときのルールに沿って、表記ゆれや敬語を整えます。

提出前の確認チェックリスト

• 入力していない数値や原因が、出力に紛れ込んでいないか
• 「可能性」と書いた内容が、要約部分で断定に変わっていないか
• 時系列の時刻とタイムゾーンが元ログと一致しているか
• 暫定対応と恒久対策が区別されているか
• 特定の個人を責める表現になっていないか（仕組みの問題として書く）
• 次回の報告予定や問い合わせ窓口が書かれているか

特に見落としやすいのが、要約部分での断定化です。本文では「可能性」と書いていても、概要では「〜が原因で発生しました」と言い切っていることがあります。概要は必ず人の目で読み直してください。

修正版をリリースして利用者に告知する場合は、ChatGPTでリリースノートを書く方法を参考に、報告書とは別の文書として作るとわかりやすくなります。

よくある質問

原因が特定できないまま最終報告を求められたら？

無理に原因を断定せず、「直接原因は特定済み、根本原因は調査継続」のように、確定している範囲を分けて書きます。あわせて、追加調査の期限も示します。ChatGPTに「原因を推測して」と頼むのは避けましょう。

顧客向けと社内向けは同じ下書きから作れる？

作れます。社内向けの最終版を確定させてから、「顧客向けに、技術用語を減らし、謝罪と対応状況を中心に書き直して」と依頼します。ただし、社内の構成情報が残っていないかは必ず確認してください。

まとめ

ChatGPTで障害報告書を作るコツは、事実カードと判断・仮説カードを分けて入力することです。そのうえで、初報・経過報告・最終報告と段階を踏み、情報の確度を上げていきます。5ステップの中でAIが担うのは、整理と抜け漏れの指摘です。原因と再発防止策の決定は、担当者が承認します。

まずは次の障害対応で、事実と仮説をラベル付きで1行ずつメモするところから始めてみてください。それだけで、報告書づくりのスピードと正確さが大きく変わります。