如何配置CumulusCI全面使用sf CLI替代sfdx管理Salesforce沙盒组织？

我在GitHub Actions中运行CumulusCI自动化流程管理Salesforce scratch org和部署任务，已在cumulusci.yml中配置自定义任务，明确使用sf CLI命令（如sf org create scratch），但工作流运行时CumulusCI仍内部调用sfdx CLI执行部分操作，触发如下错误：

[06/18/25 10:02:44] Creating scratch org with command: sfdx force:org:create --json  -f orgs/dev.json -w 120 -n --durationdays 30 -a AmpImpact__dev
Error: Failed to create scratch org:
 »   Warning: force org create is not a sf command.
 »   Error: Run sf help force for a list of available commands.
Run this command for more information about debugging errors: cci error --help
Apex Test failed
[06/18/25 10:02:46] Skipping org deletion: the scratch org does not exist.
Error: Process completed with exit code 1.

以下是针对「彻底停用sfdx CLI，仅使用新版sf CLI」目标的问题解答：

1. 能否配置CumulusCI在内部（包括内置组织管理）全面采用sf CLI？ #

目前CumulusCI的部分核心内置任务（如scratch org创建、组织生命周期管理）仍依赖sfdx CLI的旧命令结构，无法仅通过配置实现全流程切换到sf CLI。自定义任务可以指定sf命令，但内置的核心流程尚未完成全量替换。

2. 是否存在CumulusCI环境变量或项目设置可强制优先使用sf而非sfdx？ #

有两种方式可以强制CumulusCI优先调用sf CLI：

• 设置环境变量 CUMULUSCI_USE_SF_CLI=true，该变量会让CumulusCI在支持的场景下优先选择sf CLI
• 在项目根目录的cumulusci.yml中添加全局配置：

  cli:
    preferred: sf
  

注意：上述配置目前仅对部分任务生效，核心的组织创建等操作可能仍会回退到sfdx，需结合CumulusCI的版本更新逐步覆盖。

3. CumulusCI是否有路线图或替代方案将内部sfdx调用替换为sf等效命令？ #

CumulusCI开发团队已将替换sfdx为sf CLI列为长期路线图的核心任务，当前正逐步推进内置任务的迁移工作。现有替代方案包括：

• 对内置任务进行自定义封装，使用command类型的自定义任务替换原有内置任务，直接调用sf CLI命令
• 升级到CumulusCI v3.80及以上版本，该版本已完成部署、测试等核心环节的sf CLI适配

4. 在GitHub Actions等CI环境中，如何彻底确保不使用sfdx？ #

可通过以下步骤实现：

• 仅安装sf CLI，完全不安装sfdx CLI：CumulusCI在找不到sfdx的情况下，会强制使用已安装的sf CLI（需确保CumulusCI版本支持该 fallback 逻辑）
• 在GitHub Actions工作流中使用Salesforce官方的setup-sf Action安装sf CLI，跳过sfdx的安装步骤
• 在工作流中设置环境变量 CUMULUSCI_USE_SF_CLI=true，同时在cumulusci.yml中配置cli.preferred: sf
• 验证环节：添加工作流步骤确认sfdx未安装，仅sf存在：

  which sf && sf --version
  which sfdx || echo "sfdx not installed"
  

内容的提问来源于stack exchange，提问作者Sankalp Ghosh