用途:在项目问题跟踪器中,按小型状态机推动 issue 流转。每个分流中发布的评论或 issue 必须以“This was generated by AI during triage.”声明开头。
角色:两类分类角色 bug(损坏)与 enhancement(新功能或改进);五种状态角色 needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。每个已分流 issue 应恰好带一个分类角色和一个状态角色,冲突时先标记并询问维护者。角色名为规范名,跟踪器中实际标签字符串可能不同,映射应由环境提供,否则运行 /setup-matt-pocock-skills。
状态流转:未标注 issue 通常先到 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 且报告者有新活动。显示数量与每项一行摘要,供维护者选择。
分流具体 issue:收集上下文(正文、评论、标签、报告者、日期,解析既有分流笔记,结合领域词汇与 ADR,检查 .out-of-scope/*.md);给出分类与状态建议及理由,等待指示;bug 先尝试复现(成功、失败或信息不足,信息不足是 needs-info 强信号);必要时运行 /grill-with-docs;按结果执行:ready-for-agent 发 agent brief,ready-for-human 同结构并说明不可委托原因,needs-info 发分流笔记,wontfix(bug)礼貌解释后关闭,wontfix(enhancement)写入 .out-of-scope/ 并评论链接后关闭,needs-triage 应用角色。
快速状态覆盖:若维护者直接要求移动,信任并直接应用,确认角色变更、评论、关闭等动作后执行,跳过追问;若直接移到 ready-for-agent 且未经追问,询问是否要写 agent brief。
needs-info 模板:Triage Notes 下写“What we've established so far”和“What we still need from you (@reporter)”,问题须具体可执行。恢复会话时读取旧笔记,检查报告者是否已回答遗留问题,展示更新情况,不重复已解决问题。
限制:资料未提供具体平台适配、命令细节、权限要求与错误处理等更多信息。