[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ARJBAPXS9HAHSKX7NNHXS9":3,"skill-same:01M7ARJBAPXS9HAHSKX7NNHXS9":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":32,"updatedAt":33,"install":34,"resources":46},"01M7ARJBAPXS9HAHSKX7NNHXS9","triage",null,"让议题与外部 PR 走过一台由分诊角色组成的状态机：分类、核实、必要时盘问，最后写出代理可以直接上手的简报。","FeatherHunter\u002Fdsh-mattpocock-skills-deck","FeatherHunter","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12967785?v=4","01M71JFD7JMNT8HWC3Y9JKMWGG","王辰浩","01M7ARGR9XSH26AXVRCDJYP6T5",363,"MIT","https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck\u002Fblob\u002Fmain\u002Fpackage\u002Fbundled-skills-zh\u002Ftriage\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: triage\ndescription: 让议题与外部 PR 走过一台由分诊角色组成的状态机：分类、核实、必要时盘问，最后写出代理可以直接上手的简报。\ndisable-model-invocation: true\n---\n\n# 分诊\n\n让项目议题跟踪器上的议题走过一台由分诊角色构成的小状态机。\n\n如果这个仓库把外部 PR 也当作一种请求入口（见 issue-tracker 配置），分诊也要管它们：**一个 PR 就是一份附带代码的议题**，用的是同一套角色、同一批状态、同一台状态机，只有少数差异，下面用「对 PR 而言」标出。遇到一个单独的 `#42`，按跟踪器配置判断它指议题还是 PR。\n\n分诊期间发到议题跟踪器上的每一条评论或议题，开头**必须**是这段免责声明：\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每一份分诊过的议题都应当恰好带一个类别角色和一个状态角色。如果状态角色互相冲突，先把冲突标出来，问过维护者之后再做别的。\n\n这些是角色的规范名称。议题跟踪器里实际使用的标签字符串可能不同。这份对照关系应该已经提供给你了。如果没有，请告诉用户运行 `\u002Fsetup-matt-pocock-skills`。\n\n状态流转：没有标签的议题通常先进入 `needs-triage`；从那里出发，它可以走到 `needs-info`、`ready-for-agent`、`ready-for-human` 或 `wontfix`。报告者回复之后，`needs-info` 回到 `needs-triage`。维护者随时可以覆盖这些判断；遇到看起来不寻常的流转，先标出来、问过之后再做。\n\n## 调用方式\n\n维护者调用 `\u002Ftriage`，用自然语言说明他们想要什么。理解这个请求并动手。例子：\n\n- 「给我看看有什么需要我处理的」\n- 「我们来看看 #42」（议题或 PR）\n- 「把 #42 移到 ready-for-agent」\n- 「有什么是代理可以接手的？」\n\n## 展示需要关注的事项\n\n查询议题跟踪器，分成三堆呈现，最老的排在前面：\n\n1. **没有标签**：从未分诊过。\n2. **`needs-triage`**：正在评估中。\n3. **自上一条分诊备注以来报告者有活动的 `needs-info`**：需要重新评估。\n\n当 PR 也在范围内时，把外部 PR 也放进这三堆，并给每一行标上 `[PR]` 或 `[issue]`。发现环节只会挑出*外部* PR（谁算外部由跟踪器配置定义），所以协作者正在推进的 PR 不算分诊工作。这个过滤只用于发现环节；被明确点名的 PR，无论作者是谁都要分诊。\n\n给出每一组的数量，以及每一项的一行摘要。让维护者来挑。\n\n## 分诊某个具体的议题或 PR\n\n1. **收集上下文。** 读完整的议题或 PR（正文、评论、标签、作者、日期；如果是 PR，还要读 diff）。解析此前的分诊备注，避免重复问已经解决的问题。用项目的领域词汇表探索代码库，并遵守该领域的 ADR。对代码库跑两项检查：(a) **重复实现**：按领域概念（而不只是请求里的措辞）搜索所要求的行为是否已经有实现，并报告你找过哪些地方。如果找到，它就是一个已经实现的 `wontfix`（见第 5 步）。(b) **先前已被否决**：读 `.out-of-scope\u002F*.md`，把任何与这个请求相似的条目摆出来。\n\n2. **给出建议。** 告诉维护者你建议的类别与状态并说明理由，另外附一小段与请求相关的代码库概况（包括它是否已经实现）。等待指示。\n\n3. **核实说法。** 在任何盘问之前，先检查这个说法站不站得住。如果是 bug，按报告者的步骤复现它。如果是 PR，确认这份 diff 确实做到了它声称的事：把它检出，跑相关的测试或命令。报告结果：核实成立（附代码路径）、核实不成立，还是细节不足（这是要 `needs-info` 的强信号）。核实通过能让代理简报有力得多。\n\n4. **盘问（如果需要）。** 如果这个请求还需要展开，就调用 Skill 工具两次，分别传入 \"grilling\" 和 \"domain-modeling\"，一轮一轮地问，把它盘问成型；每当有决定定下来，就顺手打磨领域术语、就地更新 `GLOSSARY.md`／ADR。\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」，就相信他们，直接打上这个角色。先确认你打算做什么（改角色、发评论、关闭），然后动手。跳过盘问。如果要在没有盘问环节的情况下移到 `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盘问期间解决掉的一切，都要记到模板里 `What we've established so far`（目前已经确定）那一节下面，别让这些工作丢掉。问题必须具体、可执行，不能只是「请提供更多信息」。\n\n## 恢复此前的会话\n\n如果议题或 PR 上已有此前的分诊备注，读它们，检查报告者是否已经回答了悬而未决的问题，并先呈现一幅更新过的图景，再继续往下做。已经解决的问题不要重复问。\n","# 分诊\n\n让项目议题跟踪器上的议题走过一台由分诊角色构成的小状态机。\n\n如果这个仓库把外部 PR 也当作一种请求入口（见 issue-tracker 配置），分诊也要管它们：**一个 PR 就是一份附带代码的议题**，用的是同一套角色、同一批状态、同一台状态机，只有少数差异，下面用「对 PR 而言」标出。遇到一个单独的 `#42`，按跟踪器配置判断它指议题还是 PR。\n\n分诊期间发到议题跟踪器上的每一条评论或议题，开头**必须**是这段免责声明：\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每一份分诊过的议题都应当恰好带一个类别角色和一个状态角色。如果状态角色互相冲突，先把冲突标出来，问过维护者之后再做别的。\n\n这些是角色的规范名称。议题跟踪器里实际使用的标签字符串可能不同。这份对照关系应该已经提供给你了。如果没有，请告诉用户运行 `\u002Fsetup-matt-pocock-skills`。\n\n状态流转：没有标签的议题通常先进入 `needs-triage`；从那里出发，它可以走到 `needs-info`、`ready-for-agent`、`ready-for-human` 或 `wontfix`。报告者回复之后，`needs-info` 回到 `needs-triage`。维护者随时可以覆盖这些判断；遇到看起来不寻常的流转，先标出来、问过之后再做。\n\n## 调用方式\n\n维护者调用 `\u002Ftriage`，用自然语言说明他们想要什么。理解这个请求并动手。例子：\n\n- 「给我看看有什么需要我处理的」\n- 「我们来看看 #42」（议题或 PR）\n- 「把 #42 移到 ready-for-agent」\n- 「有什么是代理可以接手的？」\n\n## 展示需要关注的事项\n\n查询议题跟踪器，分成三堆呈现，最老的排在前面：\n\n1. **没有标签**：从未分诊过。\n2. **`needs-triage`**：正在评估中。\n3. **自上一条分诊备注以来报告者有活动的 `needs-info`**：需要重新评估。\n\n当 PR 也在范围内时，把外部 PR 也放进这三堆，并给每一行标上 `[PR]` 或 `[issue]`。发现环节只会挑出*外部* PR（谁算外部由跟踪器配置定义），所以协作者正在推进的 PR 不算分诊工作。这个过滤只用于发现环节；被明确点名的 PR，无论作者是谁都要分诊。\n\n给出每一组的数量，以及每一项的一行摘要。让维护者来挑。\n\n## 分诊某个具体的议题或 PR\n\n1. **收集上下文。** 读完整的议题或 PR（正文、评论、标签、作者、日期；如果是 PR，还要读 diff）。解析此前的分诊备注，避免重复问已经解决的问题。用项目的领域词汇表探索代码库，并遵守该领域的 ADR。对代码库跑两项检查：(a) **重复实现**：按领域概念（而不只是请求里的措辞）搜索所要求的行为是否已经有实现，并报告你找过哪些地方。如果找到，它就是一个已经实现的 `wontfix`（见第 5 步）。(b) **先前已被否决**：读 `.out-of-scope\u002F*.md`，把任何与这个请求相似的条目摆出来。\n\n2. **给出建议。** 告诉维护者你建议的类别与状态并说明理由，另外附一小段与请求相关的代码库概况（包括它是否已经实现）。等待指示。\n\n3. **核实说法。** 在任何盘问之前，先检查这个说法站不站得住。如果是 bug，按报告者的步骤复现它。如果是 PR，确认这份 diff 确实做到了它声称的事：把它检出，跑相关的测试或命令。报告结果：核实成立（附代码路径）、核实不成立，还是细节不足（这是要 `needs-info` 的强信号）。核实通过能让代理简报有力得多。\n\n4. **盘问（如果需要）。** 如果这个请求还需要展开，就调用 Skill 工具两次，分别传入 \"grilling\" 和 \"domain-modeling\"，一轮一轮地问，把它盘问成型；每当有决定定下来，就顺手打磨领域术语、就地更新 `GLOSSARY.md`／ADR。\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」，就相信他们，直接打上这个角色。先确认你打算做什么（改角色、发评论、关闭），然后动手。跳过盘问。如果要在没有盘问环节的情况下移到 `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盘问期间解决掉的一切，都要记到模板里 `What we've established so far`（目前已经确定）那一节下面，别让这些工作丢掉。问题必须具体、可执行，不能只是「请提供更多信息」。\n\n## 恢复此前的会话\n\n如果议题或 PR 上已有此前的分诊备注，读它们，检查报告者是否已经回答了悬而未决的问题，并先呈现一幅更新过的图景，再继续往下做。已经解决的问题不要重复问。\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","5b4d78f3b2f70a7de1743ddf59b1999330daa1d1","package\u002Fbundled-skills-zh\u002Ftriage",33,"https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck","https:\u002F\u002Ffeatherhunter.github.io\u002Fdsh-mattpocock-skills-deck\u002Farchitecture\u002FMattSkills-architecture.html","https:\u002F\u002Fgithub.com\u002FFeatherHunter","The Boy, The Man, The Human.","2026-11-14 17:21:39",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":24},[36,39,42],{"tool":37,"command":38},"npx","npx skills add FeatherHunter\u002Fdsh-mattpocock-skills-deck --skill triage",{"tool":40,"command":41},"bunx","bunx skills add FeatherHunter\u002Fdsh-mattpocock-skills-deck --skill triage",{"tool":43,"command":44},"pnpm","pnpm dlx skills add FeatherHunter\u002Fdsh-mattpocock-skills-deck --skill triage","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck\u002Fblob\u002Fmain\u002Fpackage\u002Fbundled-skills-zh\u002Ftriage\u002FSKILL.md",[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"AGENT-BRIEF.md","REFERENCE","参考文档",7813,"https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck\u002Fblob\u002Fmain\u002Fpackage\u002Fbundled-skills-zh\u002Ftriage\u002FAGENT-BRIEF.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"OUT-OF-SCOPE.md",4615,"https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck\u002Fblob\u002Fmain\u002Fpackage\u002Fbundled-skills-zh\u002Ftriage\u002FOUT-OF-SCOPE.md",[58,65,72,79,86,92],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7ARN2HT5PJ948V8V1X6AE2P","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck\u002Fblob\u002Fmain\u002Fpackage\u002Fbundled-skills\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M7ARMY0H53GWTKKDWEFW38H7","wizard","Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.","https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck\u002Fblob\u002Fmain\u002Fpackage\u002Fbundled-skills\u002Fwizard\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7ARMTZHMWQCM1VN87EFKHYF","wayfinder","Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.","https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck\u002Fblob\u002Fmain\u002Fpackage\u002Fbundled-skills\u002Fwayfinder\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7ARMS9JVG5BJSAGBZCYFEJV","wait-what","Stop. That last message did not land: re-pitch it.","https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck\u002Fblob\u002Fmain\u002Fpackage\u002Fbundled-skills\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":87,"name":5,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7ARMPH1T621Q493BRNJA4M9","Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.","https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck\u002Fblob\u002Fmain\u002Fpackage\u002Fbundled-skills\u002Ftriage\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7ARMJ9YHKAQQ9Z2WSQ5Y9VK","to-tickets","Break a plan, spec, or the current conversation into a set of tracer-bullet tickets, each declaring its blocking edges, published to the configured tracker (edges as text in one file per ticket locally, or native blocking links on a real tracker).","https:\u002F\u002Fgithub.com\u002FFeatherHunter\u002Fdsh-mattpocock-skills-deck\u002Fblob\u002Fmain\u002Fpackage\u002Fbundled-skills\u002Fto-tickets\u002FSKILL.md",[],[]]