SuperAPI AI 工具集

triage

智能体与模型

查看项目

更新于 10-16 01:29

技能介绍

triage 用于把项目 issue tracker 上的 issue 按一个小型状态机推进;若仓库把外部 PR 视为请求入口(见 issue-tracker 配置),外部 PR 同样适用:PR 即附带代码的 issue,角色、状态与流程相同。

用途与角色:两个类别角色为 bug(某处损坏)与 enhancement(新功能或改进);五个状态角色为 needs-triage(待维护者评估)、needs-info(等待报告者补充信息)、ready-for-agent(规格完整、可交给 AFK 智能体)、ready-for-human(需人工实现)、wontfix(不予处理)。对 PR,同一状态针对所附代码理解:ready-for-agent 表示已附简报、智能体应就 diff 推进下一步;ready-for-human 表示可交人工合并。每个已分诊 issue 应恰好带一个类别角色和一个状态角色;若状态角色冲突,须标记并先询问维护者。上述为规范角色名,tracker 中实际标签字符串可能不同,映射应已提供,否则运行 /setup-matt-pocock-skills。

状态流转:未加标签的 issue 通常先进入 needs-triage,再转向 needs-info、ready-for-agent、ready-for-human 或 wontfix;报告者回复后 needs-info 回到 needs-triage。维护者可随时覆盖;对异常流转须先标记并询问再操作。

调用方式:维护者以自然语言调用 /triage 并描述需求,例如“看看需要我关注的内容”“看看 #42”“把 #42 移到 ready-for-agent”“哪些已就绪可让智能体接手”。

查看待关注项时,查询 tracker 并按由旧到新呈现三类:未加标签(从未分诊)、needs-triage(评估中)、needs-info 且自上次分诊笔记后报告者有活动(需重新评估)。PR 在范围内时纳入外部 PR,并逐行标记 [PR] 或 [issue];发现阶段仅呈现外部 PR,协作者正在处理的 PR 不算分诊工作,但被明确点名的 PR 无论作者均会分诊。展示数量与每项一行摘要,由维护者挑选。

分诊特定 issue/PR 时:先收集上下文,读取完整正文、评论、标签、作者、日期,PR 还要读 diff;解析既有分诊笔记以免重复追问已解决的问题;借助项目领域词汇表探索代码库并遵守相关 ADR。对代码库做两项检查:(a) 冗余——按领域概念(而非请求措辞)查找已有实现并报告查找位置,若已实现则为 already-implemented 的 wontfix;(b) 先前拒绝——阅读 .out-of-scope/*.md 并指出相似项。随后给出类别与状态建议、理由及与请求相关的代码库摘要(含是否已实现),等待指示。

在追问前先验证主张:bug 按报告步骤复现;PR 则检出并运行相关测试或命令确认 diff 确实实现其所称。报告结果为 confirmed(含代码路径)、failed 或细节不足(强烈的 needs-info 信号)。确认后的验证能让智能体简报更有力。若请求需充实,可同时运行 /grilling 与 /domain-modeling 技能,一轮一轮提问打磨领域术语,并在决策落定时同步更新 CONTEXT.md/ADRs。

结果落地:ready-for-agent 发布 agent brief 评论(AGENT-BRIEF.md);ready-for-human 结构相同但说明为何不可委托(判断取舍、外部访问、设计决策、手工测试);needs-info 发布分诊笔记(模板见下);wontfix 则关闭,评论依原因而定——已实现则指出代码位置且不写入 .out-of-scope/(该知识库用于被拒请求而非已构建功能);bug 被拒则礼貌说明后关闭;enhancement 被拒则写入 .out-of-scope/、在评论中链接后关闭(OUT-OF-SCOPE.md);needs-triage 则应用该角色,有部分进展时可选评论。

快速状态覆盖:若维护者说“把 #42 移到 ready-for-agent”,信任其判断并直接应用角色,先确认将要执行的操作(角色变更、评论、关闭)再动手,跳过追问;若在未经追问的情况下移到 ready-for-agent,询问是否要写 agent brief。

needs-info 模板含“Triage Notes”,下分“What we've established so far”列出已确立要点,及“What we still need from you (@reporter)”列出需报告者回答的问题,问题须具体可行,不能只是“请提供更多信息”。

恢复先前会话:若 issue 或 PR 上已有分诊笔记,读取并检查报告者是否已回答遗留问题,先呈现更新后的情况再继续,不重复追问已解决的问题。

限制:所有事实来自所给技能说明;具体 tracker 标签映射、.out-of-scope 细节与 AGENT-BRIEF.md 内容以各引用文档为准,本次资料未展开。分诊期间发布到 tracker 的任何评论或 issue 必须以“This was generated by AI during triage.”免责声明开头。