qoderwake支持串行、并行及混合编排工作流：串行需设mode: sequential并确保output_key被后续step唯一引用；并行需设mode: parallel并配置branches与convergence策略；混合编排中parallel_subflow须配套subflow.yaml且必须定义merge_skill输出，否则下游因变量缺失报错。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要把多个原子Skill串起来完成一个完整业务动作，比如先分析需求再生成代码最后跑测试，而不是每次只调用单个Skill孤立执行。

配置串行工作流：A→B→C按序执行

第一步：在QoderWake CLI中新建workflow.yaml文件，内容必须包含mode: sequential字段，否则系统默认按单步模式运行。

第二步：定义steps数组，每个元素对应一个Skill调用，注意output_key必须唯一且被后续step的input引用——【spec_doc】和【source_code】这类键名不能拼错，否则B拿不到A的输出，整个链路会静默中断。

第三步：执行qoderwake workflow deploy --file workflow.yaml，部署成功后系统自动生成唯一workflow_id，可用于后续触发或调试。

并行分支处理：A、B、C同时启动

方法一：修改workflow.yaml中的mode为parallel，并添加branches数组，每个分支独立声明skill与output_key：

- skill: security_scan → output_key: sec_report
- skill: performance_test → output_key: perf_report
- skill: style_check → output_key: style_report

方法二：在branches末尾配置convergence策略，推荐使用strategy: all_complete，避免某个分支失败导致整体卡死；若选any_complete则可能漏掉关键检查项。

这一步操作起来很简单，直接把三个分支写进YAML就行，但要注意所有分支的output_key命名不能重复，否则merge_skill执行时会覆盖数据。

Agent CLI (Cursor + Qoder)

代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。

下载

混合编排：串行+并行嵌套使用

适用场景：主流程必须串行推进，但其中某一步需要并发验证多个维度。例如“代码发布”流程中，“测试编写”之后必须并行执行单元测试、集成测试、安全扫描三类检查，全部通过才进入“部署”环节。

1. 在steps数组中将并行块作为一个独立step，type设为parallel_subflow，指向外部定义的subflow.yaml文件。

2. subflow.yaml里写明branches与convergence逻辑，主workflow.yaml无需展开细节，保持主干清晰。

3. 主流程的下一步（如deploy）的input需引用subflow的合并结果，格式为${subflow_output.report_summary}，这个变量名必须和subflow中merge_skill的output_key完全一致。

如果subflow未配置merge_skill，系统不会自动聚合结果，下游step会因找不到${subflow_output.*}而报错退出——这是最容易被忽略的坑。

调试与状态追踪

执行qoderwake workflow run --id --debug后，终端实时打印每一步的输入/输出摘要，带时间戳和status标记。

查看完整执行日志：qoderwake log tail --run-id --follow，日志中每个Skill的execution_id可用来定位沙盒实例。

若某step失败，系统自动暂停后续步骤，并在QoderWake控制台【运行历史】页标记为failed，点击该记录可展开错误堆栈与上下文快照。