brand-voice-generator

品牌与语气生成器

生成完整的品牌配置文件，供 PPTX Generator 和其他支持品牌的技能使用。此技能将引导用户通过交互流程定义品牌形象和写作语气。

创建的内容

文件	用途	使用者
brand.json	颜色、字体、素材	PPTX Generator、Excalidraw
config.json	输出设置	PPTX Generator
brand-system.md	设计理念与指南	所有内容技能
tone-of-voice.md	写作语气与个性	LinkedIn、X、PPTX 内容

输出位置

文件创建于：

.claude/skills/pptx-generator/brands/{brand-name}/

---

流程概览

1. 收集品牌基本信息 - 名称、描述、主要用途
2. 定义颜色 - 完整色彩系统的 10 个颜色值
3. 定义字体 - 标题、正文和代码字体
4. 定义素材 - Logo 和图标路径
5. 探索品牌语气 - 个性、词汇、句式模式
6. 创建设计理念 - 核心原则和标志性元素
7. 生成文件 - 根据收集到的信息创建全部四个文件
8. 验证设置 - 确认文件放置正确

---

步骤 1：收集品牌基本信息

询问用户以下信息：

字段	描述	示例
品牌名称	文件夹名称（小写、不含空格，可使用连字符）	my-brand、acme-corp
显示名称	便于阅读的名称	“My Brand”、“ACME Corporation”
描述	一句话品牌描述	“AI 教育内容与社区”
主要用途	主要内容类型	演示文稿、社交媒体、文档

建议提问：

“我们来设置你的品牌。你的品牌名称是什么？（这将作为文件夹名称，请使用小写字母和连字符，例如 ‘my-brand’）”

---

步骤 2：定义颜色

收集 10 个颜色值。颜色应为十六进制代码，且不带 # 前缀。

必需颜色

颜色	用途	指引
background	幻灯片/页面的主背景	深色主题：接近黑色。浅色主题：白色/米白色
background_alt	用于增加变化的替代背景	与背景颜色略有不同的色调
text	主要文字颜色	与背景形成高对比度
text_secondary	柔和/次要文字	对比度略低于主要文字
accent	主要强调色（CTA、重点内容）	代表品牌特色的颜色
accent_secondary	次要强调色	与主要强调色互补
accent_tertiary	第三强调色（可选，用于增加变化）	另一种互补色，或与次要强调色相同
code_bg	代码块背景	比主背景更深
card_bg	卡片/表面背景	颜色介于背景和文字之间
card_bg_alt	替代卡片背景	card_bg 的轻微变化

颜色探索问题

如果用户还没有完整的色彩系统，请引导他们：

1. “你的品牌标志色是什么？（这将作为主要强调色）”
2. “你更喜欢深色主题（深色背景、浅色文字）还是浅色主题？”
3. “你有次要颜色吗？还是需要我推荐互补色？”

按主题推荐颜色

深色主题，推荐：

background: 0a0a0a to 1a1a2e range
text: f5f5f5 to ffffff range
card_bg: 1a1a1a to 2d2d44 range

浅色主题，推荐：

background: ffffff to f8f9fa range
text: 1a1a1a to 333333 range
card_bg: f0f0f0 to e8e8e8 range

---

步骤 3：定义字体

收集 3 种字体名称：

字体	用途	常见选择
heading	标题、名称、按钮	Inter、Montserrat、Poppins、Roboto
body	正文、描述	Inter、Open Sans、Lato、Source Sans Pro
code	代码块、终端	JetBrains Mono、Fira Code、Monaco、Consolas

问题：

“我们应该使用什么字体？我需要一种标题字体、一种正文字体，以及一种代码/等宽字体。常见选择是标题和正文都用 Inter，代码用 JetBrains Mono。”

不确定时的默认值：

• 标题：Inter
• 正文：Inter
• 代码：JetBrains Mono

---

步骤 4：定义素材

收集素材路径（相对于品牌文件夹）：

素材	说明	常见路径
logo	主徽标文件	assets/logo.png
logo_dark	适用于深色背景的徽标变体（可选）	null 或 assets/logo-dark.png
icon	方形图标（可选）	null 或 assets/icon.png

问题：

“你有徽标文件吗？如果有，需要将它复制到品牌文件夹。文件名是什么？（例如，‘logo.png’）”

如果有徽标，将路径设为 assets/logo.png（用户会将文件复制到那里）。 如果没有徽标，则设为 null。

---

步骤 5：探索品牌声音

这是影响内容质量的最重要步骤。引导用户探索品牌声音。

品牌声音探索问题

提出以下问题，了解品牌声音：

1. 用 3 个词描述个性：

   “请用恰好 3 个词描述你的品牌个性。例如：‘大胆、专业、平易近人’或‘沉稳、权威、乐于助人’”

2. 声音风格的影响来源：

   “有哪些 2–3 位创作者、品牌或人物的沟通风格令你欣赏？这有助于我了解你想要的氛围。”

3. 词汇习惯：

   “你经常使用哪些词语或短语？有没有常用语、喜欢使用的程度副词（如‘非常’‘极其’），或者你会自然而然用到的词？”

4. 需要避免的内容：

   “你想避免什么样的语气或短语？（例如：企业腔、夸张宣传、过于随意）”

5. 句子风格：

   “你更喜欢哪种风格：简短有力的句子、较长且流畅的解释，还是两者兼有？你会在日常表达中使用缩略形式（如‘don't’、‘can't’）吗？”

6. 讲解风格（如适用）：

   “解释复杂内容时，你会采用什么方式？展示过程和迭代？使用类比？先讲实际应用，再讲理论？”

品牌声音模板参考

阅读 references/voice-templates.md，向用户展示品牌声音配置示例。

---

步骤 6：制定设计理念

根据收集到的信息，协助定义：

核心原则（3–4 项）

询问：

“有哪些 3–4 项设计原则指导你的视觉选择？例如：‘简洁胜过炫目’、‘专业但平易近人’、‘默认采用深色模式’”

标志性元素

询问：

“你有没有标志性的视觉元素？例如：玻璃卡片效果、特定的阴影样式、渐变图案、几何形状、发光效果”

如果用户不确定，可根据其颜色和主题提出建议。

---

步骤 7：生成文件

使用收集到的信息创建全部四个文件。

brand.json

{
  "name": "{display_name}",
  "description": "{description}",

  "colors": {
    "background": "{background}",
    "background_alt": "{background_alt}",
    "text": "{text}",
    "text_secondary": "{text_secondary}",
    "accent": "{accent}",
    "accent_secondary": "{accent_secondary}",
    "accent_tertiary": "{accent_tertiary}",
    "code_bg": "{code_bg}",
    "card_bg": "{card_bg}",
    "card_bg_alt": "{card_bg_alt}"
  },

  "fonts": {
    "heading": "{heading_font}",
    "body": "{body_font}",
    "code": "{code_font}"
  },

  "assets": {
    "logo": "{logo_path}",
    "logo_dark": {logo_dark_path},
    "icon": {icon_path}
  }
}

config.json

{
  "output": {
    "directory": "output/{brand_name}",
    "naming": "{name}-{date}",
    "keep_parts": false
  },
  "generation": {
    "slides_per_batch": 5,
    "auto_combine": true,
    "open_after_generate": false
  },
  "defaults": {
    "slide_width_inches": 13.333,
    "slide_height_inches": 7.5
  }
}

tone-of-voice.md

使用 references/tone-template.md 中的模板，并填入收集到的品牌声音信息。

brand-system.md

使用 references/brand-template.md 中的模板，并填入收集到的设计信息。

---

步骤 8：验证设置

生成文件后：

1. 列出已创建的文件：

   Glob: .claude/skills/pptx-generator/brands/{brand-name}/*
   

2. 提醒用户添加素材：

   “别忘了将徽标文件复制到 .claude/skills/pptx-generator/brands/{brand-name}/assets/”

3. 建议进行测试：

   “试着使用以下指令生成一份简单的演示文稿：‘为 {brand-name} 创建一份关于 [topic] 的 3 页演示文稿’”

---

快速模式

如果用户只想快速开始：

1. 只询问：品牌名称、标志色以及浅色/深色偏好
2. 为其他内容生成合理的默认值
3. 创建精简但可用的文件
4. 告知用户之后可以进一步调整

快速模式触发短语：

• “快速设置”
• “只要基础配置”
• “精简品牌”
• “快速开始”

---

更新现有品牌

如果品牌已存在：

1. 先读取现有文件
2. 询问要更新哪些内容：
   • 仅更新颜色？
   • 仅更新品牌声音？
   • 更新全部内容？
3. 保留未更改的部分
4. 写入前展示变更差异

---

检查清单

• 收集品牌名称和描述
• 收集全部 10 个颜色值（或建议默认值）
• 收集 3 个字体名称（或使用默认值）
• 确定资源路径
• 通过提问了解品牌语气
• 定义设计原则
• 生成 brand.json
• 生成 config.json
• 生成 tone-of-voice.md
• 生成 brand-system.md
• 创建 assets 文件夹
• 验证是否已创建所有文件
• 提醒用户复制徽标
• 建议进行测试生成