triage 用于在项目 issue 跟踪器中,按小型状态机推进 issue 的分拣流程。每条分拣期间发布的评论或 issue 都必须以声明开头:This was generated by AI during triage。
用途:帮助维护者评估新提交的 bug 或功能请求,判定 issue 该补充信息、交给 AFK agent 实现、留给人工处理,还是标记为 wontfix。
角色:分类角色为 bug(某处损坏)和 enhancement(新功能或改进);状态角色为 needs-triage(待维护者评估)、needs-info(等待报告者补充信息)、ready-for-agent(已完整定义,可交给 AFK agent)、ready-for-human(需人工实现)、wontfix(不会处理)。每个已分拣 issue 应恰好携带一个分类角色和一个状态角色;若状态角色冲突,需先标记并询问维护者。这些是规范角色名,实际标签字符串可能不同,需查阅项目的 AGENTS.md 或现有标签映射。状态流转通常为无标签先进入 needs-triage,再流向 needs-info、ready-for-agent、ready-for-human 或 wontfix;needs-info 在报告者回复后回到 needs-triage。维护者可随时覆盖,遇到异常流转应先询问。
调用方式:维护者以自然语言调用 /triage 并说明需求,例如“Show me anything that needs my attention”“Let's look at #42”“Move #42 to ready-for-agent”“What's ready for agents to pick up?”。
主要流程:展示待关注项时,按最旧优先列出未标记、needs-triage、以及在上次分拣后报告者有新活动的 needs-info 三类,附计数和一行摘要。分拣具体 issue 时,先读取完整 issue、评论、标签、报告者与日期,解析既有分拣笔记,浏览代码库并尊重相关 ADR,再读取 .out-of-scope/*.md 检查是否有类似的历史拒绝;随后给出分类与状态建议及理由,等待指示。对 bug 先尝试复现,报告成功复现及代码路径、复现失败或细节不足。需要补充细节时可调用 /grill-me(若已安装),否则直接提问。
结果处理:ready-for-agent 发布 agent brief 评论,其中包含上下文、范围、验收标准、相关文件和不可做的事项约束;ready-for-human 结构相同但说明不能委派的原因;needs-info 发布分拣笔记模板,列出已确定事项和仍需报告者回答的具体问题;wontfix(bug)礼貌解释后关闭;wontfix(enhancement)写入 .out-of-scope/ 并从评论链接后关闭;needs-triage 直接应用角色。若维护者要求快速覆盖状态,则直接应用并确认即将执行的改动,跳过 grilling;若直接移到 ready-for-agent 且未做 grilling,询问是否要写 agent brief。恢复先前会话时,先读取既有分拣笔记,检查报告者是否已回答待办问题,再展示更新情况,不重复询问已解决的问题。
限制:资料未说明具体支持的 issue 跟踪平台、安装方式、收费或价格信息。