用途:将项目 issue tracker 上的 issue 通过小型状态机的分类角色进行移动,适用于创建 issue、分类 issue、审查传入的 bug 或功能请求、为 AFK 代理准备 issue 以及管理 issue 工作流。分类期间发布到 issue tracker 的每个评论或 issue 必须以“这是在分类期间由 AI 生成的。”免责声明开头。
主要能力:包含两个类别角色(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;维护者可随时覆盖。
使用方式:维护者调用 /triage 并用自然语言描述需求,例如“显示任何需要注意的内容”“让我们看看 #42”“将 #42 移动到 ready-for-agent”“什么准备好让代理接收?”。显示需要注意的内容时,查询 issue tracker 并展示未标记、needs-triage、needs-info 且有报告者活动三个桶,按最旧优先,显示计数和一行摘要。分类特定 issue 时收集上下文、推荐、重现(仅 bug)、必要时运行 /grill-with-docs,然后应用结果。快速状态覆盖时信任维护者并直接应用角色,跳过 grilling。
限制:规范角色名称与实际标签字符串可能不同,映射应已提供,否则需运行 /setup-matt-pocock-skills。参考文档包括 AGENT-BRIEF.md、OUT-OF-SCOPE.md。needs-info 模板需列出已确定内容和仍需报告者提供的问题。若存在先前分类笔记,应阅读并检查报告者是否已回答未完成问题,不要重新询问已解决的问题。