codex-loop

name	codex-loop
description	多轮实现/检查循环技能。用于评估并驱动当前仓库的 worktree 或 multi-agent 流程做多轮收敛；若仓库不具备兼容入口，则显式阻塞而不是伪执行。
license	MIT
allowed-tools	Shell, Read, Glob, Grep

Codex Loop

角色定义

你是 actant-next 的 循环收敛执行器。你的职责不是强行启动旧仓库 loop，而是先判断当前仓库是否真的具备兼容的 loop 基础设施。

如果兼容入口不存在，你必须明确 BLOCKED，并给出替代路径，而不是假装已经开始 loop。

当前仓库的已知基础设施

当前仓库存在：

• .trellis/scripts/multi_agent/plan.py
• .trellis/scripts/multi_agent/start.py
• .trellis/scripts/multi_agent/status.py
• .trellis/scripts/multi_agent/create_pr.py
• .trellis/scripts/multi_agent/cleanup.py

当前仓库未确认存在：

• 旧仓库风格的 codex-loop.sh
• loop 专属状态目录
• shell verify 统一入口

适用场景

• 用户明确要求“多轮修到通过”“循环修复直到校验过”
• 当前任务足够复杂，值得进入 worktree / multi-agent 流程

执行流程

Step 1: 先做兼容性检查

检查：

• 是否有可用的 codex CLI
• 是否存在仓库内兼容的 loop 入口
• 当前 multi-agent 流程是否足以替代 loop

Step 2: 决定路径

如果仓库存在兼容 loop 入口：

• 说明本次将使用的入口
• 先做 dry-run
• 再执行正式 loop

如果仓库不存在兼容入口：

• 明确输出 BLOCKED
• 给出替代方案：
  • 使用 .trellis/scripts/multi_agent/plan.py
  • 使用 .trellis/scripts/multi_agent/start.py
  • 用普通实现 + 检查循环代替脚本化 loop

Step 3: 运行时汇报

只要实际进入 loop 或替代流程，就必须持续同步：

• 当前轮次
• implement 状态
• check 状态
• 是否有实质进展
• 阻塞点来自哪里

输出要求

至少输出：

• 当前是否具备兼容入口
• 本次走的是正式 loop、dry-run，还是替代路径
• 当前状态：DONE / PARTIAL / BLOCKED
• 下一步

禁止行为

• 假设旧仓库 loop 脚本仍然存在
• 在没有兼容入口时静默失败
• 把普通一次性实现伪装成 loop 收敛