用途：通过一次 Metadata API 部署，在 Salesforce 组织中启用五项 OmniChannelSettings 布尔开关（enableOmniChannel、enableOmniAutoLoginPrompt、enableOmniSecondaryRoutingPriority、enableOmniSkillsRouting、enableOmniStatusCapModel）。由于队列、在线状态、路由流程等下游功能都依赖 enableOmniChannel=true，该技能应作为 Omni 配置序列中的首个写入操作。技能会先探测，仅在开关为 false 或缺失时才部署。
主要能力与用法：唯一输入为 org-alias。规范入口为 scripts/configure-and-report.sh，支持两种模式： run <org-alias>：探测；若五项已启用则输出 reused（不部署）；否则执行 safe_to_write 守卫，部署 assets/force-app/main/default/settings/OmniChannel.settings-meta.xml（五项均为 true），SucceededPartial 视为失败，随后重新探测，全部为 true 才输出 configured，否则 blocked。 plan <org-alias>：只读探测，全部启用输出 reused，否则 action_needed，绝不部署。
前置条件与安全：目标组织需通过 sf CLI 认证（My Domain URL，非 .lightning.force.com），具备 Service Cloud 许可，sf CLI ≥ 2.139.6。生产守卫：safe_to_write 为 IsSandbox 或 TrialExpirationDate != null 或 OrganizationType 属于 Developer Edition、Base Edition，为 false 时无覆盖地阻断。
行为与限制：Settings 为整文档元数据类型，不支持部分更新，因此始终部署完整文件。探测需 1–2 分钟属正常。登录行为单选按钮在 v66 无公开 API，报告始终给出其点击路径，即使 reused 运行也不隐藏该手动操作。部署后重新探测并要求五项全为 true，否则 blocked。输出为单个 JSON 对象，含 status（configured | reused | action_needed | blocked）、all_enabled、前后开关对象、deploy_id、safe_to_write、manual_actions、blocking_issue。仅配置 OmniChannelSettings 且五项恒为 true，其他 Settings 类型需使用 platform-metadata-deploy。部署前可阅读 references/api-notes.md 了解五项开关语义、依赖与登录行为注意事项。