分類
將專案議題追蹤器上的問題,透過一個小型的狀態機進行分類角色管理。
分類期間張貼到議題追蹤器的每一則留言或議題必須以以下免責聲明開頭:
> *此內容由AI在分類過程中產生。*
參考文件
- AGENT-BRIEF.md — 如何撰寫持久的代理簡報
- OUT-OF-SCOPE.md —
.out-of-scope/知識庫的運作方式
角色
兩種分類角色:
bug— 某個東西壞了enhancement— 新功能或改善
五種狀態角色:
needs-triage— 維護者需要評估needs-info— 等待回報者提供更多資訊ready-for-agent— 已完整定義,可交給離線AI代理ready-for-human— 需要由人工實作wontfix— 不會處理
每個經過分類的議題應精確攜帶一個分類角色與一個狀態角色。若狀態角色衝突,請標記出來並在進行任何其他操作前先詢問維護者。
這些是標準角色名稱——議題追蹤器上實際使用的標籤字串可能不同。對應關係應已提供給你——若尚未提供,請執行 /setup-matt-pocock-skills。
狀態轉換:未標籤的議題通常先進入 needs-triage;從那裡可移往 needs-info、ready-for-agent、ready-for-human 或 wontfix。needs-info 在回報者回覆後會回到 needs-triage。維護者隨時可以覆寫——請標記看起來不尋常的轉換,並在繼續前先詢問。
調用方式
維護者輸入 /triage 並以自然語言描述他們想要什麼。解讀請求後採取行動。範例:
- "顯示任何需要我關注的事項"
- "我們來看看 #42"
- "將 #42 移至 ready-for-agent"
- "有哪些議題是代理可以承攬的?"
顯示需要關注的項目
查詢議題追蹤器並呈現三個區塊,以最早建立者優先排序:
- 未標籤 — 從未經過分類。
needs-triage— 正在評估中。needs-info且回報者在上次分類註記後有新活動 — 需要重新評估。
顯示每個區塊的數量以及每項議題的一行摘要。讓維護者挑選。
分類特定議題
-
蒐集上下文。 閱讀完整的議題(內文、留言、標籤、回報者、日期)。解析任何先前的分類註記,以免重複詢問已解決的問題。使用專案的領域詞彙表探索程式碼,並尊重該區域的 ADR。閱讀
.out-of-scope/*.md並找出任何與此議題相似的先前拒絕記錄。 -
推薦。 向維護者說明你的分類與狀態建議及理由,並附上與該議題相關的簡要程式碼摘要。等待指示。
-
重現(僅限錯誤)。 在追問之前,先嘗試重現:閱讀回報者的步驟、追蹤相關程式碼、執行測試或命令。回報結果——成功重現並附上程式碼路徑、重現失敗、或資訊不足(強烈的
needs-info訊號)。確認的重現案例能使代理簡報有力得多。 -
追問(如有需要)。 若議題需要進一步釐清,請同時執行
/grilling和/domain-modeling技能——一次一個問題地將議題追問成形,釐清領域詞彙,並在決策確定時即時更新CONTEXT.md/ADR。 -
套用結果:
ready-for-agent— 張貼代理簡報留言(AGENT-BRIEF.md)。ready-for-human— 結構與代理簡報相同,但說明為何無法委派(判斷問題、外部權限、設計決策、手動測試)。needs-info— 張貼分類註記(範本如下)。wontfix(錯誤) — 禮貌解釋後關閉。wontfix(增強) — 寫入.out-of-scope/,從留言中連結到該檔案,然後關閉(OUT-OF-SCOPE.md)。needs-triage— 套用角色。可選擇性地留言,若有部分進度。
快速狀態覆寫
若維護者說「將 #42 移至 ready-for-agent」,請相信他們並直接套用角色。確認你即將執行的操作(角色變更、留言、關閉),然後行動。跳過追問階段。若移動到 ready-for-agent 但未經追問,請詢問他們是否要撰寫代理簡報。
需要資訊範本
## 分類註記
**目前已確立的內容:**
- 要點 1
- 要點 2
**我們仍需要你(@reporter)提供的事項:**
- 問題 1
- 問題 2
將追問過程中解決的所有事項記錄在「目前已確立的內容」下方,以免工作遺失。問題必須具體且可操作,而非「請提供更多資訊」。
恢復先前的工作階段
若議題上已有先前的分類註記,請閱讀它們,檢查回報者是否已回答任何待解決問題,並在繼續之前呈現更新後的狀況。不要重複詢問已解決的問題。