[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75MGXF1J907PFRW8JCBYVTZ":3,"skill-same:01M75MGXF1J907PFRW8JCBYVTZ":59},{"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":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":44},"01M75MGXF1J907PFRW8JCBYVTZ","triage",null,"让工单和外部 PR 在一套分诊角色的状态机中流转——分类、验证、必要时拷问，并写出可供 agent 处理的简报。","WenWuZhiDao\u002Fmattpocock-skills-zh","WenWuZhiDao","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F34392959?v=4","01M75MFZSCVSQVNDH3CGE78NM6","WenWu","01M75MFZSWRFK0G0YZYVG5MAFG",31,"MIT","https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Ftriage\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: triage\ndescription: 让工单和外部 PR 在一套分诊角色的状态机中流转——分类、验证、必要时拷问，并写出可供 agent 处理的简报。\ndisable-model-invocation: true\n---\n\n# 分诊\n\n让项目工单跟踪器上的工单在一个小型分诊角色状态机中流转。\n\n如果这个仓库把外部 pull request 当作请求入口（见工单跟踪器配置），分诊也覆盖它们：**一个 PR 就是一个附带代码的工单**——同样的角色、同样的状态、同样的状态机，只有下面标了「对于 PR」的几处差异。按跟踪器配置把一个裸的 `#42` 解析为一个 issue 或 PR。\n\n分诊期间发布到工单跟踪器的每一条评论或工单**都必须**以这条免责声明开头：\n\n```\n> *This was generated by AI during triage.*\n```\n\n## 参考文档\n\n- [AGENT-BRIEF.md](AGENT-BRIEF.md) — 如何写出经久耐用的 agent 简报\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 agent 处理\n- `ready-for-human` — 需要人类实现\n- `wontfix` — 不会被处理\n\n对于一个 PR，同样的状态是针对附带的代码来读的：`ready-for-agent` 意思是简报已附上、一个 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」（issue 或 PR）\n- 「把 #42 移到 ready-for-agent」\n- 「有什么是准备好给 agent 领取的？」\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## 分诊一个具体的 issue 或 PR\n\n1. **收集上下文。** 读完整的 issue 或 PR（正文、评论、标签、作者、日期；对于 PR，还有 diff）。解析任何先前的分诊笔记，这样你不会重新问已解决的问题。用项目的领域词汇表探索代码库，尊重该区域里的 ADR。对代码库做两项检查：(a) **冗余**——按领域概念（不只是请求的措辞）搜索所请求行为的现有实现，并报告你查过哪里。如果找到，那就是一个已实现的 `wontfix`（第 5 步）。(b) **先前的拒绝**——读 `.out-of-scope\u002F*.md` 并浮现任何与这个请求相似的。\n\n2. **推荐。** 带上你的理由，把你的分类和状态推荐告诉维护者，外加一段与请求相关的简短代码库摘要——包括它是否已经实现。等待指示。\n\n3. **验证声称。** 在任何拷问之前，检查这个声称是否站得住脚。对于一个 bug，从报告者的步骤复现它。对于一个 PR，确认 diff 做了它声称的事——check out 它，运行相关的测试或命令。报告发生了什么：已确认（附代码路径）、失败，或细节不足（一个强烈的 `needs-info` 信号）。一次已确认的验证会造就一份强得多的 agent 简报。\n\n4. **拷问（如需）。** 如果请求需要充实，就一起运行 `\u002Fgrilling` 和 `\u002Fdomain-modeling` 技能——一次一轮问题地把它拷问成型，磨锐领域术语，并在决策落地时就地更新 `CONTEXT.md`\u002FADR。\n\n5. **应用结果：**\n   - `ready-for-agent` — 发一条 agent 简报评论（[AGENT-BRIEF.md](AGENT-BRIEF.md)）。\n   - `ready-for-human` — 与 agent 简报同样的结构，但注明为什么它不能被委派（判断题、外部访问、设计决策、手动测试）。\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`，问一句他们是否想写一份 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把拷问期间解决的一切都记在「established so far」下，这样工作不会丢失。问题必须具体、可行动，而不是「请提供更多信息」。\n\n## 恢复一个先前的会话\n\n如果 issue 或 PR 上存在先前的分诊笔记，读它们，检查报告者是否回答了任何悬而未决的问题，并在继续前呈现一幅更新后的图景。不要重新问已解决的问题。\n","# 分诊\n\n让项目工单跟踪器上的工单在一个小型分诊角色状态机中流转。\n\n如果这个仓库把外部 pull request 当作请求入口（见工单跟踪器配置），分诊也覆盖它们：**一个 PR 就是一个附带代码的工单**——同样的角色、同样的状态、同样的状态机，只有下面标了「对于 PR」的几处差异。按跟踪器配置把一个裸的 `#42` 解析为一个 issue 或 PR。\n\n分诊期间发布到工单跟踪器的每一条评论或工单**都必须**以这条免责声明开头：\n\n```\n> *This was generated by AI during triage.*\n```\n\n## 参考文档\n\n- [AGENT-BRIEF.md](AGENT-BRIEF.md) — 如何写出经久耐用的 agent 简报\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 agent 处理\n- `ready-for-human` — 需要人类实现\n- `wontfix` — 不会被处理\n\n对于一个 PR，同样的状态是针对附带的代码来读的：`ready-for-agent` 意思是简报已附上、一个 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」（issue 或 PR）\n- 「把 #42 移到 ready-for-agent」\n- 「有什么是准备好给 agent 领取的？」\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## 分诊一个具体的 issue 或 PR\n\n1. **收集上下文。** 读完整的 issue 或 PR（正文、评论、标签、作者、日期；对于 PR，还有 diff）。解析任何先前的分诊笔记，这样你不会重新问已解决的问题。用项目的领域词汇表探索代码库，尊重该区域里的 ADR。对代码库做两项检查：(a) **冗余**——按领域概念（不只是请求的措辞）搜索所请求行为的现有实现，并报告你查过哪里。如果找到，那就是一个已实现的 `wontfix`（第 5 步）。(b) **先前的拒绝**——读 `.out-of-scope\u002F*.md` 并浮现任何与这个请求相似的。\n\n2. **推荐。** 带上你的理由，把你的分类和状态推荐告诉维护者，外加一段与请求相关的简短代码库摘要——包括它是否已经实现。等待指示。\n\n3. **验证声称。** 在任何拷问之前，检查这个声称是否站得住脚。对于一个 bug，从报告者的步骤复现它。对于一个 PR，确认 diff 做了它声称的事——check out 它，运行相关的测试或命令。报告发生了什么：已确认（附代码路径）、失败，或细节不足（一个强烈的 `needs-info` 信号）。一次已确认的验证会造就一份强得多的 agent 简报。\n\n4. **拷问（如需）。** 如果请求需要充实，就一起运行 `\u002Fgrilling` 和 `\u002Fdomain-modeling` 技能——一次一轮问题地把它拷问成型，磨锐领域术语，并在决策落地时就地更新 `CONTEXT.md`\u002FADR。\n\n5. **应用结果：**\n   - `ready-for-agent` — 发一条 agent 简报评论（[AGENT-BRIEF.md](AGENT-BRIEF.md)）。\n   - `ready-for-human` — 与 agent 简报同样的结构，但注明为什么它不能被委派（判断题、外部访问、设计决策、手动测试）。\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`，问一句他们是否想写一份 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把拷问期间解决的一切都记在「established so far」下，这样工作不会丢失。问题必须具体、可行动，而不是「请提供更多信息」。\n\n## 恢复一个先前的会话\n\n如果 issue 或 PR 上存在先前的分诊笔记，读它们，检查报告者是否回答了任何悬而未决的问题，并在继续前呈现一幅更新后的图景。不要重新问已解决的问题。\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","de7805b8878fdc859562a381dbb56a2e459261f0","skills\u002Fengineering\u002Ftriage",6,"https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh","https:\u002F\u002Fgithub.com\u002FWenWuZhiDao","2026-08-13 17:03:17",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":24},[34,37,40],{"tool":35,"command":36},"npx","npx skills add WenWuZhiDao\u002Fmattpocock-skills-zh --skill triage",{"tool":38,"command":39},"bunx","bunx skills add WenWuZhiDao\u002Fmattpocock-skills-zh --skill triage",{"tool":41,"command":42},"pnpm","pnpm dlx skills add WenWuZhiDao\u002Fmattpocock-skills-zh --skill triage","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Ftriage\u002FSKILL.md",[45,51,55],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"AGENT-BRIEF.md","REFERENCE","参考文档",7590,"https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Ftriage\u002FAGENT-BRIEF.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"agents\u002Fopenai.yaml",136,"https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Ftriage\u002Fagents\u002Fopenai.yaml",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"OUT-OF-SCOPE.md",4526,"https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\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":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M75MJZ51TKKN9N82H99PNRV0","writing-for-agents","为智能体撰写文档。当创建或编辑技能，或修改 AGENTS.md 或 CLAUDE.md 时使用。","https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\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":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M75MJX7A4F6C1MZHDDXMHCKW","wait-what","停一下。那最后一条消息没能领会——重新表述它。","https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\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":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M75MJW9N0MGTZCPJZH4Y54P4","to-questionnaire","把一个你无法完全回答的决策变成一份问卷，交给别人填写。","https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\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":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M75MJT9SN7N1GP067S662M4R","teach","在本工作区内向用户传授一项新技能或概念。","https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\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":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M75MJS8GW8BXE07J1AS6Y32V","handoff","把当前对话压缩成一份交接文档，供另一个 agent 接手。","https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\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":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M75MJQ6W6CQXWQEYTATKTSXM","grilling","就一个计划、决定或想法不留情面地拷问用户。当用户想对自己的思考做压力测试，或使用任何 'grill' 触发短语时使用。","https:\u002F\u002Fgithub.com\u002FWenWuZhiDao\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[]]