用途:在 Salesforce 组织上启用 Dev Hub、检测其是否已开启,并查看 scratch org 配额(Active 与 Daily 上限及剩余数量),可针对默认组织或指定组织。Dev Hub 是允许创建和管理 scratch org 及 2GP/unlocked 包的组织功能。
主要能力:检测 Dev Hub 状态(ScratchOrgInfo 可查询即开启,INVALID_TYPE 即关闭);查看 scratch org 配额;配置 Dev Hub 子偏好(packaging、org shape export、scratch org snapshots);列出该 Dev Hub 创建的活动 scratch org。
主要用法:核心为捆绑的辅助脚本,必须用绝对路径调用(如 bash "<skill_dir>/scripts/devhub.sh" <alias-or-username>),不可用 ./scripts/。常用调用:不带参数查默认组织状态;--allocation 只查配额;--enable 做启用校验(dry run);--enable --apply 实际启用(不可逆);--list-scratch 列出活动 scratch org;--instance-url <url> 先登录指定实例再执行;--json 输出机器可读结果;--fail-if-disabled 在未启用时退出码 3。子偏好标志包括 --packaging、--snapshots、--shape、--scratch-management、--pref KEY=VALUE。启用默认先 dry run,仅当用户明确要求实际启用时才用 --apply,且需显式指定组织别名或用户名,脚本拒绝改动隐式默认组织。
限制:启用不可逆;需 ModifyAllData 或 ModifyMetadata 权限(System Administrator 具备),否则报 INSUFFICIENT_ACCESS;沙盒或已注册命名空间的组织无法启用;适用于 Developer、Enterprise、Performance、Unlimited 和试用版。需 PATH 中有 Salesforce CLI(sf)和 jq,并至少有一个已认证组织。本技能不创建或删除 scratch org,不切换默认组织,也不检查试用/组织到期时间。启用后可设默认 Dev Hub:sf config set target-dev-hub <org>。启用 packaging 需先开启 Dev Hub。