Bug Report Template|開発者が即座に修正できるバグ報告の書き方とテンプレート
Bug Report QA 開発 GitHub
結論:30秒で極上のバグ報告を作成する
- 必須 4 大要素: ① 事象の要約 / ② 再現手順(ステップ 1,2,3) / ③ 期待動作 vs 実際の動作 / ④ 環境情報
- 開発者が泣いて喜ぶ情報: DevTools の Console 赤文字ログテキストの添付
- 生成ツール: 下のフォームに入力して一発 Markdown フォーマット化
1. オンライン Bug Report テンプレート生成ツール
情報をフォームに入力するだけで、GitHub Issue や Jira に即コピペ可能な Markdown フォーマットを自動生成します。
🐞 この場でバグ報告を作成する
自動取得(ブラウザから見た情報)
※ブラウザのプライバシー保護により、実機スペックと異なる場合があります(GPUはANGLE経由の仮想名等)
必須
ハードウェア
画面
ネットワーク
言語
手動補完(実機スペック)
※ゲームはブラウザと別環境で動くため、実機の情報がバグ特定に重要です
バグ内容
生成ボタンを押すとここに表示されます
2. 標準バグ報告 Markdown テンプレート例
## 概要
ユーザー設定画面で「保存」ボタンをクリックすると、無限ローディング状態になり設定が保存されない。
## 再現手順 (Steps to Reproduce)
1. `/settings/profile` ページにアクセス
2. プロフィール名を「テスト太郎」に変更
3. 画面下部の「保存する」ボタンをクリック
## 期待する動作 (Expected Behavior)
トースト通知「保存しました」が表示され、ボタンのローディングが解除される。
## 実際の動作 (Actual Behavior)
「保存中...」スピナーが消えず、ページがフリーズする。
## 動作環境 (Environment)
- OS: macOS Sonoma 14.5
- Browser: Google Chrome 125.0
- Account: 一般ユーザー権限 (ID: user_99)
## ログ・スクリーンショット
Uncaught (in promise) TypeError: Cannot read properties of undefined (reading ‘status’) at saveProfile (profile.js:42)
3. 注意点(ハマりどころ)
- 「動かない」「壊れた」等の曖昧な表現
- 「保存ができません」だけでは、ボタンが押せないのか、エラーが出るのか、通信が失敗しているのか分かりません。「どのような画面状態で止まるか」を客観的に記述してください。
- 個人情報や本番機密キーのスクリーンショット写り込み
- Console ログやネットワークヘッダーのスクショを貼る際、
Authorization: Bearer <JWT>や個人顧客のメールアドレスが写り込んでいないか投稿前に確認してください。
- Console ログやネットワークヘッダーのスクショを貼る際、