SuperAPI AI 工具集

triage

办公与效率

查看项目

更新于 10-16 01:14

技能介绍

用途:把项目 issue 跟踪器中的 issue(以及被当作请求入口的外部 PR)沿一套小型状态机推进,完成分类、验证、追问与简报撰写。

主要能力:两类分类角色 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,例如查看需要关注的事项、查看 #42、把 #42 移到 ready-for-agent、查看哪些可供智能体接手。查看待办时按最旧优先列出未标注、needs-triage、以及上次分诊后有报告者活动的 needs-info 三类,PR 在范围内时标注 [PR] 或 [issue]。分诊具体条目时先收集上下文(正文、评论、标签、作者、日期,PR 还看 diff),解析既有分诊笔记,按领域词汇探索代码库并遵守 ADR;做冗余检查(按领域概念搜索已有实现)与既往拒绝检查(读 .out-of-scope/*.md)。随后给出分类与状态建议并等待指示,再验证主张(bug 按步骤复现,PR 检出并运行相关测试或命令),必要时用 /grilling 与 /domain-modeling 追问。结果落地:ready-for-agent 发布智能体简报评论;ready-for-human 用相同结构并说明为何不能委派;needs-info 发布分诊笔记;wontfix 按原因关闭(已实现则指向代码位置,不写入 .out-of-scope/;拒绝的 bug 礼貌说明后关闭;拒绝的 enhancement 写入 .out-of-scope/ 并在评论中链接后关闭);needs-triage 直接应用角色。快速状态覆盖时信任维护者直接应用,跳过追问;若在无追问会话下移到 ready-for-agent,询问是否撰写智能体简报。

限制与约束:分诊期间发布到跟踪器的每条评论或 issue 必须以“This was generated by AI during triage.”免责声明开头。角色名为规范名,跟踪器实际标签字符串可能不同,映射应由环境提供,否则运行 /setup-utarn-skills。发现仅呈现外部 PR,协作者进行中的 PR 不算分诊工作,但被明确点名的 PR 无论作者都会分诊。恢复先前会话时读取既有笔记、检查未答问题,不重复已解决的问题。参考资料包括 AGENT-BRIEF.md 与 OUT-OF-SCOPE.md。