SuperAPI AI 工具集

triage

智能体与模型

查看项目

更新于 10-15 21:41

技能介绍

用途:在项目问题跟踪器中推进 issue(以及被视作请求来源的外部 PR)的分诊流程,用一套小型状态机管理分诊角色。PR 被当作“附带代码的 issue”,使用相同角色与状态。

主要能力:包含两个分类角色——bug(有东西坏了)、enhancement(新功能或改进);五个状态角色——needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。每个完成分诊的 issue 应恰好带一个分类角色和一个状态角色;若状态角色冲突,需先标记并询问维护者。状态流转通常为:无标签先进入 needs-triage,再转向 needs-info、ready-for-agent、ready-for-human 或 wontfix;needs-info 在报告者回复后回到 needs-triage。维护者可随时覆盖。

使用方式:维护者通过 /triage 用自然语言发起请求,例如查看需要关注的事项、查看某个编号、把某个编号移到某状态等。查看待办时会列出三个桶(未标注、needs-triage、needs-info 且有报告者新活动),按最旧优先显示并标注 [PR] 或 [issue]。分诊具体条目时会先收集上下文(正文、评论、标签、作者、日期、PR 的 diff,并解析历史分诊笔记),按领域词汇探索代码库、遵守相关 ADR,再做冗余检查(按领域概念搜索已有实现,并报告搜索位置)与既往拒绝检查(读取 .out-of-scope/*.md)。随后给出分类与状态建议及理由,等待指示;在追问之前先核实主张(bug 按步骤复现,PR 检查 diff 是否名副其实,通过检出并运行相关测试或命令),结果为 confirmed、failed 或细节不足。必要时把 /grilling 与 /domain-modeling 一起运行,逐个问题打磨需求。最后按结果落地:ready-for-agent 发智能体简报评论,ready-for-human 用相同结构但说明为何不能委派,needs-info 发分诊笔记,wontfix 按原因关闭(已实现则指向代码位置,不写入 .out-of-scope/;bug 被拒则礼貌解释后关闭;enhancement 被拒则写入 .out-of-scope/ 并从评论链接后关闭)。

限制与约束:分诊期间发布到问题跟踪器的每条评论或 issue 都必须以“This was generated by AI during triage.”开头。角色名是规范名称,实际标签字符串可能不同,映射应已提供,否则需运行 /setup-matt-pocock-skills。发现流程只呈现外部 PR,协作者的进行中 PR 不属于分诊工作,但被明确指名的 PR 无论作者都会分诊。若维护者直接要求移动状态,应信任并直接应用,跳过追问;若在未追问的情况下移到 ready-for-agent,需询问是否要写智能体简报。恢复既有会话时应读取旧笔记、检查是否已回答遗留问题,不重复提问。其他细节暂未提供。