用途:把项目问题跟踪器中的 issue(以及被配置为请求入口的外部 PR)沿一套小型状态机推进,完成分类、验证、追问与简报撰写。
主要能力:两类分类角色(bug、enhancement)与五种状态角色(needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix)。每个已分诊条目应恰好带一个分类角色和一个状态角色;状态冲突时先标记并询问维护者。状态流转:未标记通常先进入 needs-triage,再转向 needs-info、ready-for-agent、ready-for-human 或 wontfix;needs-info 在报告者回复后回到 needs-triage。维护者可随时覆盖。
使用方式:维护者调用 /triage 并用自然语言描述需求,例如查看待处理项、查看 #42、把 #42 移到 ready-for-agent、查看可供智能体接手的条目。查看待处理项时按最旧优先分三组展示:📭 未标记、🔄 needs-triage、💬 有报告者新活动的 needs-info,并标注 [PR] 或 [issue]。分诊具体条目时先收集上下文(正文、评论、标签、作者、日期,PR 还需 diff),解析既有分诊笔记,按领域词汇表探索代码库并遵守相关 ADR;执行冗余检查(按领域概念搜索已有实现)与既往拒绝检查(读取 .out-of-scope/*.md)。随后给出分类与状态建议并等待指示,再验证主张(bug 复现、PR 检出并运行相关测试或命令),必要时调用 grilling 与 domain-modeling 技能逐轮追问。结果应用:ready-for-agent 发布智能体简报评论;ready-for-human 用相同结构但说明不可委派原因;needs-info 发布分诊笔记;wontfix 按原因关闭(已实现则指向代码位置,不写入 .out-of-scope/;拒绝的增强则写入该知识库并链接后关闭)。快速状态覆盖时直接应用角色,跳过追问;若未追问就移到 ready-for-agent,需询问是否撰写简报。
限制:分诊期间发布到跟踪器的每条评论或 issue 必须以“This was generated by AI during triage.”开头。角色名为规范名,实际标签字符串可能不同,映射应由环境提供;若未提供,需提示用户运行 /setup-matt-pocock-skills。发现阶段只呈现外部 PR,协作者进行中的 PR 不算分诊工作,但被明确点名的 PR 无论作者都会分诊。needs-info 模板要求列出已确立要点与具体可执行的问题。恢复会话时先读既有笔记、检查未答问题,不重复已解决的问题。其余细节暂未提供。