SuperAPI AI 工具集

triage

智能体与模型

查看项目

更新于 10-15 21:39

技能介绍

triage 用于在项目问题跟踪器上推进 issue(以及被视为请求入口的外部 PR)流转。开始面向仓库的工作前需阅读 ../../WORK-ROUTING.md,它规定了项目文档、lane 选择、计划归属与收尾的共享路由。

用途与角色:两类 category 角色——bug(损坏)与 enhancement(新功能或改进);五个 state 角色——needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。每个已分诊 issue 应恰好带一个 category 与一个 state。状态冲突时应标记并先询问维护者。角色名为规范名,跟踪器中的实际标签串可能不同,映射缺失时运行 /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”“哪些已可供智能体接手”。

展示待办:查询跟踪器并分三组(最旧在前):未加标签、needs-triage、以及上次分诊后有报告者活动的 needs-info。PR 在范围内时一并列入并标记 [PR] 或 [issue],发现阶段只呈现外部 PR。

分诊具体条目:读取完整内容、评论、标签、作者与日期,PR 还需看 diff;解析既有分诊笔记以免重复提问;用领域词汇探索代码库并遵守 ADR。运行两项检查:冗余性(按领域概念搜索已有实现并说明查找位置,若已实现则按 wontfix 处理)与既往拒绝(读取 .out-of-scope/*.md 并列出相似项)。随后向维护者给出 category 与 state 建议及理由,并等待指示。

验证:对 bug 按报告步骤复现;对 PR 确认 diff 是否如所述(检出并运行相关测试或命令)。报告 confirmed(含代码路径)、failed 或细节不足(强烈的 needs-info 信号)。

追问:如需补全,运行 /grilling 与 /domain-modeling,逐轮提问,并同步更新 CONTEXT.md/ADR。

应用结果: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 直接应用角色。

快速覆盖:维护者直接要求移动时按指示执行,确认角色变更、评论与关闭后操作,跳过追问;若移到 ready-for-agent 且未追问,询问是否要写 agent brief。

恢复会话:读取既有分诊笔记,检查报告者是否回答待解问题,呈现更新情况,不重复已解决的问题。

限制:所有在分诊期间发布到跟踪器的评论或 issue 必须以“This was generated by AI during triage.”免责声明开头。资料未提供具体平台绑定、费用或效果说明。