不具合報告書

不具合報告書は、問題を見た人から、それを直す人に宛てたメッセージです。役割はひとつ、その場にいなかった人が同じ問題をもう一度起こせるようにすることです。「請求書の画面が壊れています」とだけ書かれた報告は、開発者が1時間ぶんの確認に追われますが、バージョン、手順、期待していたこと、実際に起きたことが書かれていれば、その日のうちに直せることも少なくありません。

この書式はその点を軸に作られています。分かりやすいタイトル、発生環境（環境、バージョン、端末）、番号順の再現手順、期待結果と実際の結果、どれほど深刻か（重大度）とどれだけ早く直すべきか（優先度）、問題を示すファイルとその保管場所、報告に起きたことの履歴を記録します。項目は単純なので、どの課題管理ツールにもコピーして入れられ、Webページ、モバイルアプリ、サービス、ゲームのどれにも同じように使えます。版は国際共通の1つです。報告書は業務上の文書であり、法的助言ではありません。

• 製品のテストや利用中に問題を見つけ、きちんと引き継ぐ必要があるとき
• お客様や同僚が口頭で説明した問題を、開発者が使える形で書き留めたいとき
• 課題管理ツールがない、または問題が起きたときに使えないとき
• テスト報告書、取引先との協議、保証の話し合いのために、印刷物やWordの記録が必要なとき

1. 何がどこで起きるかを1行のタイトルで書きます。
2. 発生環境を記入します。環境、バージョン・ビルド、OS、ブラウザー・アプリ、端末です。
3. 再現手順を、順番に、1行に1つの操作で、ログインし直した状態のような既知の状態から書きます。
4. 期待した結果と実際の結果を書き、知っている回避策と影響を受ける人も書きます。
5. 重大度と優先度を決め、発生頻度を選び、スクリーンショット・ログ・録画とその保管場所を書きます。先にパスワードや個人情報を取り除いてください。
6. 報告が振り分けられ、修正され、検証されるたびに、対応履歴を更新します。

• 「動かない」のようなタイトル。何が、どこで、どんな条件で動かないのかを書きます。
• 開始時の状態が抜けた手順。どのデータを開いていたか分からないと、「保存をクリック」だけでは意味がありません。
• 1件の報告に複数の問題を入れること。不具合1件につき報告1件のほうが、割り当て・修正・検証がしやすくなります。
• 腹立たしさの度合いで重大度を決めること。影響で判断します。データの消失や回避策がないものは重大です。
• パスワード、鍵、個人情報が写ったログやスクリーンショットを添付すること。

1. 入力
2. プレビューで確認
3. PDF・Word・Excelで保存

必要な国を選んでください。それぞれの書式は、その国で一般的な文言とレイアウトに沿っています。「現地の専門家に確認」と表示された書式は、使う前に現地の規則に詳しい人に読んでもらってください。

• 国際共通 (XX): 記載言語：英語, 韓国語, 日本語, ドイツ語