用途:处理 Salesforce 元数据部署编排类任务,包括 sf project deploy start、quick、report 及元数据检索流程,发布顺序规划(自定义对象/字段、权限集、Apex、Flow),CI/CD 校验门禁与测试级别选择,部署失败排查与依赖排序,以及 scratch org、沙盒相关操作与安全上线排序。
主要能力与顺序:默认部署顺序为自定义对象与字段→权限集→Apex→Flow 先以草稿部署→Flow 激活与验证。推荐流程为:预检(sf --version、sf org list、sf org display --target-org <alias> --json、test -f sfdx-project.json),先用 --dry-run 校验,例如 sf project deploy start --dry-run --source-dir force-app --target-org <alias> --wait 30 --json;再按最小正确范围部署,如 sf project deploy start --source-dir force-app --target-org <alias> --wait 30 --json、sf project deploy start --manifest manifest/package.xml --target-org <alias> --test-level RunLocalTests --wait 30 --json,或校验成功后用 sf project deploy quick --job-id <validation-job-id> --target-org <alias> --json;随后用 sf project deploy report --job-id <job-id> --target-org <alias> --json 验证测试、Flow 状态、权限分配与冒烟行为,并清晰汇报部署、失败、跳过项与下一步安全动作。
使用方式与边界:仅使用 sf CLI v2。在非源跟踪组织中,部署/检索命令须显式指定 --source-dir、--metadata 或 --manifest 范围。元数据写入前的对象、字段、Apex、Flow 编写及测试数据创建、Agentforce 智能体编写由对应技能负责,本技能只编排部署与发布顺序。
限制与注意:资料未提供具体定价、平台支持版本等未提及信息;Flow 应在验证后再激活;部署失败常见于依赖缺失、校验规则副作用、测试脆弱或权限集顺序错误,需先补齐被引用元数据并重新校验。