[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7A7XCKGTAD7JTC6WXG1JPCP":3,"skill-same:01M7A7XCKGTAD7JTC6WXG1JPCP":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":44},"01M7A7XCKGTAD7JTC6WXG1JPCP","triage",null,"讓 issues 與外部 PR 穿過分診角色的狀態機——分類、驗證、視需要 grill，並撰寫可供代理使用的簡報。","shumingyang-opencode\u002Fmattpocock-skills-zh-tw","shumingyang-opencode","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F294675341?v=4","01M7A7W9YMJK13BRFAVYXHNQ8E","01M7A7W9ZPCQWFGCK6CD406E85",4,"MIT","https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Ftriage\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: triage\ndescription: 讓 issues 與外部 PR 穿過分診角色的狀態機——分類、驗證、視需要 grill，並撰寫可供代理使用的簡報。\ndisable-model-invocation: true\n---\n\n# 分診\n\n在專案 Issue 追蹤器上，讓 issues 穿過由分診角色構成的小型狀態機。\n\n如果這個 repo 把外部 pull requests 視為請求介面（見 issue-tracker 設定），分診也涵蓋它們：**PR 就是附帶程式碼的 issue**——相同的角色、相同的狀態、相同的機器，只有下面標註「for a PR」的幾處差異。依追蹤器設定，把孤伶伶的 `#42` 解析成 issue 或 PR。\n\n分診期間貼到 Issue 追蹤器上的每一則評論或 issue，都**必須**以此免責聲明開頭：\n\n```\n> *This was generated by AI during triage.*\n```\n\n## 參考文件\n\n- [AGENT-BRIEF.md](AGENT-BRIEF.md) — 如何撰寫耐用的代理簡報\n- [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) — `.out-of-scope\u002F` 知識庫如何運作\n\n## 角色\n\n兩個**類別**角色：\n\n- `bug` — 有東西壞了\n- `enhancement` — 新功能或改善\n\n五個**狀態**角色：\n\n- `needs-triage` — 需要維護者評估\n- `needs-info` — 等待報告人提供更多資訊\n- `ready-for-agent` — 規格完整，可供 AFK 代理使用\n- `ready-for-human` — 需要人類實作\n- `wontfix` — 不會處理\n\n對 PR 而言，相同的狀態要對照附帶的程式碼來解讀：`ready-for-agent` 表示已附上簡報，代理應該在 diff 上採取下一步；`ready-for-human` 表示已準備好由人類合併。\n\n每個已分診的 issue 都應該正好帶一個類別角色和一個狀態角色。如果狀態角色互相衝突，先標註出來並詢問維護者，再做任何其他事。\n\n這些是正式的角色名稱——Issue 追蹤器實際使用的標籤字串可能不同。這個對應關係應該已經提供給你——如果沒有，執行 `\u002Fsetup-matt-pocock-skills`。\n\n狀態轉移：未加標籤的 issue 通常先進入 `needs-triage`；從那裡移到 `needs-info`、`ready-for-agent`、`ready-for-human` 或 `wontfix`。一旦報告人回覆，`needs-info` 就會回到 `needs-triage`。維護者隨時可以推翻——把看起來不尋常的轉移標註出來，並在繼續前詢問。\n\n## 叫用\n\n維護者叫用 `\u002Ftriage` 並以自然語言描述他們想要什麼。解讀請求並採取行動。例如：\n\n- 「讓我看任何需要我注意的內容」\n- 「我們來看一下 #42」（issue 或 PR）\n- 「把 #42 移到 ready-for-agent」\n- 「有哪些是代理可以接手的？」\n\n## 顯示需要關注的內容\n\n查詢 Issue 追蹤器，呈現三個類別，最舊的優先：\n\n1. **未加標籤** — 從未分診。\n2. **`needs-triage`** — 評估進行中。\n3. **自上次分診筆記以來有報告人活動的 `needs-info`** — 需要重新評估。\n\n當 PR 在範圍內時，把外部 PR 納入這些類別，並為每一行標上 `[PR]` 或 `[issue]`。探索只會浮現*外部* PR（追蹤器設定會定義誰算是外部）——協作者進行中的 PR 不是分診工作。這個過濾只影響探索；被明確點名的 PR，無論作者是誰都會被分診。\n\n顯示每個項目的數量與一行摘要。讓維護者挑選。\n\n## 分診特定的 issue 或 PR\n\n1. **收集上下文。** 讀取完整的 issue 或 PR（內文、評論、標籤、作者、日期；若是 PR，還包括 diff）。解析任何先前的分診筆記，這樣你就不會重問已經解決的問題。使用專案的領域詞彙表探索程式碼庫，並尊重該區域的 ADR。對程式碼庫執行兩項檢查：(a) **冗餘**——依領域概念（不只是請求的措辭）搜尋是否已有既有實作，並回報你查過哪裡。如果找到，它就是一項已實作的 `wontfix`（步驟 5）。(b) **先前拒絕**——讀取 `.out-of-scope\u002F*.md`，浮現任何與此請求相似的內容。\n\n2. **建議。** 告訴維護者你的類別與狀態建議及理由，外加與此請求相關的簡短程式碼庫摘要——包括它是否已實作。等待指示。\n\n3. **驗證主張。** 在任何 grilling 之前，先檢查主張是否成立。對 bug，依報告人的步驟重現它。對 PR，確認 diff 做到它所宣稱的事——把它 checkout 出來，執行相關的測試或指令。回報發生的事：已確認（附程式碼路徑）、失敗，或細節不足（一個強烈的 `needs-info` 訊號）。已確認的驗證會讓代理簡報強上許多。\n\n4. **Grill（如果需要）。** 如果請求需要充實內容，就一起運行 `\u002Fgrilling` 與 `\u002Fdomain-modeling` 技能——一輪一輪地問問題，把它 grill 成型，磨利領域術語，並在決策落定時就地更新 `GLOSSARY.md`\u002FADR。\n\n5. **套用結果：**\n   - `ready-for-agent` — 貼上代理簡報評論（[AGENT-BRIEF.md](AGENT-BRIEF.md)）。\n   - `ready-for-human` — 結構與代理簡報相同，但要註明為什麼無法委派（需要判斷、外部存取、設計決策、手動測試）。\n   - `needs-info` — 貼上分診筆記（見下方範本）。\n   - `wontfix` — 關閉，評論依*原因*而定：\n     - **已實作** — 這項變更已存在於程式碼庫。指出它在哪裡；**不要**寫入 `.out-of-scope\u002F`（那個知識庫是給*被拒絕*的請求，不是給已建置的）。\n     - **拒絕（bug）** — 有禮貌地說明，然後關閉。\n     - **拒絕（enhancement）** — 寫入 `.out-of-scope\u002F`，在評論中連結它，然後關閉（[OUT-OF-SCOPE.md](OUT-OF-SCOPE.md)）。\n   - `needs-triage` — 套用角色。如果已有部分進展，可選擇加上評論。\n\n## 快速狀態覆寫\n\n如果維護者說「把 #42 移到 ready-for-agent」，相信他們並直接套用角色。先確認你即將做的事（角色變更、評論、關閉），然後行動。跳過 grilling。如果在沒有 grilling session 的情況下移到 `ready-for-agent`，詢問他們是否要撰寫代理簡報。\n\n## Needs-info 範本\n\n```markdown\n## Triage Notes\n\n**What we've established so far:**\n\n- point 1\n- point 2\n\n**What we still need from you (@reporter):**\n\n- question 1\n- question 2\n```\n\n把 grilling 期間解決的一切記在「已確立內容」之下，這樣工作才不會遺失。問題必須具體且可執行，而不是「請提供更多資訊」。\n\n## 恢復先前的 session\n\n如果 issue 或 PR 上已有先前的分診筆記，讀取它們，檢查報告人是否已回答任何未決問題，並在繼續前呈現更新後的全貌。不要重問已解決的問題。\n","# 分診\n\n在專案 Issue 追蹤器上，讓 issues 穿過由分診角色構成的小型狀態機。\n\n如果這個 repo 把外部 pull requests 視為請求介面（見 issue-tracker 設定），分診也涵蓋它們：**PR 就是附帶程式碼的 issue**——相同的角色、相同的狀態、相同的機器，只有下面標註「for a PR」的幾處差異。依追蹤器設定，把孤伶伶的 `#42` 解析成 issue 或 PR。\n\n分診期間貼到 Issue 追蹤器上的每一則評論或 issue，都**必須**以此免責聲明開頭：\n\n```\n> *This was generated by AI during triage.*\n```\n\n## 參考文件\n\n- [AGENT-BRIEF.md](AGENT-BRIEF.md) — 如何撰寫耐用的代理簡報\n- [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) — `.out-of-scope\u002F` 知識庫如何運作\n\n## 角色\n\n兩個**類別**角色：\n\n- `bug` — 有東西壞了\n- `enhancement` — 新功能或改善\n\n五個**狀態**角色：\n\n- `needs-triage` — 需要維護者評估\n- `needs-info` — 等待報告人提供更多資訊\n- `ready-for-agent` — 規格完整，可供 AFK 代理使用\n- `ready-for-human` — 需要人類實作\n- `wontfix` — 不會處理\n\n對 PR 而言，相同的狀態要對照附帶的程式碼來解讀：`ready-for-agent` 表示已附上簡報，代理應該在 diff 上採取下一步；`ready-for-human` 表示已準備好由人類合併。\n\n每個已分診的 issue 都應該正好帶一個類別角色和一個狀態角色。如果狀態角色互相衝突，先標註出來並詢問維護者，再做任何其他事。\n\n這些是正式的角色名稱——Issue 追蹤器實際使用的標籤字串可能不同。這個對應關係應該已經提供給你——如果沒有，執行 `\u002Fsetup-matt-pocock-skills`。\n\n狀態轉移：未加標籤的 issue 通常先進入 `needs-triage`；從那裡移到 `needs-info`、`ready-for-agent`、`ready-for-human` 或 `wontfix`。一旦報告人回覆，`needs-info` 就會回到 `needs-triage`。維護者隨時可以推翻——把看起來不尋常的轉移標註出來，並在繼續前詢問。\n\n## 叫用\n\n維護者叫用 `\u002Ftriage` 並以自然語言描述他們想要什麼。解讀請求並採取行動。例如：\n\n- 「讓我看任何需要我注意的內容」\n- 「我們來看一下 #42」（issue 或 PR）\n- 「把 #42 移到 ready-for-agent」\n- 「有哪些是代理可以接手的？」\n\n## 顯示需要關注的內容\n\n查詢 Issue 追蹤器，呈現三個類別，最舊的優先：\n\n1. **未加標籤** — 從未分診。\n2. **`needs-triage`** — 評估進行中。\n3. **自上次分診筆記以來有報告人活動的 `needs-info`** — 需要重新評估。\n\n當 PR 在範圍內時，把外部 PR 納入這些類別，並為每一行標上 `[PR]` 或 `[issue]`。探索只會浮現*外部* PR（追蹤器設定會定義誰算是外部）——協作者進行中的 PR 不是分診工作。這個過濾只影響探索；被明確點名的 PR，無論作者是誰都會被分診。\n\n顯示每個項目的數量與一行摘要。讓維護者挑選。\n\n## 分診特定的 issue 或 PR\n\n1. **收集上下文。** 讀取完整的 issue 或 PR（內文、評論、標籤、作者、日期；若是 PR，還包括 diff）。解析任何先前的分診筆記，這樣你就不會重問已經解決的問題。使用專案的領域詞彙表探索程式碼庫，並尊重該區域的 ADR。對程式碼庫執行兩項檢查：(a) **冗餘**——依領域概念（不只是請求的措辭）搜尋是否已有既有實作，並回報你查過哪裡。如果找到，它就是一項已實作的 `wontfix`（步驟 5）。(b) **先前拒絕**——讀取 `.out-of-scope\u002F*.md`，浮現任何與此請求相似的內容。\n\n2. **建議。** 告訴維護者你的類別與狀態建議及理由，外加與此請求相關的簡短程式碼庫摘要——包括它是否已實作。等待指示。\n\n3. **驗證主張。** 在任何 grilling 之前，先檢查主張是否成立。對 bug，依報告人的步驟重現它。對 PR，確認 diff 做到它所宣稱的事——把它 checkout 出來，執行相關的測試或指令。回報發生的事：已確認（附程式碼路徑）、失敗，或細節不足（一個強烈的 `needs-info` 訊號）。已確認的驗證會讓代理簡報強上許多。\n\n4. **Grill（如果需要）。** 如果請求需要充實內容，就一起運行 `\u002Fgrilling` 與 `\u002Fdomain-modeling` 技能——一輪一輪地問問題，把它 grill 成型，磨利領域術語，並在決策落定時就地更新 `GLOSSARY.md`\u002FADR。\n\n5. **套用結果：**\n   - `ready-for-agent` — 貼上代理簡報評論（[AGENT-BRIEF.md](AGENT-BRIEF.md)）。\n   - `ready-for-human` — 結構與代理簡報相同，但要註明為什麼無法委派（需要判斷、外部存取、設計決策、手動測試）。\n   - `needs-info` — 貼上分診筆記（見下方範本）。\n   - `wontfix` — 關閉，評論依*原因*而定：\n     - **已實作** — 這項變更已存在於程式碼庫。指出它在哪裡；**不要**寫入 `.out-of-scope\u002F`（那個知識庫是給*被拒絕*的請求，不是給已建置的）。\n     - **拒絕（bug）** — 有禮貌地說明，然後關閉。\n     - **拒絕（enhancement）** — 寫入 `.out-of-scope\u002F`，在評論中連結它，然後關閉（[OUT-OF-SCOPE.md](OUT-OF-SCOPE.md)）。\n   - `needs-triage` — 套用角色。如果已有部分進展，可選擇加上評論。\n\n## 快速狀態覆寫\n\n如果維護者說「把 #42 移到 ready-for-agent」，相信他們並直接套用角色。先確認你即將做的事（角色變更、評論、關閉），然後行動。跳過 grilling。如果在沒有 grilling session 的情況下移到 `ready-for-agent`，詢問他們是否要撰寫代理簡報。\n\n## Needs-info 範本\n\n```markdown\n## Triage Notes\n\n**What we've established so far:**\n\n- point 1\n- point 2\n\n**What we still need from you (@reporter):**\n\n- question 1\n- question 2\n```\n\n把 grilling 期間解決的一切記在「已確立內容」之下，這樣工作才不會遺失。問題必須具體且可執行，而不是「請提供更多資訊」。\n\n## 恢復先前的 session\n\n如果 issue 或 PR 上已有先前的分診筆記，讀取它們，檢查報告人是否已回答任何未決問題，並在繼續前呈現更新後的全貌。不要重問已解決的問題。\n",{"name":5,"description":7,"disable-model-invocation":23},true,"main","a35116c519fa3558e67613450c180c1d11b11384","skills\u002Fengineering\u002Ftriage",0,"https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw","https:\u002F\u002Fshumingyang-opencode.github.io\u002Fmattpocock-skills-zh-tw\u002F","https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode","2026-11-01 10:48:03",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":23},[34,37,40],{"tool":35,"command":36},"npx","npx skills add shumingyang-opencode\u002Fmattpocock-skills-zh-tw --skill triage",{"tool":38,"command":39},"bunx","bunx skills add shumingyang-opencode\u002Fmattpocock-skills-zh-tw --skill triage",{"tool":41,"command":42},"pnpm","pnpm dlx skills add shumingyang-opencode\u002Fmattpocock-skills-zh-tw --skill triage","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Ftriage\u002FSKILL.md",[45,51,55],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"AGENT-BRIEF.md","REFERENCE","参考文档",7804,"https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Ftriage\u002FAGENT-BRIEF.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"agents\u002Fopenai.yaml",135,"https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Ftriage\u002Fagents\u002Fopenai.yaml",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"OUT-OF-SCOPE.md",4473,"https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Ftriage\u002FOUT-OF-SCOPE.md",[60,67,74,81,88,95],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M7A7YRX0D4MQN8XT9HEW1VMV","writing-for-agents","為代理撰寫文件。建立或編輯技能，或修改 AGENTS.md 或 CLAUDE.md 時使用。","https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7A7YQ9V1T7ZH5SZMCHQ46BN","wait-what","停下。上一則訊息沒有被理解 — 重新闡述它。","https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M7A7YMXF75HMK1B289SEWJ47","to-questionnaire","將一個您無法完全回答的決策轉化為一份由他人填寫的問卷。","https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M7A7YJ8X7N7D4K8NRYK81YN2","teach","在此工作區內教導使用者一項新技能或概念。","https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M7A7YF1CWWC8G42FJQTPFP4J","handoff","將目前的對話壓縮成一份交接文件，讓另一個代理接手。","https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M7A7YD77FWSKDWPQP2GRCQ13","grilling","持續質詢使用者關於一項計畫、決策或想法。當使用者想要壓力測試自己的想法，或使用任何「grill」觸發詞時使用。","https:\u002F\u002Fgithub.com\u002Fshumingyang-opencode\u002Fmattpocock-skills-zh-tw\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[]]