SuperAPI AI 工具集

codex-run-loop

编程与开发

查看项目

更新于 10-16 03:14

技能介绍

用途:当用户要求 Codex 协调多个工单、批量运行一批 issue、并行处理工单,或创建产出草稿 PR 的工作线程/worktree 时使用。若只是单个普通编码任务,除非用户明确要求此循环,否则直接编码。

主要能力与流程:

  1. 选择工作:读取工单、来源上下文、issue 跟踪器上下文与仓库状态,将工单分类为独立、依赖、冲突或不清楚。独立工单并行,依赖工单分波次,冲突工单串行,验收标准不清楚则停止。依赖工单优先用堆叠草稿 PR;若实为一个功能或高度重叠,询问是否用单一集成分支和 PR。
  2. 准备工作树:检查 git status、当前分支、远程与已有 worktree。为当前波次每个未阻塞工单,从工单 ID 与简短任务摘要派生可追溯分支名,创建独立 worktree,默认同级根目录如 ../<repo-name>-worktrees/<branch-name>。新分支用 git worktree add -b <branch> <path> <base>;仅当同一分支且干净时才复用已有 worktree。堆叠 PR 时每个依赖分支基于前一个分支;集成 PR 则在一个集成 worktree 中顺序运行依赖工单。
  3. 启动 worker:有线程工具时每个工单创建一个 Codex worker 线程;集成 PR 时在集成 worktree 中一次启动一个。向每个 worker 发送紧凑信息包:Ticket、Source context、Worktree、Branch、Base、Acceptance criteria、Verification、PR target、Pause after。若无线程工具,除非用户明确允许顺序本地执行,否则停止。
  4. 执行工单:每个 worker 线程为该工单做最小完整代码改动;用户要求时采用测试先行。worker 只负责一个工单的代码、测试与验证。
  5. 审查与修复:worker 在可用时请求代码审查子代理,修复范围内有效发现,重跑相关检查;需要人工决策或改来源上下文的发现则停止。
  6. 发布草稿 PR:worker 只暂存预期文件,创建一个清晰提交,推送分支,用可用 GitHub 工具或 gh 打开草稿 PR。PR 正文应含工单或来源链接、验收标准、验证运行、审查结果及未验证项。推送或创建 PR 失败时保留本地分支,并报告缺失的远程、认证、命令或工具能力。
  7. 暂停:每个选中工单被阻塞或已有草稿 PR 即完成,到此停止。除非明确要求,不合并、不解决 GitHub 审查、不修 CI、不启动后续改动。
  8. 报告:报告每个工单的 worker 线程、worktree 路径、分支、提交、草稿 PR URL、验证、已修复的审查发现及被阻塞工单。

规则:协调者负责路由,worker 各写一个工单;每工单一个 worktree 和分支,除非用户选择单一集成分支;只并行可独立审查、合并、回滚的工单;不覆盖、丢弃或暂存无关未提交工作;不虚构 issue 跟踪器工单或改写来源上下文;前序工单失败或改变来源上下文时跳过或停止依赖工单;判断审查发现,不盲目实现每条评论;仅在验证运行后开草稿 PR,或清楚报告无法验证项;在草稿 PR 处暂停,合并超出范围。