Webサイトのバグ報告テンプレート|再現手順・期待結果を伝える書き方
「動かない」だけで終わらないWebサイトの不具合報告を、再現手順・実際の結果・期待結果・環境に分けて解説。コピーできるテンプレートと、再現しない場合の記録例を紹介します。
Webサイトのバグ報告は、「どの条件で何をしたら、何が起き、どう動くはずだったか」を分けて書くと、相手が確かめやすくなります。 原因を推測する前に、実際に観察したことを残します。
文言を変えたい、余白を広げたいという改善依頼は、修正指示のテンプレートも利用できます。この記事は、操作が期待どおりに動かない場合の記録に絞ります。
コピーして使えるバグ報告
件名:[ページ・操作] をすると [起きる問題]
対象URL:公開してよい範囲のURL
確認した日時:
環境:本番/検証、OS、ブラウザとバージョン、画面幅
前提条件:ログイン状態、使用した権限、選んだ条件
再現手順:
1.
2.
3.
実際の結果:
期待する結果:
期待の根拠:画面の説明、仕様、以前確認した動作など
再現頻度:試した回数と起きた回数、または未確認
利用者への影響:
画像・動画・エラー表示:
未確認事項と、すでに試したこと:期待の根拠が分からない場合は、「仕様は未確認」と添えます。自分の好みや予想を、確定した仕様として記入しないようにしてください。
再現手順は他の人が実行できる粒度にする
「フォームを送信する」だけでは、入力した項目や選んだ条件が分かりません。どのページを開き、何を入れ、どのボタンを押したかを順に書きます。
次は架空の検証環境を使った記入例です。
件名:問い合わせフォームで確認画面から戻ると選択項目が消える
前提条件:検証環境、未ログイン
再現手順:
1. お問い合わせページを開く。
2. 種別で「導入相談」を選び、必須欄にテスト用データを入れる。
3. 「確認へ」を押す。
4. 確認画面で「入力に戻る」を押す。
実際の結果:種別が未選択になり、ほかの入力欄は残っている。
期待する結果:確認前に選んだ種別が残る。
期待の根拠:入力に戻って修正できるという画面説明。詳細仕様は未確認。
再現頻度:同じ条件で3回試して3回発生。実際に試した環境や回数に置き換えます。本番の送信操作は、問い合わせや注文を作成する場合があるため、許可された検証環境やテスト手順で確認してください。
実際の結果と原因の仮説を分ける
「保存処理が壊れている」より「保存を押すとエラーが表示され、一覧に新しい項目がない」のほうが、観察した状態を伝えられます。
原因について手がかりがあれば、別欄に「仮説」と書きます。調査していない段階で、ネットワーク、ブラウザ、担当者の実装のどれかを原因と断定しないようにします。
再現しないときも確認できた範囲を残す
一度だけ起きた場合は、発生日時、直前の操作、エラー表示、再試行の結果を記録します。「起きなかった」という結果も、同じ条件をどこまでそろえたかと一緒に残してください。
Mozillaのバグ報告ガイドも、再現手順、実際と期待の結果、観察と推測の区別を重視しています。この記事では、その考え方をWebサイトの報告用に整理しています。
ピンは場所、文章や動画は操作の記録に使う
Fusenlyのピン付きコメントで、問題を見つけた要素に目印を付けられます。ページ全体のURLメモには、再現手順と結果を書けます。レビュー中の自分用の記録として使い、正式な報告は合意した課題管理先へ転記します。
ピンだけでは操作の順番や発生時点の状態を保存できません。必要なら画像や動画を別のツールで撮り、本文と合わせて共有します。Fusenlyにはスクリーンショット・動画の撮影や、ブラウザログの自動添付機能はありません。
共有前に確認する項目
- URLに一時的な認証情報や個人情報が入っていないか。
- 入力例に実在の顧客情報やパスワードを使っていないか。
- 画像やログに、報告に不要な内容が映っていないか。
- 未確認の環境や回数を、確認済みとして書いていないか。
修正後は同じ手順で確認し、期待する結果になったかを報告先へ記録します。確認できた範囲も添えると、別の条件での問題と区別できます。
参考情報
公式ガイドとFusenlyの機能の確認日:2026年10月31日。
関連記事
- Webサイトの修正指示の書き方|場所と変更内容が伝わるテンプレート
Webサイトの修正依頼で伝える項目を、URL・対象箇所・現状・変更内容・確認条件に分けて解説。コピペできる指示書、良い例と曖昧な例、画面の注釈と共有先の使い分けを紹介します。
- Webページにコメント・注釈を残す方法|ピンの手順と公開範囲
Webページの特定箇所にコメントを残す方法を解説。自分用のピン付きメモ、チームへのフィードバック、サイトの公開コメント欄の違いと、Fusenlyでの操作・保存先・注意点を紹介します。
- 技術記事を読んで終わりにしないメモ術|試した結果と疑問を残す
技術記事や公式ドキュメントを学習に生かすために、読む目的、動作条件、試した結果、次の疑問を残す方法を紹介します。コピーして使える学習メモの記入欄も掲載しています。