bug-reporting-excellence

Bug Reporting Excellence 是一項專門的品質工程技能，旨在消除缺陷追蹤中的模糊性。它提供了一個結構化的溝通框架，將模糊的錯誤報告轉化為可執行的工程任務。此技能適用於 QA 工程師、軟體開發人員和技術主管，他們需要最小化回報問題與驗證修復之間的來回溝通週期。透過強制執行「一個錯誤 = 一份報告」的政策，並為環境細節、重現步驟和影響分析提供標準化架構，此技能確保開發團隊擁有優先處理並高效修復錯誤所需的診斷數據。

• 標準化報告架構，包含組件、嚴重性等級、環境、預期與實際行為以及清晰的重現步驟。

• 用於隔離變數（如瀏覽器版本、作業系統細節、請求 ID 和特定使用者條件）的內建邏輯，以縮小根本原因範圍。

• 使用現有的 QE 代理（如 qe-quality-analyzer 和 qe-production-intelligence）進行自動化錯誤分類和重複問題檢測的整合模式。

• 反模式檢測，可防止混淆多個錯誤或提供不足的重現上下文等常見錯誤。

• 涵蓋從系統崩潰事件到 UI 外觀邊緣案例的嚴重性評估準則。

• 在執行手動測試、指導團隊成員進行品質文件編寫，或將錯誤回報整合到 CI/CD 工作流程時使用此技能。

• 輸入通常包括原始觀察數據、日誌、主控台輸出和截圖，代理會將其整合為專業報告。

• 輸出格式為適合 Jira、GitHub Issues 或專案管理工具的 Markdown 報告。

• 遵循提供的檢查清單（如：100% 重現步驟，80% 證據包含率），以維護所有產生報告的高信任度等級。

• 將此技能與技術寫作和根本原因調查工作流程結合，建立全面的回饋循環，以提升整體產品品質和開發速度。