execute 是一个计划驱动编排器(Plan-Driven Orchestrator),本身不做具体实现,而是负责分派 worker、管理并行、验证结果。
用途:先解析输入为有效的 plan.json,再按任务调度 worker 构建系统。调用形式为 /execute [<spec_dir>] [--work worktree|branch|no-commit]。无参数时合成虚拟计划;有参数时目录或文件须存在,且包含 plan.json 或 requirements.md,否则报错终止。
主要能力:
- 计划解析与初始化:识别 plan、requirements、virtual 三种输入模式;plan 模式直接校验,requirements 模式优先走 /blueprint,失败则内联生成任务图,virtual 模式基于会话上下文合成计划并需用户确认。所有计划状态通过 hoyeon-cli plan 命令读写,不直接编辑 plan.json。
- 用户配置:依次询问分派模式(Direct/Agent/Team,依据任务数与 parallel_safe 比例给推荐)和验证深度(Light/Standard/Thorough,依据 verify_plan 的 gate 分布),以及工作模式(Worktree、新建分支提交、当前分支提交、不提交)。
- 委派与并行:worker 执行任务,未被阻塞的任务通过 run_in_background 并行;跨模块约定由 contracts.md 指导,worker 只接收路径与 ID,不内联正文。上下文前向流动,worker 写 learnings,下一轮 worker 读取。
- 运行环境适配:Claude Code 使用 Agent、Task、Team、AskUserQuestion 等接口,逻辑子代理名保持 worker、verifier、code-reviewer;Codex v1 为 Bash-first 且无 MCP,逻辑 Agent 调用映射为 spawn_agent,适配器名为 hoyeon-worker、hoyeon-verifier、hoyeon-code-reviewer。
- 可恢复性:重启或重复调用时以 plan.json 为准,status 为 done 的任务跳过。
限制:编排器不得读取 requirements.md 或 contracts.md 正文,只能读结构化字段;Codex v1 不依赖 hooks、TeamCreate 或自动停止转换;脚本 scripts/codex-execute-smoke.sh 仅验证单 worker 计划状态转换,不证明并行子代理行为。原文未提供安装命令、收费与价格信息。