再現手順付きバグレポートの作成

バグレポートの作成が難しい原因は、文章力ではなく「情報の構造」にあります。「決済ができません」という1行だけの報告では、開発者は再現確認すらできず、何度も確認の往復が発生した末にようやく調査が始まります。その間にユーザー側の記憶は曖昧になってしまいます。

出力の形式を項目ごとに厳密に指定している点が、このプロンプトの核です。特に「期待される結果」と「実際の結果」を分けて書かせることが重要です。2つを分けることで、「動きません」という報告が「決済手段選択画面へ遷移すべきところ、画面が静止したままになる」という具体的な現象に変わり、これだけで調査すべき範囲が大幅に絞られます。再現手順を1行につき1操作に限定しているのも同じ理由で、複数の動作が1行に混ざっていると、どちらのステップで失敗したのか特定できないためです。

3行の制約は、それぞれ異なるノイズを排除します。「推測で補わず『情報なし』と書く」指示は、AIでバグレポートを作成する際によくある「ありそうなブラウザバージョンやエラーメッセージを勝手に捏造してしまう」問題を防ぎます。「原因の推測禁止」は、レポートが的外れな診断書になって開発者が誤った調査を進めるのを防ぎ、代わりにヒアリングすべき質問を出力させることで、報告者への確認を一度で完了できるようにします。

報告メモを """ で囲む理由は2つあります。メモと指示文を明確に区別し、メモに含まれる「至急対応してください」といった文言がAIへの指示として誤認されるのを防ぐためです。名前や連絡先を置き換える指示は、イシュートラッカー等に個人情報がそのまま残るのを防ぐ安全策です。

メモにない情報をAIが勝手に補完してしまいます。実際には起きていないエラーメッセージや、確認していないブラウザのバージョンがもっともらしく記載され、開発者がその誤情報を信じて調査することで無駄な時間を費やすことになります。再現手順も「決済を試みる」の1行でまとめられてしまい、結局どの画面のどのボタンで止まったのかを聞き返す手間が発生します。