用途:在项目 issue 跟踪器中,把 issue 及(若配置将外部 PR 视为请求入口的)外部 PR 沿一套小型状态机推进分诊流程。每个被分诊的 issue 应只带一个类别角色和一个状态角色;若状态角色冲突,需先标记并向维护者确认。角色名称是规范名,跟踪器中实际标签字符串可能不同,映射应由使用者提供,否则运行 /setup-matt-pocock-skills。
主要能力:展示待处理项(未标记、needs-triage、needs-info 且报告者有新活动),按最旧优先排序,PR 行标注 [PR];仅在发现阶段过滤外部 PR,被明确点名的 PR 一律分诊。对指定 issue/PR 收集上下文(正文、评论、标签、作者、日期、PR 的 diff),解析既有分诊笔记,按领域术语探索代码库并遵守 ADR;执行冗余检查(按领域概念搜索既有实现)与先前拒绝检查(读 .out-of-scope/*.md)。随后给出类别与状态建议及理由,等待指示。在追问前先验证主张:bug 按报告步骤复现,PR 检出并运行相关测试或命令,报告已确认(含代码路径)、失败或细节不足。必要时联合运行 /grilling 与 /domain-modeling 逐问打磨,并同步更新 CONTEXT.md/ADR。最后落地结果:ready-for-agent 发布 agent brief 评论;ready-for-human 同结构但说明为何不能委派;needs-info 发布分诊笔记;wontfix 视原因关闭(已实现则指向代码位置且不写 .out-of-scope/,增强被拒则写入并链接后关闭,bug 被拒则礼貌说明后关闭);needs-triage 应用角色。
使用方式:维护者以自然语言调用 /triage 并说明意图,例如“显示需要我关注的内容”“看看 #42”“把 #42 移到 ready-for-agent”。快速状态覆盖时直接应用角色,先确认将要执行的角色变更、评论与关闭动作再执行,跳过追问;若在无追问会话下移到 ready-for-agent,需问是否要写 agent brief。恢复上次会话时读取既有笔记,检查报告者是否已回答待定问题,先呈现更新后的情况,不重复已解决的问题。分诊期间发布到跟踪器的每条评论或 issue 必须以“This was generated by AI during triage.”开头。
限制:实际标签字符串依赖跟踪器配置提供的映射;外部 PR 与 issue 的判定依赖跟踪器配置;功能细节以随附参考文档 AGENT-BRIEF.md、OUT-OF-SCOPE.md 为准;其余平台、收费与效果信息暂未提供。