triagelisted

# 分診 在專案 Issue 追蹤器上，讓 issues 穿過由分診角色構成的小型狀態機。 如果這個 repo 把外部 pull requests 視為請求介面（見 issue-tracker 設定），分診也涵蓋它們：**PR 就是附帶程式碼的 issue**——相同的角色、相同的狀態、相同的機器，只有下面標註「for a PR」的幾處差異。依追蹤器設定，把孤伶伶的 `#42` 解析成 issue 或 PR。 分診期間貼到 Issue 追蹤器上的每一則評論或 issue，都**必須**以此免責聲明開頭： ``` > *This was generated by AI during triage.* ``` ## 參考文件 - [AGENT-BRIEF.md](AGENT-BRIEF.md) — 如何撰寫耐用的代理簡報 - [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) — `.out-of-scope/` 知識庫如何運作 ## 角色 兩個**類別**角色： - `bug` — 有東西壞了 - `enhancement` — 新功能或改善 五個**狀態**角色： - `needs-triage` — 需要維護者評估 - `needs-info` — 等待報告人提供更多資訊 - `ready-for-agent` — 規格完整，可供 AFK 代理使用 - `ready-for-human` — 需要人類實作 - `wontfix` — 不會處理 對 PR 而言，相同的狀態要對照附帶的程式碼來解讀：`ready-for-agent` 表示已附上簡報，代理應該在 diff 上採取下一步；`ready-for-human` 表示已準備好由人類合併。 每個已分診的 issue 都應該正好帶一個類別角色和一個狀態角色。如果狀態角色互相衝突，先標註出來並詢問維護者，再做任何其他事。 這些是正式的角色名稱——Issue 追蹤器實際使用的標籤字串可能不同。這個對應關係應該已經提供給你——如果沒有，執行 `/setup-matt-pocock-skills`。 狀態轉移：未加標籤的 issue 通常先進入 `needs-triage`；從那裡移到 `needs-info`、`ready-for-agent`、`ready-for-human` 或 `wontfix`。一旦報告人回覆，`needs-info` 就會回到 `needs-triage`。維護者隨時可以推翻——把看起來不尋常的轉移標註出來，並在繼續前詢問。 ## 叫用 維護者叫用 `/triage` 並以自然語言描述他們想要什麼。解讀請求並採取行動。例如： - 「讓我看任何需要我注意的內容」 - 「我們來看一下 #42」（issue 或 PR） - 「把 #42 移到 ready-for-agent」 - 「有哪些是代理可以接手的？」 ## 顯示需要關注的內容 查詢 Issue 追蹤器，呈現三個類別，最舊的優先： 1. **未加標籤** — 從未分診。 2. **`needs-triage`** — 評估進行中。 3. **自上次分診筆記以來有報告人活動的 `needs-info`** — 需要重新評估。 當 PR 在範圍內時，把外部 PR 納入這些類別，並為每一行標上 `[PR]` 或 `[issue]`。探索只會浮現*外部* PR（追蹤器設定會定義誰算是外部）——協作者進行中的 PR 不是分診工作。這個過濾只影響探索；被明確點名的 PR，無