SuperAPI AI 工具集

implement-issues

智能体与模型

查看项目

更新于 10-15 23:57

技能介绍

用途:该技能每次调用只实现一个 ready-for-agent 的 GitHub issue,端到端完成后停止;可通过 /loop 设置重复节奏(如 /loop /implement-issues 或 /loop 1h /implement-issues),由 /loop 控制调度,技能自身不安排自身。它是 process-issues → implement-issues → process-prs 三阶段流水线的中段,前一阶段产出的 ready-for-agent issue 在此被实现,产出的 PR 交由 process-prs 完成审查与结论。

主要能力:状态完全从 GitHub 推导(labels、assignees、branches、open PRs),因此一次 tick 是幂等的;无可抓取 issue 时只执行一次 gh issue list 即退出。

使用方式:先做预检,若不在 git 仓库或无 GitHub remote 则中止;若仓库没有 ready-for-agent 标签则无事可做并退出。抓取条件为 ready-for-agent、未分配、无其他活跃 loop 占用、无对应分支或开放 PR,取最旧的一个(使用 gh issue list --state open --label ready-for-agent --json number,title,createdAt,assignees --jq '[.[] | select((.assignees | length) == 0)] | sort_by(.createdAt) | .[0]')。issue 必须带有 agent brief(triage 技能的 AGENT-BRIEF.md 契约);若只有 ready-for-agent 而无 brief,则评论、移除标签、加 needs-triage 并停止,不得仅凭标题实现。认领方式为在隔离 worktree 中创建分支(git wt feat/<N>-slug 或按 issue 类别用 fix/<N>-slug)并执行 gh issue edit <N> --add-assignee @me。随后在 worktree 中按 brief 实现、跑通完整测试与 lint/typecheck、确认每条验收标准,并依次执行 /review-fix、提交(必要时 git-hunk skills get core logical-commits 后用 git-hunk 提交,再 /recommit),行为性变更且具备 smoke 条件时执行 /verify。最后用 /sending-pull-request 推送并打开非 draft PR,body 含 Closes #N,指派 git 用户,不加 verdict 标签。

限制:绝不合并;绝不提交猜测性 PR(brief 不充分或无法转绿则中止降级);finalize 门禁(/review-fix、/recommit、/verify)为强制项,不能以“单行/仅测试/显然正确”为由跳过;不得占用其他 loop 的 issue(仅未分配者可抓取);不得触碰 clean-room/relicensing 类 issue;每条 issue 评论需以“This was generated by AI during implementation.”免责声明开头;仅支持 GitHub(gh、issues、pull requests)。

降级流程:若 brief 不充分或无法转绿,则移除 worktree 与分支、解除指派、发布带免责声明的评论说明具体阻塞、更换标签(gh issue edit <N> --remove-label ready-for-agent --add-label <state>,state 为 needs-info 或 ready-for-human),不开 PR。

其它:官方文本暂未提供。