sf-flow

sf-flow：Salesforce Flow 创建与验证

当用户需要设计 Flow 或处理 Flow XML时使用此技能：记录触发、屏幕、自动启动、计划触发或平台事件 Flow，包括验证、架构选择和安全的部署顺序。

此技能负责的任务

以下工作请使用 sf-flow：

• .flow-meta.xml 文件
• Flow Builder 架构和 XML 生成
• 记录触发、屏幕、计划触发、自动启动或平台事件 Flow
• Flow 专属的批量安全、故障路径和子流程编排

以下情况请委派给其他技能：

• 编写以 Apex 为先的自动化 → sf-apex
• 优先创建对象 / 字段 → sf-metadata
• 部署元数据 → sf-deploy
• 部署后填充测试数据 → sf-data

---

首先收集所需上下文

请询问或推断：

• Flow 类型
• 触发对象 / 入口条件
• 核心业务目标
• 这是新建、重构还是修复
• 如果需要部署或验证，目标 org 别名
• 相关对象 / 字段是否已存在

---

建议的工作流

1. 选择合适的自动化工具

开始构建前，确认 Flow 是否合适，而不是使用：

• 公式字段
• 验证规则
• 汇总汇总字段
• Apex

2. 选择合适的 Flow 类型

需求	默认 Flow 类型
保存前更新同一记录	保存前记录触发型
处理相关记录 / 电子邮件 / callout	保存后记录触发型
引导式 UI	屏幕 Flow
可复用的后台逻辑	自动启动 / 子流程
计划处理	计划触发 Flow
事件驱动的声明式响应	平台事件 Flow
AI 评估路由（情感、意图、语气）	带 AI Decision 元素的自动启动 Flow

3. 从模板开始

优先使用提供的资源：

• assets/record-triggered-before-save.xml
• assets/record-triggered-after-save.xml
• assets/screen-flow-template.xml
• assets/autolaunched-flow-template.xml
• assets/scheduled-flow-template.xml
• assets/platform-event-flow-template.xml
• assets/ai-decision-template.xml
• assets/subflows/

4. 根据 Flow 防护规范进行验证

重点检查：

• 循环中没有 DML
• 循环中没有 Get Records
• 故障路径正确
• 触发条件正确
• 子流程组合安全
• AI Decision 元素不放在循环中（每次迭代都会产生额度成本）
• AI Decision 提示词包含用于提供数据上下文的合并字段引用

5. 移交部署和测试

使用：

• sf-deploy 进行部署 / dry-run
• sf-data 创建大量测试数据

---

高优先级规则

Flow 架构

• 保存前用于更新同一记录的字段
• 保存后用于处理相关记录、电子邮件和 callout
• 不要循环遍历 $Record
• 逻辑变得冗长或重复时使用子流程

批量安全

• 循环中没有 DML
• 循环中没有 Get Records
• 批量行为重要时，使用 251 条以上记录进行测试
• 如果任务是整理数据而非逐条记录分支处理，优先使用 Transform

错误处理

• 每条更改数据的路径都应进行故障处理
• 避免自引用故障连接器
• 激活风险不低时，先以 Draft 状态部署 Flow

---

输出格式

完成时，按以下顺序报告：

1. Flow 类型和目标
2. 创建或更新的文件
3. 架构选择
4. 批量处理 / 错误处理说明
5. 后续部署 / 测试步骤

建议格式：

Flow: <name>
Type: <flow type>
Files: <paths>
Design: <trigger choice, subflows, key decisions>
Risks: <bulk safety, fault paths, dependencies>
Next step: <dry-run deploy, activate, or test>

---

Flow 测试（CLI）

无需 VS Code，即可从命令行运行 Flow 测试：

# Run all flow tests
sf flow run test --target-org <alias> --json

# Run tests for a specific flow
sf flow run test --class-names MyFlow --target-org <alias> --json

# Get results for an asynchronous run
sf flow get test --test-run-id <id> --target-org <alias> --json

Flow 测试会在 org 中执行，可能需要 1-5 分钟。对于异步运行，sf flow run test 会返回测试运行 ID；之后可使用 sf flow get test 获取结果。始终使用 --json 运行，并对较长的运行使用后台执行。

---

跨技能集成

需求	委派给	原因
先创建对象 / 字段	sf-metadata	架构就绪
部署 / 激活 Flow	sf-deploy	安全部署顺序
创建逼真的批量测试数据	sf-data	部署后验证
创建 Apex 操作 / 可调用项	sf-apex	命令式逻辑
在屏幕 Flow 中嵌入 LWC	sf-lwc	自定义 UI 组件
向 Agentforce 暴露 Flow	sf-ai-agentscript	Agent 操作编排

---

参考索引

从这里开始

• references/flow-best-practices.md
• references/flow-quick-reference.md
• references/orchestration.md
• references/testing-guide.md

设计 / 编排

• references/subflow-library.md
• references/governance-checklist.md
• references/transform-vs-loop-guide.md
• references/orchestration-guide.md
• references/orchestration-parent-child.md
• references/orchestration-sequential.md
• references/orchestration-conditional.md

AI 决策

• references/ai-decision-guide.md

屏幕 / 集成 / 故障排除

• references/form-building-guide.md
• references/integration-patterns.md
• references/lwc-integration-guide.md
• references/agentforce-flow-integration.md
• references/xml-gotchas.md
• references/testing-checklist.md
• references/wait-patterns.md
• assets/

---

评分指南

分数	含义
88+	可用于生产环境的 Flow
75–87	良好的 Flow，但有一些需要审核的事项
60–74	功能正常，但需要更完善的防护措施
< 60	部署不安全 / 不完整