はじめに
こんにちは！
ヨーロッパでC# WPFエンジニアとして働いている日本人エンジニアです。
JIRAでのバグ報告は、
**「明確・簡潔・具体的」**が鉄則。
これが守れないと、対応が遅れたり誤解を生んだりします。
今回は、JIRAチケットに必須の各フィールドの書き方と、
リアルな英文バグ報告例を丸ごと紹介します！
1. JIRAバグチケットの基本構成と説明
| フィールド名 | 説明・書き方のポイント | 例文・注意点 |
|---|---|---|
| Summary | バグの要約。できるだけ簡潔に。 | “App crashes when clicking Save button” |
| Description | 詳細説明。状況、再現手順、期待結果と実際の結果を含める。 | 下記具体例参照 |
| Environment | 発生環境（OS、ブラウザ、アプリバージョンなど） | “Windows 10, App v2.3.1” |
| Steps to Reproduce | 再現手順を番号付きで明確に記述。 | 下記具体例参照 |
| Expected Result | 期待される正しい動作 | 下記具体例参照 |
| Actual Result | 実際の問題発生状況 | 下記具体例参照 |
| Severity / Priority | 問題の重要度や対応優先度 | Severity: High / Priority: P1 |
| Attachments | スクリーンショットやログファイルなど | 添付ファイルがあれば必ずアップロード |
| Reporter | バグ報告者（自分の名前） | 自動入力の場合多い |
| Assignee | 担当者 | 通常はPMや担当チームが設定 |
2. バグ報告Description（詳細説明）テンプレート例
【Description構成例】
Summary: [簡潔な問題の要約]
Environment:
- OS: Windows 10
- App Version: 2.3.1
- Browser: Chrome 90.0.4430.212
Steps to Reproduce:
1. Launch the application.
2. Navigate to the "User Settings" page.
3. Click the "Save" button without changing any fields.
Expected Result:
The application should save the current settings and display a success message.
Actual Result:
The application crashes with an error message "Unhandled exception occurred" and closes unexpectedly.
Severity: High
Priority: P1
Additional Information:
- This issue occurs consistently on Windows 10 but not on MacOS.
- Attached logs show stack trace of the crash.
Attachments:
- crash_log_2025_06_29.txt
- screenshot_error.png
3. JIRAチケット丸ごと例文（テンプレート実例）
■ Example 1: アプリクラッシュのバグ報告
Summary: App crashes when clicking Save button on User Settings page
Environment:
- OS: Windows 10 Pro 21H2
- App Version: 2.3.1
- Browser: Chrome 90.0.4430.212
Steps to Reproduce:
- Launch the application.
- Login with valid user credentials.
- Go to “User Settings” from the profile menu.
- Click the “Save” button without changing any settings.
Expected Result:
Settings should be saved successfully, and a confirmation message should appear.
Actual Result:
The app immediately crashes with an “Unhandled exception occurred” error message, closing the app.
Severity: High
Priority: P1
Additional Information:
- Issue only reproducible on Windows 10, not on MacOS Catalina.
- Crash logs attached for reference.
Attachments:
- crash_log_2025_06_29.txt
- screenshot_crash.png
■ Example 2: UI表示異常バグ報告
Summary: Text overlapping issue on the main dashboard in small window sizes
Environment:
- OS: macOS Monterey 12.3
- App Version: 2.3.1
- Browser: Safari 15.1
Steps to Reproduce:
- Open the application in Safari browser.
- Resize the window to width less than 800px.
- Navigate to the main dashboard page.
Expected Result:
Text and buttons should adjust responsively without overlapping.
Actual Result:
Some texts overlap on the right side, making buttons unclickable.
Severity: Medium
Priority: P2
Additional Information:
- Issue does not appear on Chrome or Firefox browsers.
- Possibly related to recent CSS changes.
Attachments:
- screenshot_dashboard_overlap.png
4. ポイント＆注意点
- 具体的かつ客観的に記載すること
- 主観的な感想や憶測は避ける
- 必ず再現手順を書く
- 優先度は状況に応じて適切に設定
- 添付ファイルは必ずつける（スクショやログ）
- チケットの更新はこまめに行う
おわりに
JIRAでのバグ報告は開発チームの動きを左右します。
ここで紹介したテンプレと実例を活用して、
「誰が見ても分かりやすい」質の高い報告を目指しましょう！
コメント