用途:让项目问题跟踪器上的 issue 走一遍由分类角色组成的小型状态机;若仓库把外部 PR 也当作请求入口,则 PR 同样适用(PR 即带代码的 issue,角色、状态、状态机相同,仅少数“仅限 PR”差异)。分类期间发布到跟踪器的每条评论或 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。
状态转换:未打标签通常先进入 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 且报告人在上次分类笔记后有活动;PR 在范围内时标注 [PR] 或 [issue],发现面只呈现外部 PR。分类具体条目时先收集上下文(读正文、评论、标签、作者、日期、PR diff,解析旧笔记,查代码库冗余与 .out-of-scope/ 先前拒绝),给出类别与状态建议并等待指示,再验证主张(bug 按步骤复现,PR 确认 diff 并运行相关测试或命令),必要时调用 grilling 与 domain-modeling 盘问。结果应用:ready-for-agent 发布 agent brief;ready-for-human 结构相同但注明不可委派原因;needs-info 发布分类笔记;wontfix 按原因关闭(已实现指出位置,被拒绝的 enhancement 写入 .out-of-scope/ 并链接后关闭)。快速状态覆盖时信任维护者直接应用角色,跳过盘问;无盘问直接移到 ready-for-agent 时询问是否写 agent brief。恢复会话时读旧笔记、检查是否已回答、呈现更新图景,不重复已解决问题。
限制:依赖问题跟踪器配置与角色映射;外部 PR 判定由跟踪器配置定义;协作者进行中的 PR 不属于分类工作;具体平台、收费与效果资料未提供。