用途:把项目 issue 跟踪器中的 issue(以及被配置为请求入口的外部 PR)沿一个小型状态机推进,完成分类、验证、追问与简报撰写。
主要能力:两类分类角色 bug、enhancement;五个状态角色 needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。每个已分诊 issue 应恰好带一个分类角色和一个状态角色;状态冲突时先标记并询问维护者。状态流转:未标记通常先进入 needs-triage,再转向 needs-info、ready-for-agent、ready-for-human 或 wontfix;needs-info 在报告者回复后回到 needs-triage。维护者可随时覆盖。
使用方式:维护者调用 /triage 并用自然语言描述需求,例如查看待处理项、查看 #42、把 #42 移到 ready-for-agent、查看哪些可供智能体接手。查看待处理项时按最旧优先列出未标记、needs-triage、以及上次分诊后有报告者活动的 needs-info 三类,PR 在范围内时标注 [PR] 或 [issue]。分诊具体条目时先收集上下文、解析既有分诊笔记、按领域术语探索代码库并检查冗余与既往拒绝记录,再给出分类与状态建议,等待指示;随后验证声明(bug 复现、PR 检出并运行相关测试),必要时用 /grilling 与 /domain-modeling 追问,最后按结果应用:ready-for-agent 发布智能体简报,ready-for-human 用相同结构并说明不可委派原因,needs-info 发布分诊笔记,wontfix 按原因关闭(已实现则指向代码位置,不写入 .out-of-scope/;被拒的增强写入 .out-of-scope/ 并链接后关闭)。快速状态覆盖时信任维护者直接应用角色,跳过追问;若直接移到 ready-for-agent 且未追问,询问是否撰写智能体简报。
限制与约定:分诊期间发布到跟踪器的每条评论或 issue 必须以“This was generated by AI during triage.”开头。角色名是规范名,实际标签字符串可能不同,映射应由环境提供,否则运行 /setup-matt-pocock-skills。发现阶段只呈现外部 PR,协作者进行中的 PR 不算分诊工作;但被明确点名的 PR 无论作者都会分诊。参考资料包括 AGENT-BRIEF.md、OUT-OF-SCOPE.md。恢复先前会话时先读既有分诊笔记,检查报告者是否已回答未决问题,不要重复已解决的问题。其他细节暂未提供。