用途:把项目 issue 跟踪器中的 issue 和外部 PR 推过一个小型分诊状态机,由维护者用自然语言调用 /triage 触发。
角色:两个分类角色 bug(功能损坏)、enhancement(新功能或改进);五个状态角色 needs-triage(待维护者评估)、needs-info(等待报告者补充信息)、ready-for-agent(规格完整,可交给离线智能体)、ready-for-human(需人工实现)、wontfix(不予处理)。每个已分诊 issue 应恰好带一个分类角色和一个状态角色;状态角色冲突时先标记并询问维护者。这些是规范角色名,跟踪器中的实际标签字符串可能不同,映射应已提供,否则运行 /memo-flow。
状态流转:未打标签的 issue 通常先进入 needs-triage,再转向 needs-info、ready-for-agent、ready-for-human 或 wontfix;报告者回复后 needs-info 回到 needs-triage。维护者可随时覆盖,异常流转需先询问。
用法:维护者用自然语言描述需求,例如“显示需要我关注的内容”“看看 #42”“把 #42 移到 ready-for-agent”“哪些已准备好让智能体接手”。展示待关注项时按最旧优先分三组:未打标签、needs-triage、needs-info 且报告者在上次分诊记录后有活动,并给出计数和每项一行摘要。分诊具体 issue 时先收集上下文(正文、评论、标签、报告者、日期、既有分诊记录、代码库、ADR、.out-of-scope/*.md),给出分类与状态建议及理由,等待指示;bug 在追问前先尝试复现;需要补充时运行 /grill-with-docs;随后按结果发布智能体简报、人工简报、分诊记录、礼貌说明并关闭,或写入 .out-of-scope/ 后关闭。快速状态覆盖时直接应用角色,跳过追问;若移到 ready-for-agent 且未追问,询问是否撰写智能体简报。needs-info 模板包含“已确立内容”和“仍需报告者回答的问题”,问题须具体可执行。恢复先前会话时读取既有分诊记录,检查报告者是否已回答未决问题,不重复已解决的问题。
限制:所有分诊期间发布的评论或 issue 必须以“This was generated by AI during triage.”开头;实际标签映射需由外部提供;资料未说明具体平台、收费或效果。