SuperAPI AI 工具集

triage

通用与其它

查看项目

更新于 10-16 01:20

技能介绍

用途:通过一组“分诊角色”组成的小型状态机,推进问题跟踪器中的 issue 流转。维护者以自然语言调用 /triage,例如“Show me anything that needs my attention”“Let's look at #42”“Move #42 to ready-for-agent”“What's ready for agents to pick up?”,技能据此解释并执行操作。

角色:类别角色两个——bug(某处损坏)、enhancement(新功能或改进)。状态角色五个——needs-triage(维护者需评估)、needs-info(等待报告者补充信息)、ready-for-agent(已完整定义,可由 AFK agent 处理)、ready-for-human(需人工实现)、wontfix(不予处理)。每个已分诊 issue 应恰好携带一个类别角色和一个状态角色;若状态角色冲突,先标记并向维护者确认再继续。角色名是规范名称,跟踪器中的实际标签字符串可能不同,映射应由用户提供,否则运行 /setup-matt-pocock-skills。

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

使用方式:展示待处理事项时,查询跟踪器并按最早优先呈现三类——未标注(从未分诊)、needs-triage(评估中)、needs-info 且上次分诊记录后报告者有活动(需重新评估),给出计数与每 issue 一行摘要,由维护者选择。分诊具体 issue 时:先收集上下文(完整正文、评论、标签、报告者、日期,解析既往分诊记录避免重复提问,结合项目领域词汇表与 ADR 探索代码库,阅读 .out-of-scope/*.md 并提示相似的历史拒绝);给出类别与状态建议及理由和简要代码库摘要,等待指示;仅对 bug 尝试复现(读步骤、追踪代码、运行测试或命令,报告成功复现及代码路径、复现失败或细节不足);必要时运行 /grill-with-docs 细化;最后按结果应用:ready-for-agent 发布 agent brief 评论(AGENT-BRIEF.md),ready-for-human 用相同结构但说明为何不能委托,needs-info 发布分诊笔记,wontfix(bug)礼貌解释后关闭,wontfix(enhancement)写入 .out-of-scope/ 并在评论中链接后关闭(OUT-OF-SCOPE.md),needs-triage 应用角色。快速状态覆盖:若维护者直接要求移动到某状态,信任并直接应用,确认要执行的动作后操作,跳过细化;若在未细化的情况下移到 ready-for-agent,询问是否要写 agent brief。恢复会话时读取既往分诊笔记,检查报告者是否已回答未决问题,呈现最新情况后继续,不重复已解决的问题。

限制:分诊期间发布到跟踪器的每条评论或 issue 必须以免责声明开头:“This was generated by AI during triage.”。needs-info 模板中“已确立内容”要记录细化期间已解决的事项,问题必须具体可执行,不能写“请提供更多信息”。技能依赖用户提供的角色名到实际标签的映射。资料未说明具体跟踪器平台、安装方式、价格或支持的模型。