triage
通过分诊角色的状态机流转 issue 和外部 PR,进行分类、验证、必要时严审,并编写 agent 可直接使用的简报。
技能说明mattpocock/skills
通过分诊角色的状态机流转 issue 和外部 PR,进行分类、验证、必要时严审,并编写 agent 可直接使用的简报。
技能简介
triage 技能通过分诊角色的状态机来管理 issue 和外部 PR,帮助维护者完成分类、验证、必要时深入追问,并产出 agent 可直接执行的任务简报,从而减少维护者的重复性工作。
使用场景
- 查看所有需要维护者关注的 issue 和外部 PR(含从未分诊的未标记条目)
- 对新提交的 issue 进行分诊,判定为
bug或enhancement - 验证 bug 报告是否可复现、PR 改动是否与描述一致
- 将信息不足的 issue 标记为
needs-info,等待上报者补充 - 将已充分描述的 issue 转为
ready-for-agent,交由 AFK agent 执行
使用方法
- 确认技能已正确配置。若标签映射未提供,请先运行
/setup-matt-pocock-skills。 - 维护者输入
/triage并用自然语言描述需求,例如:- "Show me anything that needs my attention"
- "Let's look at #42"
- "Move #42 to ready-for-agent"
- 技能会查询 issue tracker,并按「未标记 /
needs-triage/needs-info且有新回复」三个类别展示,由维护者选择处理对象。 - 对具体 issue 或 PR,技能按以下流程执行:收集上下文(含冗余性检查和
.out-of-scope/先前拒绝记录)→ 给出分类与状态建议 → 验证主张 → 必要时调用 grilling 与 domain-modeling 追问 → 应用最终结果。 - 结果会发布为评论;若转为
ready-for-agent,技能会编写 agent brief;若为wontfix,则根据原因关闭、说明或写入.out-of-scope/知识库。
注意事项
- 分诊期间发布的每条评论必须以
> *This was generated by AI during triage.*开头。 - 每个 issue 应恰好携带一个分类角色(
bug或enhancement)和一个状态角色;状态角色冲突时须先询问维护者。 - 状态名称是规范角色名,实际标签字符串可能不同,请使用已配置的映射。
- 处理
wontfix时注意区分原因:「已实现」指向代码位置即可,不写入.out-of-scope/;「已拒绝」的 enhancement 需写入知识库并附链接。