SuperAPI AI 工具集

triage

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:按项目 issue 跟踪器的规则,把 issue 及外部 PR 推进一套小型状态机,完成分类、验证与分诊记录,必要时生成可供智能体执行的 brief。

主要能力:为每个条目设置恰好一个分类角色(bug 或 enhancement)和一个状态角色(needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix)。状态流转通常从未标注进入 needs-triage,再转 needs-info、ready-for-agent、ready-for-human 或 wontfix;needs-info 在报告者回复后回到 needs-triage。维护者可随时覆盖,异常流转需先确认。分诊期间所有评论须以指定 AI 声明开头。查询时按最旧优先列出未标注、needs-triage、以及有报告者新活动的 needs-info 三类,并标注 [PR] 或 [issue]。处理具体条目时读取正文、评论、标签、作者、日期及 PR diff,解析既往分诊记录,按领域词表与 ADR 探索代码库,检查是否已实现及 .out-of-scope/ 中是否已有相似拒绝记录,再给出建议并等待指示。验证环节对 bug 复现、对 PR 检查 diff 并运行相关测试或命令,报告 confirmed、failed 或 insufficient detail。需要补全时调用 grilling 与 domain-modeling 技能,进行多轮追问并更新 CONTEXT.md/ADR。结果落库方式:ready-for-agent 发布 agent brief;ready-for-human 采用相同结构并说明不可委派原因;needs-info 发布含 Triage Notes 的模板评论;wontfix 时按原因关闭(已实现则指明位置且不写入 .out-of-scope/,拒绝的 enhancement 写入并链接后关闭);needs-triage 则打角色标签。用法:由维护者调用 /triage 并用自然语言描述需求,例如查看待处理项、查看指定条目、移动到某状态或询问哪些可由智能体接手;快速状态覆盖时直接应用角色并确认操作,跳过追问,若直接移到 ready-for-agent 需询问是否撰写 agent brief。恢复上次会话时先读既往笔记,确认未答问题再继续,避免重复提问。限制:角色实际标签字符串可能不同,需要预先提供映射,否则提示运行 /setup-matt-pocock-skills;外部 PR 的判定由跟踪器配置定义;分类与状态选择须以维护者确认为准。其他细节暂未提供。