バグ報告テンプレートとは何か？
バグ報告テンプレートは、開発者が不具合を理解し、再現し、修正するために必要なすべての情報を捕捉する標準化されたフォームです。テスターがそれぞれのスタイルでレポートを書くのではなく、テンプレートを使用することで一貫性が確保されます — 毎回、同じフィールドが同じ順序で含まれるようになります。
その結果、行ったり来たりのやり取りが減り、修正が速くなり、「自分の環境では動作する」という行き止まりが少なくなります。それをバグテンプレート、バグトラッカーテンプレート、または不具合報告書と呼んでも、目標は同じです：開発者に事前に実用的な情報を提供することです。
バグ報告テンプレート（コピー&ペースト可能）
以下は、イシュートラッカー、メール、またはドキュメントに直接コピーできるバグ報告テンプレートです：
Title: [Short, specific summary of the issue]
ID: [BUG-0001]
Reporter: [Your name]
Date: [YYYY-MM-DD]
Priority: [Critical / High / Medium / Low]
Status: [Open]
Environment:
- URL: [https://example.com/checkout]
- Browser: [Chrome 120, macOS 14]
- Device: [Desktop / iPhone 14]
- Resolution: [1920x1080]
- User account: [test@example.com]
Steps to Reproduce:
1. [Go to ...]
2. [Click ...]
3. [Enter ...]
4. [Observe ...]
Expected Result:
[What should have happened]
Actual Result:
[What actually happened]
Screenshot:
[Attach annotated screenshot highlighting the issue]
Screen Recording:
[Attach short screen recording (WebM/MP4) showing the bug in action]
Console Errors / Network Failures:
[Paste any error-level console logs or failed network requests]
Notes:
[Workarounds, frequency (always / intermittent), related tickets]
バグのタイトル例
タイトルは最も重要なフィールドです — 開発者がバックログで最初にスキャンするのがタイトルです。優れたバグのタイトルは具体的で、コンポーネントを特定し、障害を説明します。以下に、弱いタイトルと強いタイトルの違いを示すバグのタイトル例を示します。
弱いタイトル（これらは避けてください）：
- "Button broken"
- "Error"
- "It doesn't work"
- "Bug on homepage"
強いタイトル：
- "Checkout 'Submit' button freezes page for 5s then shows blank screen on mobile Safari"
- "Profile avatar upload returns 500 error when file exceeds 5MB"
- "Date picker overlaps 'Save' button on screens narrower than 768px"
- "Newsletter signup form submits twice when pressing Enter key"
有用なパターンは：[コンポーネント] + [アクション] + [予期しない結果] + [条件] です。例えば、"Cart counter does not update after removing last item on Firefox." のようになります。
バグの再現手順：例
あいまいな再現手順は、「再現できません」というチケットの最大の原因です。以下に、適切に作成されたバグの再現手順の例を示します：
test@example.com/cartExpected: Cart counter updates to "0" immediately after removal. Actual: Cart counter stays at "1" until a full page refresh.
重要な点は、開発者でもQAエンジニアでもプロダクトマネージャーでも、誰もがこれらの正確な手順に従って同じ結果を見ることができるということです。
バグ報告サンプル
以下は、上記のテンプレートを使用した完全なバグ報告サンプルです。記入例を確認できます：
Title: Cart counter does not update after removing last item on Firefox
ID: BUG-0042
Reporter: Sarah Chen
Date: 2026-08-05
Priority: Medium
Status: Open
Environment:
- URL: https://shop.example.com/cart
- Browser: Firefox 121, macOS 14
- Device: Desktop
- Resolution: 1440x900
- User account: test@example.com
Steps to Reproduce:
1. Log in as test@example.com
2. Add "Wireless Mouse" to the cart
3. Go to /cart
4. Click "Remove" next to the product
Expected Result:
The header cart counter updates from "1" to "0" instantly.
Actual Result:
The counter stays at "1" until the page is refreshed.
Screenshot:
[Attached: annotated screenshot highlighting the stale counter]
Screen Recording:
[Attached: 12s WebM recording showing the counter stuck after removal]
Console Errors / Network Failures:
None
Notes:
Reproducible 100% on Firefox. Works correctly on Chrome and Safari.
Likely a state-sync issue in the cart event listener.
バグトラッカーテンプレート
チームレベルでバグを管理する場合、バグトラッカーテンプレート（バグ追跡テンプレートとも呼ばれます）は、スプレッドシート内で複数のレポートを整理するのに役立ちます。以下にシンプルな構造を示します：
| ID | Title | Priority | Status | Assignee | Reporter | Date | URL | Recording | Reproducible |
|---|---|---|---|---|---|---|---|---|---|
| BUG-0042 | Cart counter stale on Firefox | Medium | Open | — | Sarah C. | 2026-08-05 | /cart | ✅ | Yes |
| BUG-0043 | Login button unresponsive on iOS 17 | High | In Progress | M. Lee | Tom K. | 2026-08-04 | /login | ✅ | Yes |
| BUG-0044 | PDF export missing page numbers | Low | Open | — | Ana R. | 2026-08-03 | /reports | — | Intermittent |
これはGoogle Sheets、Excel、Notion、またはチームが既に使用している任意のツールで作成できます。重要なのは、すべての列が上記のバグ報告テンプレートのフィールドに対応していることで、個々のレポートがトラッカーにきれいに集約されることです。
ダウンロード：バグ報告テンプレート（Word & Markdown）
すぐに使用できるファイルが必要ですか？上記のテンプレートセクションを以下にコピーできます：
- Microsoft Word — 貼り付けて
.docxとして保存すると、チームがオフラインで記入できるバグ報告テンプレートWordドキュメントになります。 - Markdown — 上記の生のテキストブロックをリポジトリやWikiに保存して、バージョン管理されたバグテンプレートとして使用できます。
- Issue tracker — Jira、Linear、GitHub Issues、またはTrelloの各フィールドをカスタムフィールドにマッピングできます。
プレーンテキストなので、同じテンプレートがすべてのフォーマットで機能します — 壊れるような独自フォーマットはありません。
BugCapturer がどのようにテンプレートを自動的に記入するか
バグ報告テンプレートのほとんどのフィールドは手動で記入するのが面倒です — そしてまさにその部分でレポートが雑になります。BugCapturer はバグ報告とWebフィードバックのためのブラウザ拡張機能で、反復的な部分を自動化します：
- 注釈付きスクリーンショット： ドラッグして問題領域を選択し、矢印、四角形、テキストを追加して問題を強調表示 — 別のスクリーンショットツールは必要ありません。
- 画面録画（v1.2.0）： 現在のタブをWebMビデオとして録画し、クリップをトリミングしてキーフレームを抽出 — すべてブラウザ内で完了し、アップロードは不要です。録画を直接バグ報告に添付できます。
- 自動技術メタデータ： URL、ブラウザ、OS、画面解像度、ビューポートが自動的に収集されるため、Environmentブロックが自動的に入力されます。
- 診断データ収集： エラーレベルのコンソールログと失敗したネットワークリクエスト（HTTP ステータス ≥ 400）をキャプチャします。機密パラメータ（トークン、パスワード、API キー）については、ネットワークURLが自動的に編集されます。
- Excel/TSV エクスポート（v1.2.0）： 12列の構造化されたバグ報告行（URL、メタデータ、コンソールエラー、ネットワーク障害）をワンクリックでクリップボードにコピー。Excel、Google Sheets、または Numbers に直接貼り付けてチームレベルの追跡ができます。
- ワンクリックメール： すべてがテンプレートに一致する構造化されたメールにパッケージ化され、開発者に送信する準備が整います。
その結果、上記のテンプレートに一致するバグ報告が — 手動で入力することなく — 作成されます。
バグ報告チェックリスト
次のレポートを送信する前に、すべてのフィールドがカバーされていることを確認してください：
- 明確で具体的なタイトル（コンポーネント + アクション + 結果 + 条件）
- 環境の詳細（URL、ブラウザ、OS、解像度）
- 番号付きされた再現手順
- 期待結果と実際の結果
- 注釈付きスクリーンショットまたは録画
- 説明が難しいバグにはScreen Recording（WebM）
- コンソールエラー / ネットワーク障害（あれば）
- チーム追跡のためのExcel/TSVエクスポート（任意だが推奨）
- 優先度と再現性が記載されている
すべてのレポートでこのテンプレートを使用すれば、開発者は「何をしたの？」と尋ねる時間を減らし、実際にバグを修正する時間を増やすことができます。