用途
triage 用于在项目的议题跟踪器中，通过一套小型状态机来推动议题流转，适合创建议题、分诊议题、审查新提交的 bug 或功能请求等场景。
在分诊期间发布到议题跟踪器的每条评论或议题都必须以如下免责声明开头：
This was generated by AI during triage.
参考文档
- AGENT-BRIEF.md — 如何编写持久的智能体简报
- OUT-OF-SCOPE.md — .out-of-scope/ 知识库的工作方式
角色
两个分类角色：
- bug — 某处出现故障
- enhancement — 新功能或改进
五个状态角色：
- needs-triage — 维护者需要评估
- needs-info — 等待报告者提供更多信息
- ready-for-agent — 已完整说明，可供 AFK 智能体处理
- ready-for-human — 需要人工实现
- wontfix — 不会被处理
每个已分诊的议题应恰好携带一个分类角色和一个状态角色。若状态角色冲突，需先标记并询问维护者，然后再进行任何其他操作。
这些是规范角色名——议题跟踪器中实际使用的标签字符串可能不同。映射关系应已提供给你——如果没有，请运行 /setup-matt-pocock-skills。
状态流转：未打标签的议题通常先进入 needs-triage；从那里可流转到 needs-info、ready-for-agent、ready-for-human 或 wontfix。一旦报告者回复，needs-info 会回到 needs-triage。维护者可随时覆盖——对看起来不寻常的流转进行标记，并在继续前询问。
调用方式
维护者调用 /triage 并用自然语言描述其意图。解读请求并执行。示例：
- “Show me anything that needs my attention”
- “Let's look at #42”
- “Move #42 to ready-for-agent”
- “What's ready for agents to pick up?”
展示需要关注的内容
查询议题跟踪器，按最旧优先呈现三个分组：
- Unlabeled — 从未分诊。
- needs-triage — 评估进行中。
- needs-info 且自上次分诊笔记以来报告者有活动 — 需要重新评估。
显示数量，并为每个议题提供一行摘要。让维护者挑选。
分诊特定议题
收集上下文。阅读完整议题（正文、评论、标签、报告者、日期）。解析任何先前的分诊笔记，以免重复询问已解决的问题。使用项目的领域词汇表探索代码库，并遵守该区域的 ADR。阅读 .out-of-scope/*.md，并呈现任何与此议题相似的先前拒绝记录。
给出建议。告诉维护者你的分类和状态建议及理由，并附上与议题相关的简要代码库摘要。等待指示。
复现（仅限 bug）。在任何追问之前，尝试复现：阅读报告者的步骤、追踪相关代码、运行测试或命令。报告发生的情况——成功复现并附代码路径、复现失败，或细节不足（这是强烈的 needs-info 信号）。确认复现能显著增强智能体简报的说服力。
追问（如需要）。若议题需要充实，运行 /grill-with-docs 会话。
应用结果：
- ready-for-agent — 发布智能体简报评论（AGENT-BRIEF.md）。
- ready-for-human — 结构与智能体简报相同，但需说明为何无法委派（判断性决策、外部访问、设计决策、手动测试）。
- needs-info — 发布分诊笔记（见下方模板）。
- wontfix（bug）— 礼貌解释，然后关闭。
- wontfix（enhancement）— 写入 .out-of-scope/，从评论链接到它，然后关闭（OUT-OF-SCOPE.md）。
- needs-triage — 应用该角色。如有部分进展，可选发表评论。
快速状态覆盖
若维护者说“move #42 to ready-for-agent”，信任他们并直接应用该角色。确认你即将执行的操作（角色变更、评论、关闭），然后执行。跳过追问。若在没有追问会话的情况下移至 ready-for-agent，询问他们是否想编写智能体简报。
needs-info 模板
Triage Notes
What we've established so far:
- point 1
- point 2
What we still need from you (@reporter):
- question 1
- question 2
将追问期间解决的所有内容记录在“established so far”下，以免工作成果丢失。问题必须具体且可操作，而不是“please provide more info”。
恢复之前的会话
若议题上存在先前的分诊笔记，阅读它们，检查报告者是否已回答任何未决问题，并在继续之前呈现更新后的情况。不要重复询问已解决的问题。
限制
资料未提供具体适用的项目类型、平台限制、收费信息或效果说明。