SuperAPI AI 工具集

platform-deploy-validate

部署与运维

查看项目

更新于 10-15 21:43

技能介绍

用途:在部署 Salesforce 元数据前先做服务端校验,提前暴露错误而不改动组织;面向生产目标时还会生成 job ID,可交给 platform-quick-deploy 做免测试的快速部署。

主要能力:优先使用 sf project deploy validate(生产)或 sf project deploy start --dry-run(沙箱/临时组织),而非直接调用 Tooling API。先用分类脚本判定目标组织类型:"${CLAUDE_PLUGIN_ROOT}/scripts/sf-deploy-gate" bucket <alias>,返回 production|sandbox|scratch|trial|unknown;仅 production 走生产路径,其余走沙箱路径,unknown 表示无法确认组织类型(通常是组织记录不完整),此时部署门仍允许部署,但该组织的保存自动部署保持关闭,重新执行 sf org login web 通常可恢复分类。

使用方式:沙箱/临时组织执行 sf project deploy start --dry-run --target-org <alias> --json,作用域参数三选一:--source-dir <path>、--metadata Type:Name、--manifest manifest/package.xml;默认不指定 --test-level,用户要求时才加 --test-level RunLocalTests。生产执行 sf project deploy validate --target-org <alias> --json --test-level RunLocalTests,生产校验必须带测试级别,用户明确列出测试时改用 RunSpecifiedTests --tests <ClassName>。生产校验返回 result.id,有效期 10 天,需持久化到 .sfdx/last-validation.json 供快速部署使用。

失败排查:解析 result.details.componentFailures 与 result.details.runTestResult.failures,列出前 5 个组件错误与测试失败及堆栈,给出组件名到可能原因(依赖缺失、FLS、语法等)的修复建议,且不得改动与校验无关的元数据。

限制与规则:所有 CLI 调用必须加 --json;面向生产绝不可跳过校验,也不得用本技能对生产执行 sf project deploy start;校验期间禁止使用 --ignore-errors 或 --ignore-warnings;用户要求直接部署到生产时,先校验再交给 platform-quick-deploy。输出以校验通过(指向 platform-quick-deploy 并附 job ID 与到期日,非生产则指向 platform-metadata-deploy)或校验失败(分类错误列表与下一步迭代建议)结尾。