ストーリー
先
先輩
テスト実行中にバグを見つけました！
先
先輩
おっ、よく見つけたね。で、どういうバグ？
先
先輩
えっと…なんか動かなくて…
先
先輩
それだと開発者が再現できないよ。バグ報告の書き方を覚えよう
なぜ報告が重要か
テストで問題を見つけても、適切に報告しなければ修正されません。
| 悪い報告 | 良い報告 |
|---|---|
| 「動かない」 | 「ログインボタンを押すとエラーが表示される」 |
| 「おかしい」 | 「金額が税込ではなく税抜で表示される」 |
| 「バグです」 | 「再現手順、期待結果、実際結果を添えた報告」 |
開発者が報告を読んだだけで問題を再現できるのが理想です。
バグ報告の構成要素
バグ報告には以下の情報を含めます。
| 要素 | 説明 | 必須 |
|---|---|---|
| タイトル | バグの内容を1行で表す | 必須 |
| 再現手順 | バグを再現するための手順 | 必須 |
| 期待結果 | 本来どうなるべきだったか | 必須 |
| 実際結果 | 実際に何が起きたか | 必須 |
| 環境情報 | OS、ブラウザ、バージョン等 | 必須 |
| 重要度 | バグの深刻さ | 推奨 |
| スクリーンショット | 視覚的な証拠 | 推奨 |
| 備考 | 補足情報 | 任意 |
バグ報告の書き方
テンプレート
## バグ報告
### タイトル
[機能名] 具体的な問題の説明
### 環境情報
- OS: Windows 11 / macOS 14
- ブラウザ: Chrome 120.0
- テスト環境: staging
- テスト日時: 2025-04-01 14:30
### 再現手順
1. https://staging.example.com/login を開く
2. メールアドレスに「test@example.com」を入力する
3. パスワードに「Test1234」を入力する
4. 「ログイン」ボタンをクリックする
### 期待結果
ダッシュボード画面に遷移し、ユーザー名が表示される
### 実際結果
「500 Internal Server Error」が表示される
### 重要度
高（ログインできないため、すべての機能が使用不可）
### スクリーンショット
（添付画像）
### 備考
- 同じ手順で3回試行し、毎回同じエラーが発生
- 別のユーザーでも同じ現象を確認良い報告と悪い報告の比較
悪い報告の例
タイトル: ログインできない
内容: ログインしようとしたら動きません。バグだと思います。問題点:
- 再現手順がない
- 環境情報がない
- 期待結果と実際結果が明確でない
良い報告の例
タイトル: [ログイン] 正しい認証情報でログインすると500エラーが表示される
環境情報: Chrome 120.0 / macOS 14 / staging環境
再現手順:
1. https://staging.example.com/login を開く
2. メールアドレス: test@example.com を入力
3. パスワード: Test1234 を入力
4. 「ログイン」ボタンをクリック
期待結果: ダッシュボードに遷移する
実際結果: 「500 Internal Server Error」が表示される
再現率: 100%（3回中3回発生）重要度の目安
バグにはレベルがあります。報告時に重要度を添えましょう。
| 重要度 | 基準 | 例 |
|---|---|---|
| 致命的（Critical） | サービスが利用不可 | サーバーがダウン、データが消える |
| 高（High） | 主要機能が使えない | ログインできない、購入ができない |
| 中（Medium） | 機能は使えるが問題あり | 表示が崩れる、エラーメッセージが不適切 |
| 低（Low） | 軽微な問題 | 誤字脱字、デザインの微調整 |
テスト結果のまとめ方
個別のバグ報告に加えて、テスト全体の結果をまとめます。
テスト結果サマリーの例
## テスト結果サマリー
### 実施概要
- テスト対象: ログイン機能
- テスト期間: 2025-04-01
- テスト実行者: 田中
- テスト環境: staging
### 結果概要
| 合否 | 件数 |
|------|------|
| PASS | 8 |
| FAIL | 2 |
| BLOCKED | 1 |
| 未実施 | 0 |
| 合計 | 11 |
### FAIL一覧
| ID | テスト名 | 重要度 | バグチケット |
|----|---------|--------|-------------|
| TC-LOGIN-001 | 正常ログイン | 高 | BUG-101 |
| TC-LOGIN-005 | パスワードリセット | 中 | BUG-102 |
### 所見
ログイン機能の基本的な認証処理にバグがあり、
正常系のテストがFAILとなっています。
修正後の再テストが必要です。報告時の心構え
| やるべきこと | やってはいけないこと |
|---|---|
| 事実を正確に伝える | 感情的に伝える |
| 再現手順を具体的に書く | 「動かない」とだけ書く |
| エビデンスを添付する | 口頭だけで報告する |
| 重要度を判断して伝える | すべて「致命的」にする |
| 早めに報告する | 修正方法まで考えてから報告する |
バグを見つけたら早めに報告しましょう。 原因の特定や修正は開発者の仕事です。
まとめ
| ポイント | 内容 |
|---|---|
| バグ報告の必須要素 | タイトル、再現手順、期待結果、実際結果、環境情報 |
| 良い報告 | 開発者が読んだだけで再現できる報告 |
| 重要度 | 致命的、高、中、低の4段階 |
| 結果サマリー | テスト全体の結果をまとめて報告 |
チェックリスト
- バグ報告のテンプレートを使える
- 再現手順を具体的に書ける
- 期待結果と実際結果を明確に区別できる
- 重要度の判断基準を理解した
次のステップへ
テスト結果の報告方法が理解できましたか？
次のセクションでは、テスト実行のシミュレーション演習に挑戦します。 ここまで学んだ知識をフル活用して、テスト実行から報告までを体験しましょう。
推定読了時間: 30分