Switches the active Salesforce org (default target-org) using the Salesforce CLI. Use whenever someone wants to change which org CLI commands run against — whether they say "switch org", "change default org", "set my org to", "use alias", "point to", or describe wanting to work against a specific org, scratch org, sandbox, or production.
使用 sf config set 切换 Salesforce CLI 当前的目标组织，并包含验证步骤。
功能
该技能指导代理更改 Salesforce CLI 命令所针对的 Salesforce 组织。它通过用户名或别名识别组织，使用 sf config set 在本地或全局设置默认 target-org，并用 sf config get target-org --json 验证取值。它还涵盖失败处理，例如在组织可能未授权时建议运行 sf org login web，并说明 SF_TARGET_ORG 等环境变量会覆盖配置值。
需要 Salesforce CLI（sf）2.0.0 或更高版本以及一个已授权的组织；不包含脚本，只有说明。CLI 命令需要网络访问，并需事先完成组织授权（例如通过 sf org login web）。
Steps
Identify the org: the user provides a username or alias (orgIdentifier). If not provided, run sf org list to show authenticated orgs and ask the user which one to use.
Set the default org:
Local (default): sf config set target-org <orgIdentifier>
Applies only within the current project directory. Use this for normal project work.
Global (only if user explicitly requests): sf config set target-org <orgIdentifier> --global
Applies system-wide across all directories. Use when working outside a project or when the user asks for global scope.
If this fails, report the error and suggest running sf org login web if the org may not be authorized.
Verify:
sf config get target-org --json
Note: the JSON output does not include a scope/location field — it cannot confirm whether the value is local or global. Confirm the value only, e.g.: target-org is now set to: <value>
If it fails, report the error and advise running sf config get target-org.
Notes
Unified CLI uses keys like target-org and target-dev-hub. Legacy sfdx keys (defaultusername, defaultdevhubusername) are deprecated in this context.
The sf CLI does not have --local or --scope flags for config set. Local scope is the default behavior.
If the org does not change after setting the config, check whether SF_TARGET_ORG is set — environment variables override config values.
