brand-designer

用途

Brand Designer 是一个用于系统化记录品牌识别信息的工具包。它通过结构化模板引导用户梳理品牌信息，校验内容完整性，编译为参考文档，并生成符合品牌规范的图像。

主要能力

该技能围绕七个 Markdown 模板组织品牌文档：

模板	记录内容	依赖
`strategy.md`	定位、个性、使命、受众	—
`visual-id.md`	标志系统、色彩、字体、图标、图像	策略
`voice.md`	语调属性、语气矩阵、词汇、文案示例	策略
`application.md`	数字、印刷、社交、联合品牌规则	视觉识别
`governance.md`	版本管理、评审节奏、例外处理	—
`asset-inventory.md`	结构化文件索引	其他全部
`brand-card.md`	精简视觉摘要（来源于其他模板）	策略、视觉识别、语调

根据品牌成熟度，产出范围不同：初创（<10 人）→ 品牌卡片 + 精简策略备忘录；成长（10-50）→ 完整视觉识别 + 语调规范；扩张（50-200）→ 全部规范 + 治理框架；企业（200+）→ 完整系统 + 资产清单 + 编译品牌手册。

使用方式

快速开始：

# 1. 创建新品牌目录
brand-book init ./my-brand --name "Acme Corp"

# 2. 填写模板（7 个 markdown 文件）
#    从 strategy.md → visual-id.md → voice.md 开始

# 3. 校验
brand-book validate ./my-brand/strategy.md --strict

# 4. 编译输出
brand-book compile ./my-brand --artifact brand-card    # 单页摘要
brand-book compile ./my-brand --artifact full           # 完整品牌手册

# 5. 生成品牌图像（可选）
generate brand-card --brand-dir ./my-brand --layout landscape

填写技巧：将每个模板中的 {{placeholders}} 替换为品牌信息。必填字段在 frontmatter 中标记，可选字段可删除。

校验命令可捕获：缺失必填字段、不完整的颜色值（缺少 RGB、CMYK 或 Pantone）、交叉引用断裂（brand-card 引用了不存在的规范）。

编译命令的 --artifact 选择器可映射到单个模板或编译整体，支持 --format html --output book.html 等格式。

图像生成命令包括：generate brand-card（新闻资料卡片）、generate mockup --type social（社交媒体模型）、generate swatch（色板卡片）、generate moodboard --theme "innovation"（情绪板）、generate logo-bg primary --background dark（深色背景标志展示）。生成脚本以提示工程为先：读取品牌数据并构建优化提示，供图像生成后端使用。为获得准确的标志渲染，建议在提示词旁提供参考图像。

脚本参考

scripts/brand-book 主 CLI 子命令：

命令	操作
`init <dir> [--name]`	用 7 个模板搭建品牌目录
`compile <dir> [--artifact] [--format] [--output]`	组装品牌产物
`validate <file...> [--strict] [--json]`	检查 frontmatter 完整性
`preview <file> [--json]`	终端预览品牌组件

所有子命令支持 --json 用于机器输出，--dry-run 用于预览。

scripts/generate 图像提示构建子命令：

命令	操作
`brand-card [--layout portrait\|landscape]`	品牌卡片提示
`mockup --type stationery\|social`	模型提示
`swatch`	色板可视化提示
`moodboard [--theme]`	情绪板提示
`logo-bg <variant> [--background]`	标志展示提示

参考文件

文件	内容
`references/canonical-components.md`	权威组件层级 + 成熟度决策树
`references/artifact-hierarchy.md`	每个产物：消费者、格式、深度、关系
`references/gold-standard-analysis.md`	Cash App、IBM、Netflix、Bang & Olufsen、Klarna 的结构分析
`references/brand-card-formats.md`	格式对比：PDF vs 在线 vs CLI vs Figma vs 图像
`references/template-schemas.md`	全部 7 个模板的完整 YAML frontmatter 模式
`references/image-generation.md`	品牌合规图像提示模式与参考图像用法

适用场景

触发场景	产物	受众
需要给媒体/利益相关者的品牌卡片	品牌卡片（图像 + 单页）	高管、媒体、合作伙伴
需要记录品牌策略	策略备忘录	领导层、市场
需要视觉识别文档	视觉识别规范	设计师、开发者
需要品牌语调指南	语调与信息规范	写作者、内容团队
需要完整品牌手册用于机构交接	编译品牌手册	机构、合作伙伴
需要盘点所有品牌资产	资产清单	所有人

限制与注意事项

模板是引导工具，不是最终设计。模板产出 Markdown 文档，而非设计好的 PDF。内容结构正确，视觉润色是后处理步骤。如需精美 PDF，请导出 Markdown 后在 InDesign/Figma 中排版。
生成图像中的颜色为近似值，不会精确匹配品牌色。generate swatch 命令会在提示中提供十六进制值，但图像模型对颜色的解释不精确。如需 Pantone 精确颜色参考，请使用规范中记录的值，而非生成图像。
参考图像感知生成依赖具体设置。generate 脚本无论后端如何都会构建提示。要使用参考图像（标志、现有材料）获得更好效果，需要支持图像输入的生成设置，例如 ComfyUI、本地 Stable Diffusion 的 img2img，或接受图像引用的 API。提示在没有这些设置时也能工作，只是效果会提升。
品牌卡片来源于其他模板。brand-card 模板使用 frontmatter 中的 source: 链接到策略、视觉识别和语调模板。这意味着：如果这些源模板尚未填写，编译可能显示占位文本。在期望完整品牌卡片之前，请先填写策略 + 视觉识别。
该技能产出文档，而非艺术。图像生成能力存在，但主要输出是结构化文档——可存放在 vault 中、用 git 版本管理、编译为多种格式的 Markdown。图像是点缀，不是主菜。