結構化輸出
每份 bug 報告都遵循這個結構:
- 標題 — 簡潔摘要(最多 8 個字)
- 發生了什麼 — 描述 bug 的行為
- Git 上下文 — 目前分支與最近變更
- 重現步驟 — 從描述推斷,或預留步驟
- 預期 vs 實際 — 對照格式
嚴重程度自動偵測
系統會從你的描述推斷嚴重程度:
| 嚴重程度 | 觸發字詞 | 範例 |
|---|---|---|
| Critical | crash、data loss、security、down、blocks | 「App crashes on startup」 |
| High | broken、fails、can’t、regression | 「Login form fails validation」 |
| Medium | wrong、incorrect、unexpected、slow | 「API returns wrong data」 |
| Low | minor、cosmetic、typo、alignment | 「Button misaligned on mobile」 |
Git 整合
一次 Bash 呼叫就擷取:
- 目前分支名稱
- 最近變更的摘要(最近幾個 commit)
- 與 bug 區域相關的已修改檔案
這些上下文會自動納入 bug 報告,下一位開發者就能看到 bug 附近改了什麼。
何時用 /note-bug
當你想要以下功能時,用 /note-bug 而不是 /note:
- 自動嚴重程度標記
- 報告裡帶 git 上下文
- 結構化的重現步驟格式
- 粉紅色標記,方便辨識