experience-cms-brand-create

用途：为一个 Salesforce Digital Experience 品牌生成单个 brand.json 文件，并写入 VS Code Brand Toolkit 能发现的位置，以便用户立即加载、编辑和预览该品牌。品牌是一组设计令牌的单一 JSON 对象，包含颜色（colorScheme）、字体目录与基础字体（fontFamily / baseFontFamily）、尺寸/间距/边框比例、各角色排版以及 buttonStyleGroup 定义。主要能力：从模板克隆品牌结构，只修改叶子值（颜色、字体选择、边框圆角、基础字号）并设置唯一名称；颜色方案包含 root 与 contrast（用于浅色/深色）、primaryAccent、primaryAccentContrast、neutral；字体选用目录中实际能在预览中渲染的项；可选调整 borderRadius、borderWeight、baseFontSize、fontWeight 等个性项。使用方式：按五个步骤执行——第一步收集品牌意图（名称、主色、浅色或深色、可选个性），若用户已给出描述则从中提取，否则简要提问；第二步读取品牌模板并把模板复制为基底，仅覆盖叶子值；第三步汇总具体选择并请用户确认或调整（若无交互用户，则说明推断的选择并继续）；第四步按磁盘约定写入 .digitalExperience/brands/<slug>.brand.json；第五步按校验清单验证文件（有效 JSON、未包裹的主体、存在且唯一的 sfdc_cms:title、slug 与标题匹配、无手写的 *Derived 键、字体可渲染）。相关技能：本技能用于创建新品牌定义；若要将现有品牌的语气、语调与指南应用到生成内容上，应改用 experience-cms-brand-apply 技能。参考材料包括 assets/brand-template.json（可克隆的完整品牌模板）、references/brand-anatomy.md（哪些字段是应编辑的字面量、哪些是必须保留的引用；colorScheme 指南；字体目录及预览中实际渲染的字体；派生颜色规则）、references/disk-contract.md（文件确切位置、标题到 slug 的规则，以及工具链会生成哪些内容）。适用场景与限制：适用于在 VS Code 中创建、预览和微调 Salesforce Digital Experience 品牌；品牌文件即交付物，打开工具包属可选操作，仅在 VS Code 内且用户希望预览/编辑时执行对应的操作系统命令打开 Brand Toolkit（macOS、Linux、Windows 启动命令行不同，均可打开同一深链）。需要遵守的边界：始终克隆模板而非从头编写；只编辑字面量并保留引用；不要编写派生颜色；只使用预览中可渲染的字体（系统字体与 Salesforce Sans）；sfdc_cms:title 必须唯一；只写一个 brand.json 文件，.css 与 activeBrand.json 由工具链生成。若面板已打开，新品牌可能需要在 Local 标签页刷新后才能出现；若未打开，深链需要安装并启用 Live Preview 扩展（salesforce.salesforcedx-vscode-ui-preview），否则可回退到从命令面板运行 SFDX: Open Theme Preview。在无头、CLI、CI 或非项目环境中不要触发 vscode:// 深链。