# sf-flow：Salesforce 流程创建和验证专家 Salesforce Flow Builder，深入了解最佳实践、批量化和 Spring '26 (API 66.0) 元数据。创建生产就绪、高性能、安全且可维护的流程。 ## 快速参考：验证脚本 python3 ~/.claude/plugins/marketplaces/sf-skills/sf-flow/hooks/scripts/validate_flow.py **评分**：6 个类别 110 分。部署最少 88 (80%)。 ** ** ## 核心职责 1. **流程生成**：根据需求创建结构良好的流程元数据 XML 2. **严格验证**：通过全面检查和评分实施最佳实践 3. **安全部署**：与 sf-deploy 技能集成，进行两步验证和部署 4. **测试指南**：提供特定类型的测试清单和验证步骤 ** ** ## 关键：编排顺序 **sf-元数据 → sf-flow → sf-deploy → sf-数据**（您在此处：sf-flow）流引用自定义对象/字段？首先使用 sf-metadata 创建。在流之前部署对象。请参阅“references/orchestration.md”以了解包括 Agentforce 在内的扩展模式。 ** ** ## 关键见解洞察 |详情 ---|--- **保存前与保存后** |保存前更新避免了第二次 DML——更改与触发记录一起提交到内存中。这是同一记录更新的最高性能模式。保存后：相关记录、电子邮件、标注 **使用 251 进行测试** |批次边界为 200。测试 251 条以上的调节器限制、N+1 模式、批量安全记录 **$记录上下文** |单个记录，而不是集合。平台处理批处理。永远不要循环 $Record **变换与循环** |转换：数据映射/整形（快 30-50%）。循环：每条记录的决策、计数器、变化的逻辑。请参阅“references/transform-vs-loop-guide.md” **自动化密度**：对于低密度对象（0-2 自动化），Flow 是官方建议。使用 **Flow Trigger Explorer**（设置 → 流程自动化）在添加新自动化之前审核现有自动化。有关完整框架，请参阅 [sf-apex/references/automation- Density-guide.md]()。 ** ** ## 表单构建需要|工具|注释 ---|---|--- 简单记录字段可见性| **动态表格** |没有代码，Lightning App Builder 配置引导向导/多步骤 | **屏幕流程** |声明式、可管理构建 Flow 中的复杂自定义 UI | **屏幕流程 + LWC** |混合 — Flow 编排、LWC 渲染 > ⚠️ **屏幕中断事务**：每个屏幕元素都会提交先前的 DML。首先收集所有输入，然后在最终屏幕后执行 DML。使用多步骤表单的回滚记录元素。 **计划流程 > Apex 可计划** 可满足大多数计划需求。计划流程是可部署的元数据、可打包，并且不计入 100 个 Apex 计划作业限制。 **参见**：[references/form-building-guide.md]() 了解 5 种工具比较、决策树、安全警告和 OmniStudio 注意事项 ** ** ## 工作流程设计（5 阶段模式） ### 第 1 阶段：需求收集 **在构建之前，评估替代方案**：请参阅 `references/flow-best-practices.md` 第 1 节 - 有时公式字段、验证规则或汇总摘要是更好的选择。 **要求用户**收集：流程类型、主要目的、触发对象/条件、目标组织别名。 **然后** ：检查现有流程（`Glob：**/*.flow-meta.xml`），从`references/subflow-library.md`提供可重用的子流程，参考`references/governance-checklist.md`以实现复杂的自动化。 ### 第 2 阶段：流程设计和模板选择流量类型|模板文件 |命名前缀 ---|---|--- 屏幕| `screen-flow-template.xml` | `屏幕_` 记录触发（之后）| `记录触发-*.xml` | `自动_` 记录触发（之前） | `记录触发-*.xml` | `之前_` 预定 | `scheduled-flow-template.xml` | `预定_` 平台活动| `平台事件流模板.xml` | `事件_` 自动启动 | `autolaunched-flow-template.xml` | `Sub_` 或 `Util_` `assets/elements/` 中的 **元素模式模板**：loop-pattern.xml、get-records-pattern.xml、record-delete-pattern.xml **格式** ：使用 PascalCase 的 `[Prefix]_Object_Action`（例如，`Auto_Lead_Priority_Assignment`） **屏幕流按钮**：所有屏幕上都需要`allowFinish =“true”`。连接器存在→“下一步”，不存在→“完成”。 **注意**：记录触发的流可以通过 XML 部署调用子流（在 API 66.0、Spring '26 上验证 E2E）。 `` 在 `` 元素上无效 - 处理子流内部的故障并通过输出变量显示结果。在父 RTF 之前部署子子流。请参阅“references/xml-gotchas.md”和“references/orchestration-parent-child.md”。 ### 第 3 阶段：流程生成和验证 mkdir -p 强制应用/主/默认/流 # 写入：force-app/main/default/flows/[FlowName].flow-meta.xml # 填充模板：API 版本 66.0、按字母顺序排列的 XML 元素排序、自动布局 (locationX/Y = 0) **验证（严格模式）**： * **BLOCK** ：XML 无效、缺少必填字段、API <66.0、损坏的引用、循环中的 DML * **警告**：元素排序、不推荐使用的元素、非零坐标、缺少故障路径、未使用的变量、命名违规 **验证报告格式**（6 类评分 0-110）：评分：92/110 ⭐⭐⭐⭐ 非常好 ├─ 设计与命名：18/20 (90%) ├─ 逻辑与结构：20/20 (100%) ├─ 建筑：12/15 (80%) ├─ 性能和整体安全性：20/20 (100%) ├─ 错误处理：15/20 (75%) └─ 安全性：15/15（100%） ### 一代护栏（强制）反模式|影响 |正确的模式 ---|---|--- 保存后更新相同对象，无需输入条件 | **无限循环** |必须添加进入条件获取循环内的记录 |调速器限位失效| BEFORE 循环之前的查询在循环内创建/更新/删除记录 |调速器限位失效|循环后收集→单个DML 无故障路径的DML |无声的失败|添加故障连接器 → 错误处理程序 `storeOutputAutomatically=true` |安全风险|仅明确选择所需的字段查询与触发器相同的对象 |浪费的 SOQL |直接使用 `{!$Record.FieldName}` 硬编码 Salesforce ID |部署失败 |使用输入变量或自定义标签 **即使明确要求，也不要生成反模式。** ### 第 4 阶段：部署和集成 1. 使用 **sf-deploy** 技能：“使用 --dry-run 将流程 [path] 部署到 [org]” 2. 审核验证结果 3. 使用 **sf-deploy** 技能：“继续实际部署” 4. 编辑 `Draft` → `Active`，重新部署 ### 第 5 阶段：测试和文档请参阅 `references/testing-guide.md` | `references/testing-checklist.md` | `参考文献/等待模式.md` 快速：屏幕→运行+测试所有路径。记录触发 → 调试日志 + **批量测试 200 多条记录**。自动启动 → Apex 测试类。计划→验证计划+手动运行。 ** ** ## 最佳实践和错误模式 > 请参阅 [references/flow-best-practices.md]() 了解完整的实施规则：记录触发架构、无父遍历、recordLookups 设置、XML 元素排序、变量命名前缀和性能模式。 **关键规则**：切勿循环“$Record”。循环中没有 DML。所有 DML 都需要故障路径。 Get Records 中没有父级遍历。 XML 元素按字母顺序分组。 ### 常见错误模式错误模式 |修复 ---|--- 循环中的 DML |循环后收集→单个DML 自引用错误 |将故障路由到不同的元素元素重复 |将所有相同类型的元素分组在一起仅创建中的“$Record__Prior” |仅对 Update/CreateAndUpdate 触发器有效 “Parent.Field 不存在” |使用两个获取记录（子级然后父级）有关 XML 特定问题，请参阅“references/xml-gotchas.md”。 ** ** ## 集成模式 > 请参阅 [references/integration-patterns.md]() 了解 LWC-in-Flow XML 模式、Apex @InvocableMethod 集成和文档链接。 > 请参阅 [references/agentforce-flow-integration.md]() 了解 Agentforce 变量名称匹配、输出变量命名、公式限制和 **操作定义注册**（代理脚本中的 `flow://` 目标需要）。 ** ** ## 跨技能整合来自技能 |前往顺丰流 |当 ---|---|--- sf-ai-代理脚本 | → sf 流 | “为代理操作创建自动启动的流程” SF-顶点| → sf 流 | “为 Apex 逻辑创建流包装器” SF-集成| → sf 流 | “创建 HTTP 调出流程” 来自 sf-flow |技能 |当 ---|---|--- sf 流 | → sf 元数据 | “描述发票__c”（在流程之前验证字段） sf 流 | → sf-部署 | “使用 --dry-run 部署流程” sf 流 | → sf 数据 | “创建 200 个测试帐户”（部署后） ## 流量测试 (CLI) sf flow run test --tests FlowTest1,FlowTest2 --target-org my-sandbox sf flow run test --test-level RunAllFlowTests --target-org my-sandbox sf flow get test --test-run-id --target-org my-sandbox > 自 v2.86.9 起正式发布。对于 Apex 测试，请参阅“/sf-testing”。对于统一运行器（Beta）：`sf 逻辑运行测试`。 ** ** ## 边缘情况场景 |解决方案 ---|--- >200 条记录 |警告限制，建议预定流量 >5 家分店 |使用子流程跨对象 |检查循环依赖，测试递归生产|部署草稿，显式激活 **调试**：流程不可见→部署报告+权限|测试失败→调试日志+批量测试|沙箱→产品失败→FLS + 依赖项 ** ** ## 注释 **依赖项**（可选）：sf-deploy、sf-metadata、sf-data | **API**：66.0 | **模式**：严格（警告块）|推荐的 Python 验证器

SF流量

包含技能