关于 triage
triage 是用于项目议题跟踪器的分类与状态管理技能，供维护者评估、分派和处理议题。它以类别和状态角色组织流程，并要求在分诊期间发布的内容注明由 AI 生成。
主要功能
- 01按 bug 与 enhancement 分类
- 02使用五种状态角色推进议题
- 03按优先桶展示待处理议题
- 04复查记者对补充信息的回复
- 05为 Agent 或人工准备交接说明
适用场景
- 01整理尚未分诊的议题
- 02评估缺少信息的报告
- 03将已明确任务交给 Agent
- 04记录不予处理的决定
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/triage确认已加载。
附带文件AGENT-BRIEF.mdOUT-OF-SCOPE.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— 不会处理
每个已分类的问题都应恰好带有一个类别角色和一个状态角色。如果状态角色冲突，请标记出来，并先询问维护者，再进行任何其他操作。
这些是规范角色名称——问题跟踪器中实际使用的标签字符串可能不同。你应该已经收到对应关系——如果没有，请运行 /memo-flow。
状态转换：未标记的问题通常先进入 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
将深入询问过程中确认的所有内容记录在“目前已确定”下，以免丢失工作成果。问题必须具体且可执行，不要问“请提供更多信息”。
恢复先前的会话
如果问题中已有先前的分诊记录，请先阅读，检查报告者是否已回答任何未解决的问题，并在继续之前展示更新后的情况。不要重复询问已解决的问题。