brand-designer

品牌设计师

用于记录品牌形象的系统化工具包。通过结构化模板收集品牌信息，验证完整性，汇编为参考文档，并生成符合品牌规范的图像。

快速开始

# 1. Scaffold a new brand
brand-book init ./my-brand --name "Acme Corp"

# 2. Fill in the templates (7 markdown files)
#    Start with strategy.md → visual-id.md → voice.md

# 3. Validate your work
brand-book validate ./my-brand/strategy.md --strict

# 4. Compile output
brand-book compile ./my-brand --artifact brand-card    # One-page summary
brand-book compile ./my-brand --artifact full           # Full brand book

# 5. Generate brand image (optional)
generate brand-card --brand-dir ./my-brand --layout landscape

何时使用此技能

触发条件	成果	受众
“我需要一张供媒体／利益相关方使用的品牌卡片”	品牌卡片（图像 + 单页文档）	高管、媒体、合作伙伴
“我需要记录品牌战略”	战略备忘录	领导层、市场团队
“我需要视觉形象文档”	视觉形象规范	设计师、开发人员
“我需要品牌声音指南”	声音与信息传达规范	撰稿人、内容团队
“我需要一份完整的品牌手册，用于交接给代理机构”	汇编后的品牌手册	代理机构、合作伙伴
“我需要盘点所有品牌资产”	资产清单	所有人

工作流

1. 选择成果类型

references/canonical-components.md 中的决策树会根据品牌成熟度确定成果范围：

• 初创（少于 10 人）→ 品牌卡片 + 战略备忘录（精简版）
• 成长中（10–50 人）→ 完整的视觉形象规范 + 声音规范
• 扩展中（50–200 人）→ 所有规范 + 治理框架
• 企业级（200 人以上）→ 完整体系 + 资产清单 + 汇编后的品牌手册

2. 填写模板

7 个模板位于 templates/。从战略模板开始（它会为其他所有内容提供依据），然后填写视觉形象、声音和其余模板：

模板	所记录的内容	依赖项
strategy.md	定位、个性、使命、受众	—
visual-id.md	标志系统、调色板、字体、图标、图像	战略
voice.md	声音属性、语气矩阵、词汇、文案示例	战略
application.md	数字、印刷、社交、联合品牌规则	视觉形象
governance.md	版本管理、审核周期、例外情况	—
asset-inventory.md	结构化文件索引	其余所有模板
brand-card.md	精简的视觉摘要（内容取自其他模板）	战略、视觉形象、声音

填写方法： 将每个模板中的 {{placeholders}} 替换为品牌信息。必填字段会在 frontmatter 中标注。可删除选填字段。

3. 验证

brand-book validate ./my-brand/visual-id.md              # Basic checks
brand-book validate ./my-brand/brand-card.md --strict     # Cross-reference checks
brand-book validate ./my-brand/*.md                       # Batch check all

验证可检查：

• 是否缺少必填字段
• 颜色值是否完整（是否缺少 RGB、CMYK 或 Pantone）
• 交叉引用是否失效（品牌卡片是否引用了不存在的规范）

4. 汇编

brand-book compile ./my-brand --artifact brand-card                        # One-pager
brand-book compile ./my-brand --artifact full                              # Full book
brand-book compile ./my-brand --artifact full --format html --output book.html  # HTML

--artifact 选择器可指定单个模板或完整汇编内容。完整分类请参阅 references/artifact-hierarchy.md。

5. 生成图像（可选）

generate brand-card --brand-dir ./my-brand --layout landscape    # Press kit card
generate mockup --brand-dir ./my-brand --type social             # Social media mockup
generate swatch --brand-dir ./my-brand                           # Color palette card
generate moodboard --brand-dir ./my-brand --theme "innovation"  # Mood board
generate logo-bg primary --brand-dir ./my-brand --background dark  # Logo on dark

generate 脚本以提示词工程为先：它会读取品牌数据，并为图像生成后端构建优化提示词。为准确呈现标志，建议在提示词之外提供参考图像。

脚本参考

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、在线版、CLI、Figma 和图像
references/template-schemas.md	全部 7 个模板的完整 YAML frontmatter 架构
references/image-generation.md	符合品牌规范的图像提示词模式及参考图使用方法

产物分级摘要

Tier 0: Brand Card          → image + one-pager        → stakeholders, press
Tier 1: Strategy Memo       → narrative document       → leadership, marketing
Tier 2: Visual Identity     → structured spec          → designers, developers
Tier 3: Voice & Messaging   → guidelines with examples → writers, content
Tier 4: Application         → channel-by-channel rules → producers, agencies
Tier 5: Governance          → framework document       → brand owners, legal
Tier 6: Asset Inventory     → indexed table            → everyone
       └── Compiled Brand Book (Tiers 0-6 combined)    → agencies, partners

注意事项

模板是信息收集工具，而非最终设计

模板生成的是 Markdown 文档，而不是经过设计的 PDF。内容经过结构化且准确；视觉润色属于后期处理步骤。如果需要设计精美的 PDF，请导出 Markdown，并在 InDesign/Figma 中排版。

生成图像的颜色准确度

生成的图像只能近似品牌颜色，而不能精准匹配。generate swatch 命令会在提示词中提供十六进制颜色值，但图像模型对颜色的解读并不精确。如需符合 Pantone 标准的颜色参考，请使用规范中记录的值，而非生成的图像。

基于参考图生成的效果取决于配置

无论后端如何，generate 脚本都会构建提示词。若要使用参考图（标志、现有素材）来获得更好的结果，你需要使用支持图像输入的生成配置，例如 ComfyUI、支持 img2img 的本地 Stable Diffusion，或接受图像参考的 API。不使用参考图也能使用这些提示词；使用参考图只会进一步提升效果。

品牌卡片引用其他模板的来源

品牌卡片模板使用 source: frontmatter 链接到策略、视觉识别和品牌语气模板。这意味着：如果这些来源模板尚未填写，compile 可能会显示占位文本。请先填写策略 + 视觉识别模板，再期待生成完整的品牌卡片。

此技能生成文档，而非艺术作品

虽然具备图像生成功能，但主要产出是结构化文档——可存放在知识库中、使用 git 进行版本管理，并编译为各种格式的 Markdown。图像只是点缀，不是主体。

另请参阅

• nous-branding — Nous Research 品牌的参考图生成
• cli-builder — 品牌手册 CLI 使用的模式
• references/image-generation.md — 详细的提示词编写指南