用途:执行已批准的 Pocket 实施计划,一次一个任务或按显式并行组推进。主代理充当委派者与门禁执行者,负责协调实现者、运行机械检查、派发独立只读审查;实现者负责代码改动。没有计划时应先走 pocket-planning,而不是在此凭空生成计划。
主要能力:支持两种输入——索引清单/扁平计划(execution-plan/index.md 或扁平源计划)与阶段文件(execution-plan/phase-N.md)。核心原则是“每次委派都是一份契约,Packet 即契约,无 Packet 不派发”。包含 6 条强制铁律:先构造 Packet 再标准派发、不静默跳过门禁、无证据不信任、提示词不模糊、不静默升级、不静默引用。任务分为 Foundation、Solo、Parallel Group 三类,并行组需加载 parallel-group 参考并处理 worktree。
使用方式:每个会话先运行 npx -y pocketto-pi log init "<plan_dir>" --json --contract 3 初始化执行日志,该命令幂等、跨平台、无需安装。v4 生命周期命令使用 --json --contract 3;lifecycle transition 提交本地状态与事件,lifecycle drain 按修订顺序重放待处理事件,lifecycle repair 修复可恢复的 log.json 投影字段。派发前需运行 Entry Gate 清单,加载并引用相关参考文件,构造 Pocket Packet 后派发实现者,等待状态(DONE、NEEDS_CONTEXT、BLOCKED、DONE_WITH_CONCERNS),DONE 后进入循环审查。
适用场景:已有完整实施计划、需要可审查的委派执行、任务存在依赖或并行组、需要独立只读审查与阶段完成交接的工程流程。
限制:需要已完成的计划;主代理不得编写实现代码或自行判定代码质量与规范符合度;Core 不调用 gh、不合并 PR、不关闭 issue,可选适配器需通过兼容性预检;v3 计划保持 v3,不静默转换进度;用户显式选择其他模式或跳过门禁时须说明哪些检查未运行。其余细节暂未提供。