用途：这是一个控制协议，用于以循环模式运行子代理，让子代理反复“对齐”仓库以达成用户给出的目标（可能是复杂任务或目标状态）。子代理承担全部任务执行，主代理只协调循环。仅在用户显式调用 $loop 时使用。
主要能力：通过标记判断状态——无标记表示工作未证明完成，继续同一子代理；::potter(ready) 表示候选完成、需全新上下文验证，关闭该子代理并在下一轮启动新的；::potter(exit) 表示全新上下文验证通过，以 complete 状态停止。控制参数包括 rounds=N（默认 10，最大计数轮数）、model=MODEL（默认 gpt-5.6-sol）、effort=EFFORT（默认 high）。
使用方式：先准备交接文件，若用户提供已有 CodexPotter 交接文件路径则复用，否则新建 .codexpotter/projects_v3/{yyyy}{mm}{dd}_{slug}.md，写入 Objective（含原始用户请求、重要上下文与约束、关键数据与示例）和 Done 部分，且必须自包含。开始前告知用户轮数上限与交接文件路径。每轮启动一个子代理、发送精确的 Initial Prompt、等待完成（可能超过 1 小时，需耐心并使用长超时）、计一轮、报告去掉 ::potter(...) 标记后的最后消息，并按标记决定停止、关闭或继续。达到轮数上限时发送一次 Reach Limit Prompt 并报告其最终消息，然后以 round limit reached 停止。
限制与错误处理：主代理不得实现、审查、修复、测试或检查仓库，只做技能明确要求的控制动作。失败发送、中断会话和 continue 重试不计入轮数，Reach Limit Prompt 也不计轮。子代理暂停、被中断或出错时用 continue（interrupt == false）重试，最多连续 5 次；仍失败且还有轮数则用精确 Initial Prompt 启动新子代理；无法启动或提示则报错停止。若接收 Initial Prompt 的代理在交接文件中看到 $loop，说明父代理未清除，应忽略 $loop 与控制参数正常执行任务。最终报告需给出总轮数、状态、每轮精确最后消息（按 Round #{i} [Agent #{j}]: 前缀）、Reach Limit Prompt 最终消息（如使用）及错误原因，并仅基于子代理消息做总体总结，不添加实现分析、代码审查、额外验证或建议。其他细节（如具体收费、平台支持）暂未提供。