TRAE Work自定义工作流：3步完成分支逻辑配置

[1] 一句话结论 #

本指南将手把手教你完成TRAE Work自定义工作流的分支逻辑配置。

[2] 适用场景与不适用场景 #

适用场景

1. 适合日均触发次数100次以上、需要根据前置节点执行结果自动分流的团队协作工作流场景，比如需求评审后根据通过/不通过走不同流程。
2. 适合需要多门禁校验的研发交付工作流，可根据不同检查项结果自动回流或进入下一阶段。
3. 适合带关键词触发的客户服务工作流，可根据输入内容自动匹配对应服务分支。

不适用场景

1. 单次触发后需要人工随机选择分支的场景，不建议用自动分支逻辑，建议参考TRAE Work人工审批节点方案。
2. 分支规则变更频率超过每日3次的超灵活场景，不建议用固定条件分支，建议参考TRAE Work动态规则配置方案。
3. 单工作流分支数量超过20个的超复杂场景，不建议单画布配置，建议拆分为多个子工作流串联实现。

[3] 前置准备 #

• 开发环境：TRAE Work 桌面端v2.1.0+ 或 Web端最新版本
• 账号权限：TRAE Work团队版账号，拥有工作流编辑权限
• 依赖项：无额外SDK依赖，需提前梳理好分支判断规则和各分支后续流程
• 预计耗时：15-30分钟（根据分支复杂度略有差异）

[4] 分步实现 #

步骤1：配置主流程阶段与门禁分支规则

步骤说明：首先拆分主流程的各个阶段，明确每个阶段的校验维度，提前定义好分支、异常、逆向流程的触发条件，这一步是后续分支节点配置的依据，跳过会导致后续分支逻辑混乱。
操作：进入Skill配置界面，在「阶段配置」模块添加主流程节点，为每个阶段设置对应的门禁检查项，比如产品方案评审阶段设置“方案得分≥80分”、“相关负责人已确认”两个检查项，分别对应通过/修改/驳回三个分支的触发条件。
预期结果：阶段配置列表展示所有主流程节点和对应的门禁规则，状态显示“已生效”。

⚠️ 常见错误：配置门禁规则时设置了重复的触发条件，导致分支匹配冲突，两个分支同时被触发
原因：多个规则的判断逻辑存在重叠区间，系统无法判断优先执行哪个分支
解决方法：在「规则优先级」设置中调整各分支规则的权重，优先级高的规则先匹配，同时确保各规则的判断条件互斥。

步骤2：画布添加条件分支节点

步骤说明：在工作流画布中需要分流的节点后添加条件判断节点，关联第一步设置的门禁规则，明确不同规则对应的后续执行路径，这一步是分支逻辑的核心配置环节，节点连线错误会直接导致流程走偏。
操作：打开工作流空白画布，在需要分流的节点后点击「添加工具节点」，选择「条件判断」类节点，在节点配置面板中关联提前设置好的门禁规则，拖拽连线将“满足规则”和“不满足规则”的出口分别指向不同的后续执行节点，比如满足“方案得分≥80分”的连线指向研发排期节点，不满足的指向方案修改节点。
配置示例：

{
  "condition_node_id": "cond_001",
  "rules": [
    {
      "rule_name": "方案评审通过",
      "expression": "{{pre_node.result.score}} >= 80 && {{pre_node.result.approved}} == true",
      "next_node_id": "dev_plan_001"
    },
    {
      "rule_name": "方案需要修改",
      "expression": "{{pre_node.result.score}} >= 60 && {{pre_node.result.score}} < 80",
      "next_node_id": "plan_modify_001"
    }
  ],
  "default_next_node_id": "plan_reject_001"
}

预期结果：画布中条件节点的所有出口都已连线，无悬空节点，配置面板显示“规则校验通过”。

⚠️ 常见错误：没有配置默认分支，当所有规则都不满足时工作流直接报错中断
原因：遗漏了兜底的默认分支配置，系统无法找到对应的后续执行节点
解决方法：在条件节点配置中添加「默认分支」，将所有未匹配规则的请求统一指向兜底处理节点（比如人工审核节点）。

步骤3：配置分支触发与响应规则

步骤说明：针对需要根据输入内容或外部接口返回结果触发的分支，配置对应的触发和响应逻辑，实现自动化的分支切换，无需人工干预。
操作：在条件节点的「触发配置」模块添加触发规则，比如设置“当用户输入包含‘修改需求’关键词时，自动触发需求变更分支”，同时配置分支对应的响应动作，比如先输出变更影响范围确认单，等待人工确认后再执行后续操作。
预期结果：触发配置列表展示所有设置的触发规则，测试时输入对应关键词可自动跳转到指定分支。

[5] 实际验证 #

测试用例：我们以需求评审工作流为例，输入测试数据：{"plan_score": 75, "approved": false, "input_content": "我要修改这个需求"}
预期输出：工作流自动触发“方案需要修改”分支，同时匹配到“修改需求”关键词，弹出变更影响范围确认单，状态显示“分支匹配成功”。
验证成功标志：工作流执行日志显示触发了预期的分支节点，HTTP状态码返回200，返回结果中next_node_id符合配置的规则。
验证失败常见原因及排查：1. 分支没有触发：先检查规则表达式中的变量名是否和前置节点返回的字段名一致，很多时候是变量拼写错误导致匹配失败；2. 多个分支同时触发：检查规则优先级设置，调整权重确保每次只匹配一个分支；3. 工作流报错中断：检查是否配置了默认分支，确认所有触发场景都有对应的处理节点。

[6] 常见问题 FAQ #

Q1：配置分支逻辑时最多可以支持多少个分支？
A：目前单条件判断节点最多支持15个自定义分支+1个默认分支【数据来源：TRAE官方文档v2.1.0】，如果分支数量超过这个上限，建议拆分为多个条件判断节点串联实现。

Q2：什么情况下不建议使用自动分支逻辑？
A：如果你的分支规则需要根据临时情况人工判断，或者规则变更频率超过每日3次，我们不建议使用固定的自动分支逻辑，这种场景下人工审批节点的灵活度更高，维护成本也更低。

Q3：分支规则可以调用外部接口的返回值作为判断条件吗？
A：可以，你可以在条件表达式中引用前置接口调用节点的返回字段，只需要按照{{node_id.field_name}}的格式填写变量即可，系统会自动解析对应的字段值进行判断。

Q4：我可以跳过阶段配置直接在画布添加条件节点吗？
A：可以但不推荐，阶段配置可以帮你提前梳理清楚所有分支的触发条件，避免后续配置时出现逻辑遗漏，如果你的分支逻辑非常简单（只有2个分支），也可以直接在画布中配置条件节点。

Q5：分支逻辑配置后可以随时修改吗？
A：可以，修改后需要重新发布工作流才会生效，修改前建议先导出当前版本的工作流配置作为备份，避免修改错误导致原有流程不可用。

[7] 相关阅读 #

1. 《TRAE Work工作流基础配置指南》[/docs/trae-work/basic-config]，适合新手快速了解TRAE Work工作流的基础操作
2. 《TRAE Work人工审批节点配置教程》[/docs/trae-work/approval-node]，讲解如何在工作流中添加人工审批节点，补充自动分支的不足
3. 《TRAE Work子工作流串联实现方案》[/docs/trae-work/sub-workflow]，适合超复杂工作流的拆分配置
4. 《TRAE Work规则表达式语法大全》[/docs/trae-work/rule-syntax]，详细介绍条件分支的规则表达式编写方法

[8] 参考资料 #

[1] TRAE CN官方文档：工作流规则配置，https://docs.trae.cn/work_rules，2026-08-20
[2] php.cn技术教程：Trae Work工作流程如何设置，https://m.php.cn/faq/2896264.html，2026-07-15
本文基于TRAE Work v2.1.0版本编写

[9] 文章当前生产日期 #

2026-08-28