[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75MKCH8MS3YES8F5VPTS2HB":3,"skill-same:01M75MKCH8MS3YES8F5VPTS2HB":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},"01M75MKCH8MS3YES8F5VPTS2HB","triage",null,"将 issue 和外部 PR 推过一组分诊角色的状态机——分类、验证、必要时盘问，并写出 agent 就绪的任务简报。","devcxl\u002Fmattpocock-skills-zh","devcxl","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F64475363?v=4","01M75MJ7N3BE0AK24Q83ZVY13N","半颗白菜","01M75MJ7P58635MPFAW17AG3SV",541,"MIT","https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Ftriage\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: triage\ndescription: 将 issue 和外部 PR 推过一组分诊角色的状态机——分类、验证、必要时盘问，并写出 agent 就绪的任务简报。\ndisable-model-invocation: true\n---\n\n# 分类（Triage）\n\n让项目问题跟踪器上的 issue 走一遍由分类角色组成的小型状态机。\n\n如果本仓库把外部拉取请求（PR）也当作请求入口（见 issue-tracker 配置），分类也覆盖它们：**PR 就是带着代码的 issue**——同样的角色、同样的状态、同样的状态机，只有少数几处下面标注了\"仅限 PR\"的差异。根据跟踪器配置，把裸的 `#42` 解析为 issue 或 PR。\n\n分类期间发布到问题跟踪器的每条评论或 issue **必须**以这段免责声明开头：\n\n```\n> *This was generated by AI during triage.*\n```\n\n## 参考文档\n\n- [AGENT-BRIEF.md](AGENT-BRIEF.md) — 如何写出耐用的 agent brief\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` 意味着已附上 brief，agent 应该对 diff 采取下一步；`ready-for-human` 意味着已准备好由人来合并。\n\n每个经过分类的 issue 都应恰好带一个类别角色和一个状态角色。如果状态角色冲突，先标记出来并询问维护者，再做任何其他事情。\n\n这些是规范角色名——问题跟踪器中实际使用的标签字符串可能不同。映射关系应该已经提供给你了——如果没有，告诉用户运行 `\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- \"有哪些是 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 确实做了它声称的事——checkout 下来，运行相关测试或命令。报告发生了什么：已确认（附代码路径）、失败、或细节不足（强烈的 `needs-info` 信号）。确认过的验证能产生强得多的 agent brief。\n\n4. **盘问（如需）。** 如果请求需要补充打磨，调用 Skill 工具两次，分别传入 \"grilling\" 和 \"domain-modeling\"——一轮一轮地把它盘问成型，随着决策落定，同步打磨领域术语并更新 `GLOSSARY.md`\u002FADR。\n\n5. **应用结果：**\n   - `ready-for-agent` — 发布 agent brief 评论（[AGENT-BRIEF.md](AGENT-BRIEF.md)）。\n   - `ready-for-human` — 结构同 agent brief，但要注明为什么不能委派（需要判断、外部访问、设计决策、人工测试）。\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 brief。\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","# 分类（Triage）\n\n让项目问题跟踪器上的 issue 走一遍由分类角色组成的小型状态机。\n\n如果本仓库把外部拉取请求（PR）也当作请求入口（见 issue-tracker 配置），分类也覆盖它们：**PR 就是带着代码的 issue**——同样的角色、同样的状态、同样的状态机，只有少数几处下面标注了\"仅限 PR\"的差异。根据跟踪器配置，把裸的 `#42` 解析为 issue 或 PR。\n\n分类期间发布到问题跟踪器的每条评论或 issue **必须**以这段免责声明开头：\n\n```\n> *This was generated by AI during triage.*\n```\n\n## 参考文档\n\n- [AGENT-BRIEF.md](AGENT-BRIEF.md) — 如何写出耐用的 agent brief\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` 意味着已附上 brief，agent 应该对 diff 采取下一步；`ready-for-human` 意味着已准备好由人来合并。\n\n每个经过分类的 issue 都应恰好带一个类别角色和一个状态角色。如果状态角色冲突，先标记出来并询问维护者，再做任何其他事情。\n\n这些是规范角色名——问题跟踪器中实际使用的标签字符串可能不同。映射关系应该已经提供给你了——如果没有，告诉用户运行 `\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- \"有哪些是 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 确实做了它声称的事——checkout 下来，运行相关测试或命令。报告发生了什么：已确认（附代码路径）、失败、或细节不足（强烈的 `needs-info` 信号）。确认过的验证能产生强得多的 agent brief。\n\n4. **盘问（如需）。** 如果请求需要补充打磨，调用 Skill 工具两次，分别传入 \"grilling\" 和 \"domain-modeling\"——一轮一轮地把它盘问成型，随着决策落定，同步打磨领域术语并更新 `GLOSSARY.md`\u002FADR。\n\n5. **应用结果：**\n   - `ready-for-agent` — 发布 agent brief 评论（[AGENT-BRIEF.md](AGENT-BRIEF.md)）。\n   - `ready-for-human` — 结构同 agent brief，但要注明为什么不能委派（需要判断、外部访问、设计决策、人工测试）。\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 brief。\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","30fc5dbf9380144598f3593e6c1e22c713a52c2a","skills\u002Fengineering\u002Ftriage",48,"https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh","https:\u002F\u002Fgithub.com\u002Fdevcxl","2026-11-13 04:10:40",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":24},[34,37,40],{"tool":35,"command":36},"npx","npx skills add devcxl\u002Fmattpocock-skills-zh --skill triage",{"tool":38,"command":39},"bunx","bunx skills add devcxl\u002Fmattpocock-skills-zh --skill triage",{"tool":41,"command":42},"pnpm","pnpm dlx skills add devcxl\u002Fmattpocock-skills-zh --skill triage","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevcxl\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","参考文档",7499,"https:\u002F\u002Fgithub.com\u002Fdevcxl\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\u002Fdevcxl\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",4386,"https:\u002F\u002Fgithub.com\u002Fdevcxl\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},"01M75MMJXWKRN5DFAYWKNHCG28","writing-for-agents","为智能体编写文档。当你正在创建或编辑技能，或者修改 AGENTS.md \u002F CLAUDE.md 时使用。","https:\u002F\u002Fgithub.com\u002Fdevcxl\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},"01M75MMHVFN4B6QBPNGQ5GJSDT","wait-what","等等。上一条消息我没理解：重新解释一下。","https:\u002F\u002Fgithub.com\u002Fdevcxl\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},"01M75MMGNH9G1M7WC7NKP6100Y","to-questionnaire","将你无法完全回答的决策转化为供他人填写的问卷。","https:\u002F\u002Fgithub.com\u002Fdevcxl\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},"01M75MME5PC8MBS7M6R6RH7VDH","teach","在当前工作区中教会用户一项新技能或概念。","https:\u002F\u002Fgithub.com\u002Fdevcxl\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},"01M75MMD05VWVMK55W6GEWJNX3","handoff","将当前对话压缩为一份交接文档，供另一个智能体继续工作。","https:\u002F\u002Fgithub.com\u002Fdevcxl\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},"01M75MMBS30DRYPMC6SADZ7ZTT","grilling","对用户的计划、决策或想法进行层层盘问。当用户想要压力测试自己的思考，或使用任何 'grill' 触发短语时使用。","https:\u002F\u002Fgithub.com\u002Fdevcxl\u002Fmattpocock-skills-zh\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[]]