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.
