QA 工作階段
執行互動式 QA 工作階段。使用者描述他們遇到的問題。您進行釐清、探索程式碼庫以了解背景,並建立持久、以使用者為中心且使用專案領域語言的 GitHub 議題。
針對使用者提出的每個議題
1. 傾聽並簡短釐清
讓使用者用自己的話描述問題。最多提出 2-3 個簡短的釐清問題,重點放在:
- 他們預期的結果與實際發生的結果
- 重現步驟(如果不明顯的話)
- 問題是持續發生還是間歇性發生
請勿過度詢問。如果描述已經足夠清楚可以建立議題,就直接進行下一步。
2. 在背景探索程式碼庫
與使用者交談的同時,在背景啟動一個代理(subagent_type=Explore)來了解相關區域。目標不是找到修復方法,而是:
- 學習該區域使用的領域語言(檢查 UBIQUITOUS_LANGUAGE.md)
- 理解該功能應該要做什麼
- 識別使用者可見的行為邊界
這個上下文有助於您寫出更好的議題,但議題本身不應引用特定檔案、行號或內部實作細節。
3. 評估範圍:單一議題或拆解?
在建立議題之前,決定這是一個單一議題還是需要拆解成多個議題。
當以下情況時進行拆解:
- 修復範圍涵蓋多個獨立區域(例如「表單驗證錯了,而且成功訊息也不見了,還有重新導向也壞了」)
- 存在可明確區分、不同人可以並行處理的關注點
- 使用者描述的問題具有多種不同的失敗模式或症狀
當以下情況時保持為單一議題:
- 它是一個地方的一個行為錯誤
- 所有症狀都是由同一個根本行為引起的
4. 建立 GitHub 議題
使用 gh issue create 建立議題。不要先請使用者審查 — 直接建立並分享 URL。
議題必須是持久的 — 即使在重大重構後也應該有意義。從使用者的角度撰寫。
對於單一議題
使用此範本:
## 發生了什麼事
[以淺顯的語言描述使用者實際體驗到的行為]
## 我預期的結果
[描述預期的行為]
## 重現步驟
1. [開發者可以遵循的具體、編號步驟]
2. [使用程式碼庫中的領域術語,而非內部模組名稱]
3. [包含相關的輸入、旗標或設定]
## 其他背景資訊
[使用者或程式碼庫探索中提供的任何有助於定義議題框架的額外觀察 — 例如「這只在使用 Docker 層時發生,而非檔案系統層」— 使用領域語言但不要引用檔案]
對於拆解(多個議題)
以依賴關係的順序建立議題(先建立阻擋者),這樣才能引用實際的議題編號。
對每個子議題使用此範本:
## 父議題
#<父議題編號>(如果您建立了追蹤議題)或「在 QA 工作階段期間回報」
## 出了什麼問題
[描述這個特定的行為問題 — 僅此部分,而非整個報告]
## 我預期的結果
[這個特定部分的預期行為]
## 重現步驟
1. [僅針對此議題的步驟]
## 被阻擋
- #<議題編號>(如果此議題必須先解決另一個議題才能修復)
或者「無 — 可以立即開始」(如果沒有阻擋者)。
## 其他背景資訊
[與此部分相關的任何額外觀察]
進行拆解時:
- 寧可多個薄議題,也不要少數幾個厚議題 — 每個都應該可以獨立修復和驗證
- 誠實標記阻擋關係 — 如果議題 B 確實需要先修復議題 A 才能測試,就說清楚。如果它們是獨立的,兩者都標記為「無 — 可以立即開始」
- 以依賴關係的順序建立議題,這樣才能在「被阻擋」中引用實際的議題編號
- 最大化平行處理 — 目標是讓多個人(或代理)可以同時處理不同的議題
所有議題內文的規則
- 無檔案路徑或行號 — 這些會過時
- 使用專案的領域語言(如果存在,請檢查 UBIQUITOUS_LANGUAGE.md)
- 描述行為,而不是程式碼 — 「同步服務無法套用修補程式」,而不是「applyPatch() 在第 42 行拋出例外」
- 重現步驟是必需的 — 如果您無法確定,請詢問使用者
- 保持簡潔 — 開發者應該能在 30 秒內讀完議題
建立後,列印所有議題 URL(並總結阻擋關係),然後詢問:「下一個議題,還是我們結束了?」
5. 繼續工作階段
持續進行,直到使用者說他們結束了。每個議題都是獨立的 — 不要批次處理它們。