SuperAPI AI 工具集

triage

办公与效率

查看项目

更新于 10-15 19:53

技能介绍

用途:triage 用于把项目问题跟踪器中的 issue(以及被配置为请求入口的外部 PR)推进过一个小型状态机,完成分类、验证、必要时追问,并写出可供智能体直接执行的简报。触发词包括 triage、triage the backlog、review these issues。该技能从 mattpocock/skills 导入(MIT),上游由用户主动调用。

主要能力:提供两个分类角色(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。维护者可随时覆盖。

使用方式:维护者调用 /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?”。展示待处理项时按最旧优先列出未标记、needs-triage、以及上次分诊后有报告者活动的 needs-info 三类,并标注 [PR] 或 [issue]。分诊具体条目时先收集上下文、解析既有分诊笔记、按领域词汇探索代码库,并做冗余检查与既往拒绝检查;随后给出分类与状态建议并等待指示;再验证主张(bug 复现、PR 检出并运行相关测试);必要时调用 grilling 与 domain-modeling 技能追问;最后按结果应用:ready-for-agent 发布智能体简报,ready-for-human 用相同结构但说明为何不能委派,needs-info 发布分诊笔记,wontfix 则关闭并视原因处理(已实现则指向代码位置,拒绝的增强写入 .out-of-scope/ 并链接后关闭)。

限制与注意:分诊期间发布到跟踪器的每条评论或 issue 必须以“This was generated by AI during triage.”开头。角色名是规范名,跟踪器中的实际标签字符串可能不同,映射应由环境提供;若未提供,需提示用户运行 /setup-matt-pocock-skills。发现仅覆盖外部 PR,协作者进行中的 PR 不算分诊工作,但被明确点名的 PR 无论作者都会分诊。快速状态覆盖时信任维护者并直接应用角色,跳过追问;若在未追问的情况下移到 ready-for-agent,需询问是否要写智能体简报。恢复先前会话时读取既有笔记、检查未答问题,不重复已解决的问题。参考资料包括 AGENT-BRIEF.md、OUT-OF-SCOPE.md、.agent-skills/skill-standardization/SKILL.md 及校验脚本 .agent-skills/skill-standardization/scripts/validate_skill.sh。