用途:在项目的议题跟踪器上,让 issue(以及被配置为请求入口的外部 PR)通过一个由 triage 角色组成的小型状态机,完成分类、验证与简报撰写。若仓库把外部 PR 视为请求入口,PR 也按同一套角色与状态处理,仅少数差异以「for a PR」标注。#42 会按跟踪器配置解析为 issue 或 PR。
主要能力:两类分类角色——bug(有东西坏了)、enhancement(新功能或改进)。五个状态角色——needs-triage(待维护者评估)、needs-info(等待报告者补充信息)、ready-for-agent(规格完整,可交给 AFK 智能体)、ready-for-human(需人工实现)、wontfix(不予处理)。每个已 triage 的条目应恰好带一个分类角色和一个状态角色;状态角色冲突时先标记并询问维护者。状态流转:未打标签的通常先去 needs-triage,再转到 needs-info、ready-for-agent、ready-for-human 或 wontfix;needs-info 在报告者回复后回到 needs-triage。维护者可随时覆盖,异常流转需先标记并询问。
使用方式:维护者用自然语言调用 /triage 并描述意图,例如「显示需要我关注的内容」「看一下 #42」「把 #42 移到 ready-for-agent」「哪些已准备好让智能体接手」。展示待办时按最早优先列出三类:未打标签、needs-triage、以及 last triage 后报告者有活动的 needs-info,并给计数与一行摘要。处理单个条目时要读全文、评论、标签、作者、日期与 PR diff,解析既往 triage 记录,探索代码库,做冗余检查(按领域概念而非原措辞搜索已有实现)与既往拒绝检查(读 .out-of-scope/*.md),给出分类与状态建议并等待指示;随后验证主张(bug 按步骤复现,PR 检出并跑相关测试),必要时调用 grilling 与 domain-modeling 技能逐轮追问并同步更新 GLOSSARY.md/ADR;最后按结果落地:ready-for-agent 发智能体简报评论,ready-for-human 同结构但说明为何不能委派(判断、外部访问、设计决策、手工测试),needs-info 发 triage 记录,wontfix 则关闭并据原因(已实现、bug 拒绝、enhancement 拒绝写入 .out-of-scope/)附评论。needs-info 模板含「已确立内容」与向 @报告者 提出的具体可执行问题。快速状态覆盖时信任维护者直接应用角色并跳过错问;若直接移到 ready-for-agent 且未做 grilling,询问是否要写智能体简报。恢复旧会话时先读既往记录、检查是否已回答遗留问题,避免重复提问。triage 期间发布到跟踪器的每条评论或 issue 都必须以「This was generated by AI during triage.」开头。
限制:角色名是规范名,跟踪器里实际标签字符串可能不同,映射应由外部提供;若未提供,需提示用户运行 /setup-agent-skills。发现范围只覆盖外部 PR(由跟踪器配置定义「外部」),协作者进行中的 PR 不算 triage 工作,但被显式点名的 PR 无论作者都会处理。其余能力与配置细节资料暂未提供。