SuperAPI AI 工具集

triage

通用与其它

查看项目

更新于 10-15 21:39

技能介绍

triage 用于把项目 issue 跟踪器中的 issue(以及在配置视为请求入口时,外部 PR)沿一个小型状态机推进。它使用两个类别角色(bug、enhancement)和六个状态角色(needs-triage、needs-info、ready-for-agent、ready-for-human、paused、wontfix);每个已分诊项应恰好带一个类别角色和一个状态角色,出现冲突时先标记并询问维护者,再采取行动。角色名是规范名,跟踪器中的实际标签字符串可能不同,需要预先提供映射,否则运行 /setup-matt-pocock-skills。

用法:维护者以自然语言调用 /triage 并描述意图,例如“显示需要我关注的内容”“看一下 #42”“把 #42 移到 ready-for-agent”“暂停 #42 直到 #40 落地”“哪些已准备好让 agent 接手”。查看待办时,它查询跟踪器并按最旧优先给出四类:未打标签、needs-triage、上次分诊后有报告者活动的 needs-info、阻塞项已关闭的 paused;PR 在范围内时每条标注 [PR] 或 [issue],发现阶段只呈现外部 PR,但被显式点名的 PR 一律分诊,不论作者。

分诊具体 issue 或 PR 时:读取完整内容(正文、评论、标签、作者、日期,PR 还包括 diff),解析既有分诊笔记以避免重复提问,按项目术语探索代码库,遵守已接受的 ADR;对代码库做两项检查——按领域概念搜索是否已实现(若已实现则作为“已实现”的 wontfix),以及读取 .out-of-scope/*.md 看是否有相似的历史拒绝。随后给出类别与状态建议及理由,等待指示;在提问前先验证主张:bug 按报告者步骤复现,PR 则检出并运行相关测试或命令,报告确认、失败或信息不足。需要细化时运行 /grill-with-docs 逐题打磨。结果落地方式包括:ready-for-agent 发布 agent brief 评论;ready-for-human 采用相同结构但说明为何不能委托;paused 保留 brief 并注明阻塞 issue;needs-info 发布分诊笔记模板(已确立内容与仍需报告者回答的具体问题);wontfix 关闭,若已实现则指向代码位置且不写入 .out-of-scope/,若是被拒的增强则写入该知识库并链接后关闭。快速状态覆盖时,若维护者直接指定状态,先确认将要执行的角色变更、评论与关闭,再执行,跳过提问;若未经过打磨会话就移到 ready-for-agent,询问是否需要撰写 agent brief。恢复先前会话时,读取既有分诊笔记,检查报告者是否已回答未决问题,给出更新后的图景,不重复追问已解决的问题。

限制:分诊期间发布到跟踪器的每条评论或 issue 都必须以固定免责声明开头:“This was generated by AI during triage.”。所有状态与角色行为都以仓库配置和映射为前提;关于收费、价格、具体平台支持等信息暂未提供。