用途
workflow-lite-execute 是 workflow-lite 工作流中的执行引擎,负责承接 workflow-lite-plan 的交接结果,也支持独立执行任务。它把计划中的任务转化为可执行的批次,调度不同的执行器完成代码编写,并在执行后可选地进行代码审查,最终可链到 workflow-lite-test-review 阶段。
主要能力
多模式输入
- 模式 1:内存计划(In-Memory Plan):通过 --in-memory 标志或 executionContext 全局变量触发。输入来源是 workflow-lite-plan 设置的 executionContext 全局变量。此模式会跳过执行方法与代码审查的选择(已在 LP-Phase 4 选定),直接使用完整上下文(探索、澄清、计划产物均可用)。LP-Phase 4 是唯一的确认关口,模式 1 的调用意味着用户已经批准,不再弹出提示。
- 模式 2:提示描述(Prompt Description):用户以任务描述字符串调用(例如 "Add unit tests for auth module")。引擎将提示存为 originalUserInput,创建简单执行计划,运行 selectExecutionOptions() 后继续。
- 模式 3:文件内容(File Content):用户以文件路径调用(以 .md/.json/.txt 结尾)。引擎读取文件内容,尝试 JSON 解析;若检测到包含 summary、approach、task_ids 的两层格式 plan.json,则直接使用该计划对象,并从同目录的 .task/ 加载任务文件;否则将文件内容视为提示,与模式 2 相同。
用户选择(模式 2/3 共享)
通过 selectExecutionOptions() 询问三项配置:
- 执行方法:Agent(@code-developer agent)、Codex(codex CLI 工具)、Auto(按复杂度自动选择)。
- 执行后代码审查(在 lite-execute 中运行):Gemini Review(Gemini CLI 的 git diff 质量审查)、Codex Review(Codex CLI 基于提示的代码质量审查,--mode analysis)、Agent Review(@code-reviewer agent)、Skip(不审查)。
- workflow-lite-test-review 阶段的收敛审查:Agent(验证收敛标准)、Gemini(Gemini CLI 收敛验证)、Codex(Codex CLI 收敛验证)、Skip(跳过收敛审查,仅运行测试)。
若设置了 autoYes(通过 -y 标志,仅独立模式),则直接返回 Auto 执行、跳过代码审查与收敛审查。
任务分组与批次创建
- 依赖提取:仅依据显式的 depends_on 字段,不做文件或关键词推断。
- 执行器解析:优先级为 executorAssignments[taskId] > executionMethod > Auto 回退。Auto 回退时,复杂度为 Low 用 agent,否则用 codex。
- 批次创建:独立任务按执行器分组并行执行;有依赖的任务按依赖顺序分阶段执行。若检测到循环依赖,会警告并强制处理剩余任务。
- 进度跟踪:通过 TodoWrite 展示批次级进度,⚡ 表示并行,→ 表示串行。
执行与恢复
- Agent 执行:调用 subagent_type 为 code-developer 的 Agent,run_in_background=false,但单条消息中可并发多个 Agent 调用。
- CLI 执行(codex/gemini):以后台方式运行,使用固定 ID(sessionId-groupId),gemini 用 analysis 模式,codex 用 write 模式。
- 并行规则:每个批次对应一个独立的 CLI 实例或 Agent 调用;并行即多条后台 Bash 或单条消息中多个 Agent;绝不把独立任务合并进一个 CLI 提示。
- 失败恢复:若 Bash 结果状态为 failed 或 timeout,会输出恢复命令(ccw cli -p "Continue" --resume <fixedId> ...),并记录 resumeFromCliId。
统一任务提示构建
每个任务被构建为自包含的检查清单,Agent 与 CLI 使用同一模板。模板包含:任务标题、范围与动作、文件列表、方法理由(Medium/High)、实现步骤、代码骨架(High)、参考模式与文件、风险缓解(High)、完成标准(Done when)与成功指标。整体提示还包含目标、任务、上下文(先前工作、澄清、数据流、产物、项目指南)等部分。
代码审查
若 codeReviewTool 为 Skip 则跳过。审查工具从 executionContext.codeReviewTool(模式 1)或 userSelection.code_review_tool(模式 2/3)解析,支持 gemini、codex、agent 三种。Agent 审查会调用 subagent_type 为 code-reviewer 的 Agent,审查重点包括代码质量、正确性、模式一致性、安全性和性能。
使用方式
基本调用:
<input> 任务描述字符串,或文件路径(必填)
标志:
--in-memory 模式 1:使用来自 workflow-lite-plan 交接的 executionContext(通过 Skill({ skill: "workflow-lite-execute", args: "--in-memory" }))
适用场景
- 承接 workflow-lite-plan 的计划,直接进入执行阶段。
- 独立执行单个任务描述或计划文件。
- 需要按依赖关系并行/串行调度多任务,并在执行后做代码审查的编码工作流。
限制
- 依赖提取仅支持显式 depends_on,不做推断。
- 模式 1 不再弹出确认,依赖 LP-Phase 4 的批准。
- 循环依赖会被强制处理并给出警告。
- 关于收费、价格、平台支持范围等信息,资料中暂未提供。