バグ報告テンプレート|無料、Jira・GitHub・Linear 対応
コピーして使える無料のバグ報告テンプレート。GitHub、Linear、Jira 向けの既製版、GitHub の Issue フォーム、記入例付きです。
バグ報告テンプレートとは、すべてのレポートが同じ問いに答えるようにするための、決まった項目のセットです。何がおかしいのか、どこで起きたのか、どうすれば再現できるのか、本来どうなるべきだったのか、そしてそれを示す証拠は何か。下のテンプレートは、タイトル、概要、環境、再現手順、期待される結果と実際の結果、発生頻度、重大度、添付ファイル、ログをカバーしています。課題管理ツール、サポートフォーム、チャットのメッセージにコピーして、空欄を埋めてください。さらに下には、GitHub の Issue フォームを含む、GitHub、Linear、Jira 向けの既製版もあります。
テンプレートが必要なのは、開発者が時間の大半を修正そのものではなく、足りない情報の確認に費やしているからです。正確な手順、ブラウザのバージョン、コンソールのエラーがそろったレポートなら、その日のうちに直せることも珍しくありません。「チェックアウトが壊れている」とだけ書かれたレポートは、質問ばかりの長いスレッドになってしまいます。
テンプレート
タイトル:[ページまたは機能] で [操作] すると [何が壊れているか]
概要
わかりやすい言葉で 1〜2 文。何が起きたか、誰が影響を受けるか。
環境
- URL:
- ブラウザとバージョン:
- OS:
- デバイス / 画面サイズ:
- アプリのバージョンまたはビルド(わかれば):
- アカウント / ロール / テストユーザー:
- 発生日時(タイムゾーン付き):
再現手順
1.
2.
3.
期待される結果
本来どうなるべきだったか。
実際の結果
実際にどうなったか。正確なエラーメッセージをテキストのままコピーして含める。
発生頻度
毎回 / ときどき(Y 回中およそ X 回)/ 1 回だけ発生
重大度
ブロッカー / 重大 / 軽微 / 見た目のみ
回避策
回避する方法、または「見つからず」。
添付ファイル
- スクリーンショットまたは画面録画:
- コンソールのエラー:
- 失敗したネットワークリクエスト(URL、ステータス、レスポンス):
- HAR ファイル(サニタイズ済み、依頼された場合):
メモ
その他:いつから起きているか、最近何が変わったか、関連チケット。
各項目の書き方
タイトル
タイトルは、50 件のチケットが並んだ一覧で目に入る部分なので、具体的に書きましょう。「何が壊れているか」+「いつ」+「どこで」という型が便利です。「チェックアウトで有効なカードを入力しても支払いボタンが無効のまま」は、「チェックアウトのバグ」よりずっと役に立ちます。「緊急」や「壊れている」といった言葉だけを書くのは避けましょう。それは重大度の項目が伝えます。
概要
技術に詳しくないチームメンバーにもわかる 1〜2 文で書きます。影響を受ける人がわかっていれば書きましょう。全ユーザーなのか、管理者だけなのか、Safari のユーザーだけなのか、特定の 1 社の顧客だけなのか。
環境
多くのバグは、ブラウザ、デバイス、アカウント、データに左右されます。正確な URL、ブラウザ名とバージョン、OS、使ったアカウントやロールを書き留めましょう。アプリにバージョンやビルド番号が表示されていれば、それも含めます。発生した時刻をタイムゾーン付きで書いておけば、開発者はサーバーログの該当エントリを見つけられます。
再現手順
これがいちばん重要な項目です。手順に番号を振り、既知の状態から始め(「カートが空のユーザーとしてサインイン済み」)、使った正確なデータを書きます。1 つの手順には 1 つの操作だけを書きましょう。2 回目に再現できなかった場合はそう書き、1 回目に何をしたかをできるだけ正確に説明します。
期待される結果と実際の結果
両者の違いがひと目でわかるように並べて書きます。エラーメッセージは言い換えずにテキストのままコピーしましょう。開発者はその文字列でコードを検索します。「何も起きない」も実際の結果として有効ですが、「エラーメッセージは出ず、ボタンは有効なまま」のように、何を確認したかも書き添えましょう。
発生頻度
「毎回」起きるバグは最も直しやすいバグです。「ときどき」起きるバグにはもっと情報が必要なので、発生率を見積もり(「10 回中 3 回」)、遅い回線や大きなファイルなど、関係がありそうなことをメモしておきましょう。
重大度
重大度は影響の大きさを表すもので、あなたがどれだけ困っているかではありません。よく使われる段階は次のとおりです。
| 重大度 | 意味 | 例 |
|---|---|---|
| ブロッカー | 主要なフローが不可能で、回避策がない | 誰もサインインできない |
| 重大 | 重要な機能が壊れている、またはデータが誤っていて、回避策が大変 | 請求書の合計金額が間違っている |
| 軽微 | 小さな問題はあるが機能は動く、または回避策が簡単 | ページを再読み込みすると並び順がリセットされる |
| 見た目のみ | 見た目の問題で、機能への影響はない | 小さな画面でボタンの文字が重なる |
いつ修正するかを決める優先度は、通常は報告者ではなく、バックログを管理するチームが決めます。
回避策
回避策があれば、チームは修正の緊急度を判断でき、サポートはそれまでの間、顧客に案内できます。
添付ファイルとログ
最も時間を節約してくれるのは証拠です。問題の箇所に印を付けたスクリーンショットか、手順がわかる短い画面録画を添付しましょう。Web アプリなら、コンソールのエラーと失敗したネットワークリクエストも加えます。やり方は「Chrome でコンソールログをエクスポートする方法」と「Chrome でネットワーク通信をキャプチャする方法」で紹介しています。HAR ファイルを求められた場合は「HAR ファイルを取得する方法」に従い、先に HAR サニタイザーできれいにしてください。HAR ファイルには Cookie やトークンが含まれるからです。
記入例
タイトル:チェックアウトで有効なカードを入力しても支払いボタンが無効のまま
概要
チェックアウトページで、有効なテストカードを入力しても支払いボタンが
クリックできるようにならず、注文できない。Chrome と Edge で確認。
環境
- URL:https://staging.example.com/checkout
- ブラウザとバージョン:Chrome 154(Windows 11)、Edge 154 でも発生
- デバイス / 画面サイズ:ノート PC、1920x1080
- アプリのバージョンまたはビルド:web 4.18.0(フッターに表示)
- アカウント / ロール / テストユーザー:[email protected]、一般顧客
- 発生日時:2026-11-10 14:32 CET
再現手順
1. [email protected] でサインインする。
2. 「Starter plan, annual」をカートに追加する。
3. /checkout に移動する。
4. テストカード 4242 4242 4242 4242、有効期限 12/30、CVC 123 を入力する。
5. カード入力欄の外をクリックする。
期待される結果
支払いボタンが有効になり、「Pay $120.00」と表示される。
実際の結果
支払いボタンはグレーで無効のまま。エラーメッセージは表示されない。
コンソールの表示:Uncaught TypeError: Cannot read properties of
undefined (reading 'postalCode') at validateCard (checkout.js:214)
発生頻度
毎回(5 回中 5 回)
重大度
ブロッカー:顧客が支払いできない
回避策
見つからず。本番ビルド 4.17.2 では正常に動作する。
添付ファイル
- 画面録画:コメントにリンクあり
- コンソールのエラー:checkout-console.log
- ネットワーク:POST /api/cart/validate は 200 を返した。ほかに失敗はなし
メモ
今朝のステージング環境へのデプロイ後から発生。
この例がうまくいっている理由に注目してください。手順は既知のアカウントから始まっています。テストカードが明記されています。コンソールのエラーが正確に引用されています。報告者は別のブラウザと 1 つ前のビルドでも確認しているので、原因はすでに最新の変更に絞り込まれています。
短縮版
すべてのバグにすべての項目が必要なわけではありません。チームのチャットで手早く伝えるなら、コンパクトな版で十分です。
バグ:[タイトル]
場所:[URL]、[ブラウザ/OS]
手順:1) ... 2) ... 3) ...
期待:...
実際:...
証拠:[スクリーンショット / 録画 / コンソールのエラー]
ユーザーからの報告を転送するカスタマーサポートチームは、顧客のアカウント ID、チケットのリンク、顧客自身の言葉を加え、どの部分を自分で再現できたかを明記しましょう。
QA のテスト実行では、テストケース ID とテスト対象のビルドを加えると、バグを見つけたテストまでさかのぼれます。
GitHub、Linear、Jira 向けのテンプレート
プレーンテキストのテンプレートはどこでも使えます。トラッカーが Markdown を表示できるなら、見出しとチェックリストが読みやすいこちらの版を使いましょう。
## 概要
<!-- 1〜2 文で:何が起きたか、誰が影響を受けるか。 -->
## 環境
- URL:
- ブラウザとバージョン:
- OS:
- アプリのバージョンまたはビルド:
- アカウント / ロール:
## 再現手順
1.
2.
3.
## 期待される結果
## 実際の結果
<!-- 正確なエラーメッセージをテキストのまま貼り付ける。 -->
## 発生頻度
<!-- 毎回 / ときどき(Y 回中 X 回)/ 1 回だけ -->
## 重大度
<!-- ブロッカー / 重大 / 軽微 / 見た目のみ -->
## 証拠
- [ ] スクリーンショットまたは画面録画
- [ ] コンソールのエラー
- [ ] 失敗したネットワークリクエスト
GitHub Issues
Markdown 版をリポジトリの .github/ISSUE_TEMPLATE/bug_report.md として保存し、短いヘッダーを付けておくと、GitHub の「New issue」の選択画面に表示されます。
---
name: バグ報告
about: 何かが壊れている
labels: bug
---
GitHub は Issue フォームにも対応しています。テンプレートがラベル付きの入力欄になり、飛ばすことができません。次の内容を .github/ISSUE_TEMPLATE/bug_report.yml として保存します。
name: バグ報告
description: 何かが壊れている
labels: ["bug"]
body:
- type: textarea
id: summary
attributes:
label: 概要
description: 何が起きましたか?誰が影響を受けていますか?
validations:
required: true
- type: input
id: url
attributes:
label: URL
- type: input
id: environment
attributes:
label: ブラウザ、OS、アプリのバージョン
placeholder: Chrome 154(macOS 26)、web 4.18.0
- type: textarea
id: steps
attributes:
label: 再現手順
value: |
1.
2.
3.
validations:
required: true
- type: textarea
id: expected
attributes:
label: 期待される結果
validations:
required: true
- type: textarea
id: actual
attributes:
label: 実際の結果
description: 正確なエラーメッセージをテキストのまま貼り付けてください。
validations:
required: true
- type: dropdown
id: severity
attributes:
label: 重大度
options:
- ブロッカー
- 重大
- 軽微
- 見た目のみ
- type: textarea
id: evidence
attributes:
label: スクリーンショット、録画、ログ
description: ファイルをここにドラッグするか、録画へのリンクを貼り付けてください。
Linear
Linear では、チームの設定に課題テンプレートがあります。「Bug」という名前のテンプレートを作り、説明欄に Markdown 版を貼り付け、Bug ラベルとチームのトリアージ状態を設定すれば、すべてのレポートが同じ項目から始まります。
Jira
Jira では、新しいバグ(Bug)の説明欄にプレーンテキスト版か Markdown 版を貼り付けます。Jira Cloud には課題タイプごとの説明の初期値を設定する標準機能がないため、テンプレートをあらかじめ入力しておきたいチームは、Atlassian Marketplace の課題テンプレートアプリを使います。コンソールとネットワークのログ付きの画面録画へのリンクは、説明欄かコメントに貼りましょう。
テンプレートで防げるミス
テンプレートの役割の大部分は、いつも同じいくつかのミスを防ぐチェックリストです。
- 1 つのレポートに複数のバグ。 問題 1 つにつきチケット 1 つにすれば、それぞれを個別に修正、テスト、クローズできます。
- 言い換えたエラー。 「権限がどうとか表示された」では検索できません。正確なメッセージなら検索できます。
- 開始地点がない。 フローの途中から始まる手順は、書いた本人にしか再現できません。
- 観察ではなく意見。 「API が壊れている」は推測です。「POST /api/orders が 500 を返した」は、開発者が確認できる事実です。
- 添付ファイルに含まれる機密情報。 管理画面のスクリーンショット、HAR ファイル、コンソールログには、トークンや顧客データが含まれることがあります。添付する前に、トリミング、ぼかし、サニタイズをしましょう。
チームの標準にする
ほとんどの課題管理ツールでは、説明欄の初期値や課題テンプレートを保存できるので、新しいバグがすべてこれらの見出しから始まるようにできます。テンプレートは、みんなが実際に埋められる短さに保ちましょう。ほとんどのレポートで空欄の項目があれば削除します。開発者が毎回同じ質問をしているなら、そのための項目を追加します。
技術的な項目はツールに任せる
最も書き飛ばされやすいのは技術的な項目です。ブラウザのバージョン、コンソールのエラー、失敗したリクエスト。無料の Chrome 拡張機能 Midge は、これらを画面録画やスクリーンショットに自動で添付するので、報告者が書くのはタイトル、手順、期待される結果だけです。すべての録画に、コンソールログ、ネットワークリクエスト、ユーザー操作、デバイス情報が含まれます。パスワード、カード番号、トークン、Cookie は、デバイスから送信される前にブラウザ内で伏せられます。レポートは Jira、Linear、GitHub Issues、Slack に直接送るか、どこにでも貼り付けられるリンクとして共有できます。
関連ガイド
よくある質問
バグ報告テンプレートには何を含めるべきですか?
わかりやすいタイトル、環境(URL、ブラウザ、OS、アプリのバージョン、アカウント)、番号付きの再現手順、期待される結果、実際の結果、発生頻度、重大度、そしてスクリーンショット、動画、コンソールログ、ネットワークリクエストなどの証拠です。
このテンプレートは Jira、Linear、GitHub Issues で使えますか?
はい。Markdown と相性の良い見出しのプレーンテキストなので、どのトラッカーにも貼り付けられます。GitHub と Linear では課題テンプレートとして保存でき、Jira でも Marketplace のアプリを使えば保存できます。
GitHub の Issue テンプレートはどこに置きますか?
リポジトリの .github/ISSUE_TEMPLATE フォルダーです。.md ファイルは Markdown テンプレートを、.yml ファイルは必須項目付きの Issue フォームを追加します。誰かが新しい Issue を作成するときに、GitHub がそれらを一覧で表示します。
重大度と優先度の違いは何ですか?
重大度は、バグがプロダクトやユーザーにどれだけ深刻な影響を与えるかを表します。優先度は、チームがどれだけ早く修正するかを表します。めったに使われない管理画面の深刻なバグが、料金ページの見た目のバグより優先度が低くなることもあります。
すべての項目を埋める必要がありますか?
いいえ。タイトル、手順、期待される結果、実際の結果は必須です。残りはわかる範囲で埋め、わからない項目は推測せずに「不明」と書きましょう。