Agent Skills
› forcedotcom/sf-skills
› dx-org-switch
dx-org-switch
GitHub通过 Salesforce CLI 切换默认目标 Org。支持指定别名或用户名，自动列出已认证 Org 供选择。区分本地（默认）和全局配置范围，并提供设置后的验证步骤及故障排查建议。
Trigger Scenarios
用户要求切换 Salesforce Org
用户希望更改 CLI 命令的目标环境
用户提及使用特定别名、沙盒或生产环境
Install
npx skills add forcedotcom/sf-skills --skill dx-org-switch -g -y
SKILL.md
Frontmatter
{
"name": "dx-org-switch",
"metadata": {
"version": "1.0"
},
"description": "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.",
"compatibility": "Salesforce CLI (sf) v2+"
}
Steps
- Identify the org: the user provides a username or alias (
orgIdentifier). If not provided, runsf org listto 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 webif the org may not be authorized.
- Local (default):
- 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-organdtarget-dev-hub. Legacy sfdx keys (defaultusername,defaultdevhubusername) are deprecated in this context. - The sf CLI does not have
--localor--scopeflags for config set. Local scope is the default behavior. - If the org does not change after setting the config, check whether
SF_TARGET_ORGis set — environment variables override config values. - Salesforce CLI config (unified) reference: https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_config_commands_unified.htm#cli_reference_config_set_unified
Version History
- 1.29.0 Current 2026-07-05 18:49
