用途
triage 用于把项目问题跟踪器中的 issue 以及（在仓库把外部 PR 视为请求入口时）外部 PR，沿着一个小型状态机推进，并为每个请求产出一份可靠的 agent brief，供代理据此开展工作。
主要能力
- 角色体系：两个类别角色为 bug（功能损坏）与 enhancement（新功能或改进）；五个状态角色为 needs-triage（待维护者评估）、needs-info（信息缺失）、ready-for-agent（规格完整，可由代理执行）、ready-for-human（需要所有者本人账户、凭据或保留的品味判断）、wontfix（不予处理）。每个已分诊 issue 应恰好带一个类别角色和一个状态角色；状态角色冲突时先标记并询问维护者。
- 状态流转：未打标签的 issue 通常先进入 needs-triage，再流向 needs-info、ready-for-agent、ready-for-human 或 wontfix；needs-info 在信息补齐后回到 needs-triage。维护者可随时覆盖，异常流转需先询问。
- 按不确定性分类：在研究前判断开放问题的答案所在。code-bound 指预期结果明确，可由代码、日志或复现回答；intent-bound 指缺失的是所有者意图、政策或只能由其拍板的权衡。若简报需携带给所有者的问题、选项列表或无人选定的取值，则属 intent-bound。
- 研究运行：为单个请求启动带全新上下文的子代理，先做两项检查——按领域概念检索现有实现以查重复，以及验证声言（bug 按报告人步骤复现；PR 检出并运行相关测试或命令，报告确认、失败或细节不足）。
- 代理简报撰写与审阅：code-bound 路径下由研究代理发布简报与分诊笔记；intent-bound 路径下先做事实调查，可引用的意图问题由编排代理自行回答（须有出处、在工作内可逆、不改目标范围），其余通过 grill 会话交所有者决定，再拆分、归档 issue 并撰写简报。
- 审阅标准：从证据（每条声言可追溯到代码路径、复现或 issue）、范围、验收标准（具体、可测、可独立验证）、依赖、开放问题五方面审阅；审阅者不能是自己所接受的简报的作者。任何伪装成代理选择的未决意图都需退回。
- 就绪应用：等待 issue-contract 工作流发布修订通知，使用已审阅修订的 sha256 版本与选定标签，通过捆绑命令应用就绪状态：
node <this skill's directory>/ready.mjs <issue> ready-for-agent <sha256:reviewed-revision> <model-label>
ready-for-human 需在备注中说明所需账户、凭据或保留的品味判断，无需模型标签时省略。其他伴随标签（如 factory:skip）随修订；--repo owner/name 可选择其他仓库。需在前台以 Node.js 24 或 26 运行，受调用方命令超时约束；命令使用当前 gh 凭据，无需安装步骤。
使用方式
维护者以自然语言调用 /triage 并描述需求，例如「显示需要我关注的内容」「看看 #42」「把 #42 移到 ready-for-agent」「哪些可供代理领取」。展示需关注内容时，按最旧优先列出未打标签、needs-triage、needs-info 且报告人有活动或所有者有新决定三类，并标注 [PR] 或 [issue]。
适用场景与限制
适用于维护者对 issue 跟踪器进行分诊、将请求整理为可执行简报并决定就绪状态的场景。分诊期间发布到跟踪器的每条评论或 issue 正文，均须以 CONTRIBUTING.md 账户政策中的分诊免责声明开头。若无法启动子代理，编排代理须自行研究、发布简报并停止，告知所有者该简报仍需未撰写它的审阅者。功能细节以仓库内 AGENT-BRIEF.md、OUT-OF-SCOPE.md 及分诊标签配置为准。