用途：从品牌指南、品牌官网 CSS、现有营销素材或 Paper 设计文件中整理出智能体可用的品牌包，统一品牌事实。
主要能力：
- 初始化：uv run design-agent brand init 将示例包复制到 workspace/brand/（Git 忽略），需替换每个文件内容，包括标志。
- 令牌：tokens.json 记录调色板、显示/正文/等宽字体栈、圆角、描边、间距及指南中的文案规则；需检查所列文本/背景配对的 WCAG 对比度，浅色背景上不达标的强调色标记为非文本用途；在 design.roles.light 与 design.roles.dark 中指定各颜色角色（ground、ink、accent、muted、quiet、rule、series）以支撑图表与示意图。移植现有令牌文件时名称须为 --brand-*、十六进制带 #、version 为 "1"、拒绝未知键、每个字体栈以通用字族结尾。
- 标志：logos/ 中使用品牌提供的 SVG，覆盖指南允许的各类变体（标记、组合、反白）；不得重绘或描摹标志。
- 字体：fonts.toml 中每个字面配置 fonts/ 下的开源字体或 private-fonts/ 下由人工提供的授权文件（Git 忽略，以部署文件或挂载进入沙箱）；不得提交授权字体；family 为文件内部名称，weight 为 CSS 字重，sha256 由 shasum -a 256 <file> 生成，uv run design-agent fonts verify 校验三项；支持 .woff2、.woff，tokens.css 以 @font-face 声明；授权字面不可用时需指明最接近的开源替代并写入 graphic-language.md。
- 文档：voice.md 与 graphic-language.md 简短、具体、有出处，避免通用建议；指南中的其他内容（字体表、图标、图案、构造规范）也可放入品牌包，并从 graphic-language.md 链接，该文件是智能体首先读取的内容。
使用方式：按优先级选取来源（品牌自身 PDF 指南、设计文件、线上网站 CSS、既有营销文件）；执行品牌初始化、填写文件后，运行 uv run design-agent brand validate、uv run design-agent fonts verify，再由 uv run design-agent brand css 重新生成 tokens.css；首次查看可请求生成一张卡片（uv run design-agent ask "A 1200x630 card announcing …"）并与人工评审；demo 始终渲染示例品牌。
适用场景：需要让设计智能体在统一品牌事实下生成符合品牌规范的视觉内容时。
限制：品牌包不得包含来源未体现的规则、颜色、字体或标志；Paper 品牌文件只读；授权字体不可提交；指南自相矛盾的规则需作为待确认问题交由人工；品牌包以人工审核完成为完成标志。