cxb-task-run
通过 AutoFlow 流水线执行任务步骤。
它做什么
cxb-task-run 是中大型、可恢复任务的执行引擎。它一次只推进一个步骤,对该步骤执行审查、更新任务状态,并决定流水线是否可以继续。
这样可以避免长任务退化成一串不可追踪的临时改动。
AutoFlow 10 步流水线
各步骤说明
1. 同步状态
读取 .curdx/state.json,确定当前步骤,检查重试次数,并在任务已完成或已阻塞时立即停止。
2. 设计当前步骤
Claude 和 Codex 会分别独立提出当前步骤的实现方案,之后由 Claude 合并:
- 实施方式
- 完成条件
- 风险
- 是否需要拆分
这样可以在实际改动前先降低盲点。
3. 拆分检查
如果步骤过大,就拆成更小的子步骤。好的子步骤应当:
- 有顺序
- 可独立审查
- 每个都具备实际意义
4. 构建文件操作请求
Claude 会准备一个结构化执行请求,而不是临时随手改代码。
5. 发送给执行者
请求会被路由到配置好的执行者,通常是 Codex。
6. 执行
执行模式取决于配置:
| 执行者配置 | 行为 |
|---|---|
codex | Codex 完整执行该步骤 |
opencode | Codex 监督 OpenCode |
codex+opencode | Codex 负责读,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 可能会:
- 设计 schema 扩展方案
- 实现存储路径
- 审查写入流程
- 运行管理员写路径相关测试
- 收尾并补充文档
最佳实践
- AutoFlow 适合中大型任务,不适合一两个文件的小改动。
- 完成条件必须可验证、具体。
- 当任务变得模糊时,应暂停自动执行并向用户确认,而不是继续猜。
- 审查失败不是噪音,它是在告诉你真正的问题还没解决。