SuperAPI AI 工具集

triage

办公与效率

查看项目

更新于 10-28 16:14

技能介绍

triage 用于让维护者通过一组分诊角色构成的状态机来管理项目问题跟踪器中的 issue,以及在仓库将外部 PR 视为请求面时一并管理这些 PR。调用方式为维护者输入 /triage 并用自然语言描述需求,例如“显示需要我关注的内容”“看看 #42”“把 #42 移到 ready-for-agent”“哪些已就绪可供智能体接手”。

分类与状态角色:分类角色有 bug(某处坏了)和 enhancement(新功能或改进)。状态角色有 needs-triage(维护者需评估)、needs-info(等待报告者补充信息)、ready-for-agent(已完全明确,可供 AFK 智能体处理)、ready-for-human(需人工实现)、wontfix(不予处理)。每个分诊过的 issue 应恰好带一个分类角色和一个状态角色;若状态角色冲突,需先标记并询问维护者。规范角色名与实际标签字符串可能不同,映射应已提供;若无,则提示用户运行 /setup-matt-pocock-skills。状态流转通常为:无标签先进入 needs-triage,再转向 needs-info、ready-for-agent、ready-for-human 或 wontfix;needs-info 在报告者回复后回到 needs-triage。维护者可随时覆盖,异常流转需先询问。

主要能力:一是查看待关注项,查询跟踪器并按最旧优先呈现三类:无标签(从未分诊)、needs-triage(评估中)、needs-info 且自上次分诊记录后报告者有活动(需重新评估);外部 PR 在范围内时同样纳入并标注 [PR] 或 [issue],发现阶段仅呈现外部 PR。二是分诊特定 issue 或 PR:读取完整内容(正文、评论、标签、作者、日期,PR 还包括 diff),解析既有分诊记录以免重复提问,借助领域词汇探索代码库并遵守相关 ADR;执行两项检查——冗余检查(按领域概念而非请求措辞搜索已有实现,报告查找位置,若已实现则为 wontfix)与先前拒绝检查(读取 .out-of-scope/*.md 并指出相似项)。随后给出分类与状态建议及理由,等待指示。三是验证主张:对 bug 按报告者步骤复现;对 PR 检出并运行相关测试或命令,确认其 diff 是否如声称般工作,结果为已确认(附代码路径)、失败或细节不足(needs-info 的强信号)。四是按需打磨:调用 /grilling 和 /domain-modeling,一轮轮提问完善请求、锐化领域术语并更新配置产物。五是根据结果执行:ready-for-agent 发布智能体简报评论(AGENT-BRIEF.md);ready-for-human 采用相同结构但说明为何不能委派(判断取舍、外部访问、设计决策、人工测试);needs-info 发布分诊记录模板;wontfix 则关闭,已实现时指向代码位置且不写入 .out-of-scope/,拒绝的 bug 礼貌解释后关闭,拒绝的 enhancement 写入 .out-of-scope/ 并在评论中链接后关闭;needs-triage 则应用角色,可选评论部分进展。

其他行为:快速状态覆盖时,维护者说“把 #42 移到 ready-for-agent”即信任并直接应用,确认变更后跳过打磨;若无打磨会话而移到 ready-for-agent,询问是否要写智能体简报。needs-info 模板包含“目前确立的内容”和“仍需 @reporter 提供的内容”,问题须具体可操作,不得只写“请提供更多信息”。恢复先前会话时读取既有分诊记录,检查报告者是否已回答待解决问题,呈现更新后的图景,不重复已解决问题。完成条件为:事项具有已验证的主张或明确证据缺口、可执行的简报或精确的开放问题,并在当前授权范围内记录正确的分诊状态。所有分诊期间发布到跟踪器的评论或 issue 必须以“This was generated by AI during triage.”开头。涉及 /domain-modeling 时只在任务授权编辑时通过该归属方持久化已接受的模型变更;委派工作使用 /swarm 并采用实际宿主 schema、隔离写入者和披露的降级方案。参考资料包括 AGENT-BRIEF.md(如何写持久的智能体简报)和 OUT-OF-SCOPE.md(.out-of-scope/ 知识库如何运作)。