bug-reporting-excellence
撰寫高品質且能快速修復的錯誤報告。適用於報告錯誤、培訓團隊錯誤報告撰寫技巧或建立標準化流程。
簡介
bug-reporting-excellence 技能是一個專為消除缺陷溝通模糊性而設計的專業品質工程框架。它為工程師、QA 分析師和產品經理提供了一個標準化的公式來記錄軟體問題,確保開發人員擁有快速修復問題所需的所有上下文。通過執行嚴格的結構(包括組件識別、精確的環境詳細信息、預期與實際行為以及可操作的復現步驟),此技能最大限度地減少了報告團隊和開發團隊之間的來回溝通。它是建立組織品質標準的必要工具,可以直接集成到您的 CI/CD 反饋迴圈或問題跟蹤系統(如 Jira、GitHub Issues 或 Linear)中。
-
標準化錯誤公式:強制執行一致的模板(組件、嚴重性、環境、預期/實際行為、復現步驟),以保證 100% 的可復現性和清晰度。
-
智慧分類與協調:透過 qe-quality-analyzer 代理實現自動錯誤分類、重複問題檢測,並透過 qe-production-intelligence 代理進行根本原因分析。
-
嚴重性分類:包含從嚴重(系統宕機、資料遺失)到低級(外觀問題)的全面參考卡,確保優先順序對齊。
-
消除反模式:明確避免不良報告習慣,如模糊的描述或將多個不相關的錯誤綑綁在一個報告中,強制實現模組化的原子級問題追蹤。
-
艦隊協調:與更廣泛的 agentic-qe 生態系統協調,包括 technical-writing、exploratory-testing-advanced 和 sherlock-review,以簡化整個品質工程生命週期。
-
始終提供精確的環境詳細信息,例如瀏覽器版本(Chrome、Firefox、Safari)、作業系統、特定 URL 和唯一的請求 ID,以實現更快的除錯。
-
使用提供的標題公式(組件在條件下失敗導致影響)以確保在您的專案管理儀表板中的可搜尋性和即時識別。
-
附上具體證據,例如 JSON 錯誤日誌、堆疊追蹤、控制台輸出和螢幕截圖,這些是開發人員介入的關鍵成功因素。
-
當報告生產環境問題時,如果已知,請引用部署版本或特定 PR,以協助識別潛在的回歸問題。
-
此技能專為高效率團隊設計,鼓勵每個報告處理一個錯誤的做法,防止票據膨脹並確保工程主管能準確追蹤進度。
倉庫統計
- Star 數
- 329
- Fork 數
- 65
- Open Issue 數
- 4
- 主要語言
- TypeScript
- 預設分支
- main
- 同步狀態
- 閒置
- 最近同步時間
- 2026年4月29日 上午06:25