SuperAPI AI 工具集

process-issues

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

用途:对仓库的开放 issue 执行一次自主分诊(one tick),处理完即停止,不自行调度。可与 /loop 组合实现重复运行,例如 /loop /process-issues 或 /loop 1h /process-issues,节奏由 /loop 控制。

主要能力:它是交互式 /triage 的自主版本,运行同一状态机并复用其捆绑参考(AGENT-BRIEF.md 模板、OUT-OF-SCOPE.md 知识库、needs-info 笔记模板)。状态完全由 GitHub 的标签与评论时间戳推导,因此一次 tick 是幂等的;空队列只需一次 gh issue list 即退出。

状态路由:每个 issue 被路由到唯一规范状态,并附带一个类别角色(type: bug / type: feature / type: task)。needs-info 表示信息不足或无法复现,等待报告者;ready-for-agent 表示规格完整且通过严格门槛,附有 agent brief,交由 /implement-issues 处理;ready-for-human 表示需要人工实现;needs-triage 是维护者的停放区,wontfix、重复、超范围或范围判断都停在这里。

使用方式:先做预检,若不是 git 仓库或无 GitHub 远程则中止;本技能仅支持 GitHub(gh、issues)。检测可选基础设施:分诊标签与接线(docs/agents/triage-labels.md 映射 needs-triage / needs-info / ready-for-agent / ready-for-human / wontfix 及 issue type 轴),若缺失则建议运行 /setup-github-labels 并停止;.out-of-scope/ 目录存在则用于上下文匹配,否则跳过。构建队列包含两类:无分诊状态标签的开放 issue,以及报告者在上次分诊笔记后有回复的 needs-info issue。每次 tick 最多处理约 5 个 issue,按最旧优先,然后停止。

限制与规则:绝不关闭 issue,绝不应用 wontfix,这些由维护者决定;认为应 wontfix、重复、超范围或范围存疑时,只留下带免责声明前缀的评论并停放到 needs-triage。每条评论以“This was generated by AI during triage.”开头。跳过由其他活跃循环拥有的 issue。遇到不确定时升级,优先 ready-for-human 或 needs-triage 而非 ready-for-agent。本技能不写代码、不开 PR;标记为 ready-for-agent 的 issue 是交给 /implement-issues 的交接点,产生的 PR 由 /process-prs 处理。来自 /process-prs 的衍生 issue 和 /kaizen-codebase 的升级会带 needs-triage 标签,留给维护者,不在此重新拾取。