用途:通过 sf CLI 立即执行 Salesforce org 操作,而非生成脚本。要求所有命令使用 Bash 工具,并始终加 --json 输出结构化结果;不调用 mcp__salesforce_dx__* 工具执行创建、快照或打开操作。
主要能力:创建临时组织(按 edition、定义文件、快照、组织形状);列出组织;显示组织信息;恢复异步或超时的创建任务;删除组织;打开组织(仅启动浏览器,不加 --json)。有输出目录时按要求写入 JSON 工件,如 scratch-org-result.json、scratch-org-list-result.json 等;open 操作不写工件。
必要用法:创建组织的命令形如 sf org create scratch --definition-file <path> --target-dev-hub <alias> --alias <name> --json;按 edition 用 --edition developer;按快照用 --snapshot <snapshot-name>;按组织形状用 --source-org <source-org-id>(15 位组织 ID,不截断不猜测)。创建前需解析并显式传入具体 Dev Hub;解析可用 sf config get target-dev-hub --json,或多桶过滤 sf org list --json | jq -r '[.result.devHubs[]?, .result.nonScratchOrgs[]?, .result.other[]?, .result.sandboxes[]?, .result.scratchOrgs[]?] | map(select(.isDevHub == true).username) | unique | .[]'。若无法解析 Dev Hub 应停止并建议 sf org login web --set-default-dev-hub,不得编造别名。创建成功后须运行 sf org list --json 并提取对应组织对象写入工件。列出用 sf org list --json;显示用 sf org display --target-org <alias> --json,不添加 --verbose;恢复用 sf org resume scratch --job-id <id> --json;删除先确认再执行 sf org delete scratch --target-org <alias> --no-prompt --json;打开仅用 sf org open 及相关参数,不加 --json 或 --url-only。
适用场景与限制:适用于 Salesforce 开发运维中的临时组织生命周期管理,如创建、查看、恢复、删除和打开。限制包括:需要已认证的 Dev Hub;删除不可撤销;禁止使用 --verbose 或 --url-only 暴露凭据;不得编造 Dev Hub 名称或作业 ID;批次创建需循环并各自写入工件;错误处理时不自动重试或修改定义文件。部分详细流程需加载 references 目录下对应文件。官方文本暂未提供。