Skip to content

cxb-task-run

通过 AutoFlow 流水线执行任务步骤。

它做什么

cxb-task-run 是中大型、可恢复任务的执行引擎。它一次只推进一个步骤,对该步骤执行审查、更新任务状态,并决定流水线是否可以继续。

这样可以避免长任务退化成一串不可追踪的临时改动。

AutoFlow 10 步流水线

1. 同步状态读取 `.curdx/state.json`2. 设计当前步Claude + Codex 独立设计3. 拆分检查拆分过大的步骤4. 构建请求准备 FileOpsREQ5. 发送请求发给执行者6. 执行代码、文件、测试7. 处理回复`ok`、`ask`、`fail`8. 审查双重评估8.5 测试按需执行9-10 收尾推进状态并最终审查

各步骤说明

1. 同步状态

读取 .curdx/state.json,确定当前步骤,检查重试次数,并在任务已完成或已阻塞时立即停止。

2. 设计当前步骤

Claude 和 Codex 会分别独立提出当前步骤的实现方案,之后由 Claude 合并:

  • 实施方式
  • 完成条件
  • 风险
  • 是否需要拆分

这样可以在实际改动前先降低盲点。

3. 拆分检查

如果步骤过大,就拆成更小的子步骤。好的子步骤应当:

  • 有顺序
  • 可独立审查
  • 每个都具备实际意义

4. 构建文件操作请求

Claude 会准备一个结构化执行请求,而不是临时随手改代码。

5. 发送给执行者

请求会被路由到配置好的执行者,通常是 Codex。

6. 执行

执行模式取决于配置:

执行者配置行为
codexCodex 完整执行该步骤
opencodeCodex 监督 OpenCode
codex+opencodeCodex 负责读,OpenCode 负责写

7. 处理回复

状态含义后续动作
ok工作完成进入审查
ask执行者需要澄清向用户提出问题
fail执行者无法继续标记阻塞并记录原因

8. 审查

cxb-review 会以 step 模式运行,给出 PASS 或 FIX。

8.5 测试

测试不是每一步都自动执行。Claude 会按以下因素决定是否需要测试:

  • 改动范围
  • 风险大小
  • 是否存在相关测试

9. 收尾当前步

成功后更新:

  • .curdx/state.json
  • .curdx/todo.md
  • .curdx/plan_log.md

然后进入下一步。

10. 最终审查

当所有步骤完成后,cxb-review 会以 task 模式运行。

可能结果:

  • 小问题直接修复
  • 中等问题追加一个小步骤
  • 大问题生成后续任务

真实示例

以“为管理员写操作增加审计日志”为例,cxb-task-run 可能会:

  1. 设计 schema 扩展方案
  2. 实现存储路径
  3. 审查写入流程
  4. 运行管理员写路径相关测试
  5. 收尾并补充文档

最佳实践

  • AutoFlow 适合中大型任务,不适合一两个文件的小改动。
  • 完成条件必须可验证、具体。
  • 当任务变得模糊时,应暂停自动执行并向用户确认,而不是继续猜。
  • 审查失败不是噪音,它是在告诉你真正的问题还没解决。