用途:通过由分诊角色组成的小型状态机,在项目 issue 跟踪器中移动 issue,用于创建 issue、分诊 issue、审查传入的 bug 或功能请求、为 AFK agent 准备 issue,以及管理工作流。注意,分诊期间发布到 issue 跟踪器的每条评论或 issue 必须以指定免责声明开头。
主要能力与角色:两个类别角色 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 并用自然语言描述请求,例如显示需要关注的内容、查看某个 issue、移动到 ready-for-agent、查看哪些可由 agent 认领。显示关注项时查询 issue 跟踪器并按最旧优先呈现未标记、needs-triage、needs-info 且报告者有活动三个桶。分诊特定 issue 时先收集上下文,读取 issue 全部内容、解析先前分诊记录、探索代码库、读取 .out-of-scope/*.md;随后给出类别与状态推荐并等待指示;bug 需先尝试复现;必要时运行 /grill-with-docs;最后按结果发布 agent brief 评论、分诊记录、写入 .out-of-scope/ 或关闭。快速状态覆盖时,若维护者直接指定移动,信任并直接应用角色,跳过深入分析。
适用场景:issue 跟踪器中的 bug 与功能请求管理、为 AFK agent 准备任务、判断是否需要人工实现。
限制:资料未提供具体平台、安装命令、收费或效果信息;正文中给出的角色与流程依赖项目提供的映射与文档。