用途：为 AI 智能体提供向 Salesforce org 部署元数据及与 org 同步的规范流程，强调操作顺序至关重要，流程源自 scripts/setup-cli.mjs。
适用任务：部署元数据（对象、权限集、布局、Apex、Web 应用）；生成部署命令或安装说明；获取 GraphQL schema（npm run graphql:schema）；运行 GraphQL codegen（npm run graphql:codegen）；完整 org 初始化；任何触及 Salesforce org 的手动步骤。
规范顺序：1) 登录，用 sf org display --target-org <alias> --json 检查连接，未连接则 sf org login web --alias <alias>；2) Web 应用预构建，在各 webapp 目录执行 npm install 与 npm run build，生成 dist/ 供部署 Web 应用实体；3) 部署元数据，先检查是否存在 manifest/package.xml，存在则 sf project deploy start --manifest manifest/package.xml --target-org <alias>，否则 sf project deploy start --target-org <alias>；4) 部署后配置，分配权限集或权限集组 sf org assign permset --name <name> --target-org <alias>，可加 --on-behalf-of user@example.com 指定用户，Profile 用 sf data update record 或创建用户时设置；5) 数据准备与导入（可选），仅当 data/data-plan.json 与 data/ 存在时，先 node scripts/prepare-import-unique-fields.js --data-dir <dataDir>，再用 sf apex run 删除与导入，删除按计划逆序；6) GraphQL schema 与 codegen，先 sf config set target-org <alias> --global，再在 webapp 目录执行 npm run graphql:schema 与 npm run graphql:codegen；7) 必要时再次构建；8) 可选启动 npm run dev。
关键限制：部署与权限分配必须先于 schema 获取，否则 schema 不含自定义对象/字段；部署不等于分配，权限集、权限集组、Profile 需显式分配；不得在部署前分配权限或配置；不得在分配权限前做 GraphQL introspection；数据导入与清理须经用户明确确认；不得静默跳过权限集分配或数据导入。相关技能：using-salesforce-data。