SuperAPI AI 工具集

triage

办公与效率

查看项目

更新于 10-15 21:08

技能介绍

Triage 将项目 issue 跟踪器中的 issue 沿精简的分类状态机流转。分类过程中发布到跟踪器的每条评论或 issue 必须以“此内容由 AI 在分类过程中生成。”开头。

用途:帮助维护者评估收到的 bug 或功能请求,管理 issue 工作流,并为 AFK agent 准备规格完备的 issue。

角色:两种类别角色 bug(出现问题)与 enhancement(新功能或改进);五种状态角色 needs-triage、needs-info、ready-for-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;维护者可随时覆盖,对不寻常转换需标记并询问。

调用方式:维护者调用 /triage 并用自然语言描述需求,例如“给我看看需要我关注的内容”“我们来看看 #42”“把 #42 移到 ready-for-agent”“有哪些 issue 可以先让 agent 接手?”。

展示关注内容:查询跟踪器,按未标记、needs-triage、needs-info 且报告人有新活动三类,每类内部最旧优先排列,显示数量与一句话摘要。

分类特定 issue:收集上下文(正文、评论、标签、报告人、日期,解析已有分类注释,探索代码库,读取 .out-of-scope/*.md);给出类别与状态建议及理由;仅对 bug 先尝试复现;如需细化运行 /grill-with-docs;落实结果:ready-for-agent 发布 agent brief 评论,ready-for-human 结构相同但注明不可委托原因,needs-info 发布分类注释,wontfix(bug)礼貌解释后关闭,wontfix(enhancement)写入 .out-of-scope/ 并链接后关闭,needs-triage 打标签。

快速状态覆盖:维护者明确要求时信任并直接打标签,确认操作后执行,跳过深入审查;若移到 ready-for-agent 且未做深入审查,询问是否撰写 agent brief。

Needs-info 模板包含“目前已确定”与“仍需你提供(@报告人)”,问题需具体可执行。恢复会话时阅读已有分类注释,检查报告人是否已回答,不重复询问已解决问题。

限制:实际标签字符串依赖配置;状态冲突需人工确认;复现失败或信息不足时倾向 needs-info;具体平台与安装方式暂未提供。