关于 triage
triage 是供项目维护者按类别和状态角色处理问题的 Skill，涵盖审查、复现、澄清及按处理结果更新问题跟踪器。
主要功能
- 01问题分类与状态流转
- 02按时间排列待处理队列
- 03审阅问题背景和先前备注
- 04复现缺陷并补充澄清
- 05按处理结果发布评论或关闭
适用场景
- 01查看等待维护者处理的问题
- 02在报告者回复后重新评估
- 03为 Agent 准备需求明确的问题
- 04向报告者索取具体可执行的信息
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/triage确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
AGENT-BRIEF.mdOUT-OF-SCOPE.mdREADME.md详细介绍
分类处理
通过一组分类处理角色构成的小型状态机，推进项目问题跟踪器中的问题。
分类处理期间发布到问题跟踪器的每条评论或问题必须以以下免责声明开头：
> *This was generated by AI during triage.*
参考文档
- AGENT-BRIEF.md — 如何编写持久有效的 Agent 简报
- OUT-OF-SCOPE.md —
.out-of-scope/知识库的运作方式
角色
两个类别角色：
bug— 某项功能无法正常工作enhancement— 新功能或改进
五个状态角色：
needs-triage— 维护者需要评估needs-info— 等待报告者提供更多信息ready-for-agent— 规格完整，可交由 AFK Agent 处理ready-for-human— 需要人工实现wontfix— 不会处理
每个经过分类处理的问题都应恰好带有一个类别角色和一个状态角色。如果状态角色有冲突，请标记出来，并先询问维护者，再进行任何其他操作。
这些是规范的角色名称——问题跟踪器中实际使用的标签字符串可能有所不同。映射信息应该已提供给你；如果没有，请运行 /setup-matt-pocock-skills。
状态转换：未加标签的问题通常先进入 needs-triage；之后可转为 needs-info、ready-for-agent、ready-for-human 或 wontfix。报告者回复后，needs-info 会转回 needs-triage。维护者可随时覆盖状态——如果转换看起来不寻常，请标记出来，并在继续前先询问。
调用方式
维护者通过 /triage 调用，并用自然语言描述需求。理解请求并采取行动。示例：
- “列出所有需要我处理的问题”
- “我们来看看 #42”
- “将 #42 转为 ready-for-agent”
- “有哪些问题已准备好交由 Agent 处理？”
查看需要处理的问题
查询问题跟踪器，并按最早优先列出以下三类问题：
- 未加标签 — 从未经过分类处理。
needs-triage— 正在评估。needs-info且报告者在上次分类处理备注后有活动 — 需要重新评估。
显示数量，并为每个问题提供一行摘要。由维护者选择。
对特定问题进行分类处理
-
收集上下文。 阅读完整问题（正文、评论、标签、报告者、日期）。解析之前的分类处理备注，避免重复询问已解决的问题。使用项目的领域术语表探索代码库，并遵循相关区域的 ADR。阅读
.out-of-scope/*.md，并指出与此问题类似的既往拒绝记录。 -
提出建议。 告知维护者建议的类别和状态，并说明理由；同时简要概述与该问题相关的代码库情况。等待指示。
-
复现（仅限 bug）。 在深入提问前，先尝试复现：阅读报告者提供的步骤，追踪相关代码，运行测试或命令。报告结果——成功复现并指出代码路径、复现失败，或信息不足（这强烈表明应设为
needs-info）。确认复现后，Agent 简报会更有说服力。 -
深入提问（如有需要）。 如果问题需要补充细节，请进行一次
/grill-with-docs会话。 -
执行处理结果：
ready-for-agent— 发布 Agent 简报评论（参见 AGENT-BRIEF.md）。ready-for-human— 使用与 Agent 简报相同的结构，但说明为何无法委派（需要判断、外部访问权限、设计决策或手动测试）。needs-info— 发布分类处理备注（见下方模板）。wontfix（bug）— 礼貌地说明原因，然后关闭。wontfix（enhancement）— 写入.out-of-scope/，在评论中链接到该文件，然后关闭（参见 OUT-OF-SCOPE.md）。needs-triage— 应用该角色。可选地在有部分进展时发表评论。
快速覆盖状态
如果维护者说“将 #42 转为 ready-for-agent”，就相信他们并直接应用该角色。先确认即将执行的操作（角色变更、评论、关闭），然后执行。跳过深入提问。如果未进行深入提问会话就转为 ready-for-agent，请询问他们是否希望编写 Agent 简报。
需要补充信息模板
## Triage Notes
**What we've established so far:**
- point 1
- point 2
**What we still need from you (@reporter):**
- question 1
- question 2
将深入询问过程中确认的所有内容记录在“目前已确定”下，以免丢失工作成果。问题必须具体且可执行，不要问“请提供更多信息”。
恢复先前的会话
如果问题中已有先前的分诊记录，请先阅读，检查报告者是否已回答任何未解决的问题，并在继续之前展示更新后的情况。不要重复询问已解决的问题。