qe-bug-reporting-excellence

バグ報告を適切に行う

<default_to_action> バグを報告するときは、次の手順に従ってください。

1. タイトル：[Component] fails [Condition] causing [Impact]
2. 説明：期待される動作 → 実際の動作 → 再現手順
3. 含める情報：環境、深刻度、スクリーンショット／ログ、ビジネスへの影響
4. 条件を絞り込む：ブラウザー、ユーザー、金額のしきい値など
5. 1つのバグにつき報告は1件（複数の問題をまとめない）

バグ報告のテンプレート：

## [Component] Issue Title
**Severity:** Critical/High/Medium/Low
**Environment:** Production/Staging/Dev

### Expected Behavior
What should happen

### Actual Behavior
What actually happens (with error messages)

### Steps to Reproduce
1. Step one
2. Step two
3. Observe issue

### Impact
How this affects users/business

成功のための重要事項：

• 再現可能な手順（100%）
• 環境情報（100%）
• ビジネスへの影響の記載（90%）
• スクリーンショットまたはログ（80%） </default_to_action>

クイックリファレンスカード

深刻度

レベル	定義	例
Critical	システム停止、データ損失、セキュリティ	DB の削除、決済の障害、認証情報の漏えい
High	主要機能の障害、多数のユーザーに影響	チェックアウト不可、検索の障害、ダッシュボードの動作不良
Medium	部分的な障害、回避策あり	フィルターの障害（更新すれば動作）、エクスポートが遅い
Low	見た目の問題、まれなエッジケース	モバイルでボタンのテキストが折り返される、ツールチップの色が違う

タイトルのテンプレート

❌ 悪い例：「チェックアウトが壊れている」 ✅ 良い例：「注文合計が $1000 を超えると Visa カードでの決済に失敗する」

パターン： [Component] fails [Condition] causing [Impact]

---

必須情報

環境の詳細

Browser: Chrome 120.0.6099.109 (Windows)
OS: Windows 11 Pro
URL: https://example.com/checkout
Date/Time: 2025-10-17 14:23 UTC
User: [email protected] (ID: 12345)
Request ID: abc-123-def-456

裏付けとなる証拠

エラーメッセージ：

{
  "error": "Payment service unavailable",
  "code": "GATEWAY_TIMEOUT",
  "requestId": "abc-123-def-456"
}

コンソールログ：

[ERROR] PaymentGateway: Connection timeout after 30000ms
  at PaymentGateway.charge (gateway.js:145)

---

例：優れたバグ報告

## [Checkout] Payment processing times out for orders > $1000

**Severity:** High
**Environment:** Production
**Affected Users:** ~15% of premium purchases

### Expected Behavior
Payment completes within 5 seconds regardless of amount.

### Actual Behavior
For orders above $1000, payment gateway times out after 30 seconds.
User sees "Payment failed" error. Order not created.

### Steps to Reproduce
1. Add items totaling $1,050 to cart
2. Proceed to checkout
3. Enter payment: Visa 4532 1234 5678 9010
4. Click "Place Order"
5. Wait 30+ seconds
6. Observe timeout error

### Environment
- Browser: Chrome 120 (Windows 11)
- User: [email protected]
- Request ID: abc-123-def-456

### Evidence
Console error: `PaymentGateway timeout: 30000ms exceeded`
Network: /api/checkout: 30.14s (timeout)

### Impact
- Lost revenue: ~$15K/week from failed orders
- 23 support tickets this week
- Affects 15% of orders over $1000

### Additional Context
Started after Oct 15 deployment (v2.3.0)
Possibly related to PR #456 (fraud check)

---

避けるべきパターン

❌ 悪い例	問題点	✅ 良い例
「チェックアウトが壊れている」	何が動作しないのでしょうか？	「クリックしても決済ボタンが反応しない」
「エラーが表示された」	再現手順がない	条件を含む詳細な手順
「ページの読み込みが遅い」	具体性がない	「ダッシュボードの読み込みに12秒かかる（3秒未満が想定）」
1件に複数のバグ	個別に追跡できない	バグ1件につき報告1件

---

エージェントとの連携

// Automated bug triage
const triage = await Task("Triage Bug", {
  title: 'Payment fails for orders > $1000',
  description: bugDescription,
  steps: reproductionSteps
}, "qe-quality-analyzer");

// Returns: { severity, priority, component, suggestedAssignee, relatedIssues }

// Duplicate detection
const dupeCheck = await Task("Check Duplicates", {
  bugReport: newBug,
  similarityThreshold: 0.85
}, "qe-quality-analyzer");

// Bug report enhancement
const enhanced = await Task("Enhance Report", {
  originalReport: userSubmittedBug,
  addMissingInfo: true,
  identifyRootCause: true
}, "qe-production-intelligence");

---

エージェント連携のヒント

メモリーの名前空間

aqe/bug-reports/
├── triaged/*          - Bug triage results
├── duplicates/*       - Duplicate detection
├── patterns/*         - Recurring bug patterns
└── root-cause/*       - Root cause analyses

フリート連携

const bugFleet = await FleetManager.coordinate({
  strategy: 'bug-investigation',
  agents: [
    'qe-quality-analyzer',        // Triage and categorize
    'qe-flaky-test-hunter',       // Check if test-related
    'qe-production-intelligence'  // Check production logs
  ],
  topology: 'parallel'
});

---

関連スキル

• 技術文書の作成 - 明確なバグの記録
• 高度な探索的テスト - バグの発見
• sherlock-review - 根本原因の調査

---

覚えておきましょう

バグ報告は、誰かが作業を始めるための出発点です。完全（必要な情報がすべて揃っている）、明確（誰でも内容を理解できる）、簡潔（余計な情報がない）、そして実行可能（開発者が次の手順を把握できる）にしてください。

優れたバグ報告 = 修正の迅速化 = 製品の改善 = ユーザーの満足度向上