build-a-brand

打造品牌

以下工具均为 Pika MCP 工具，名称不带前缀——请使用当前会话为 Pika MCP 提供的任意前缀调用各工具。

输入任何内容——一个想法、一个网站、一组参考品牌、产品照片，或一个需要焕新的现有品牌——即可打造出可用的品牌形象。

这是一个独立的品牌打造工作流，专注于策略、品牌形象、设计和文案。默认输出是可在几分钟内完成的快速品牌成果。完整的 14-16 页品牌指南 PDF 仍可提供，但仅在用户明确要求完整内容，或快速流程结束后选择深入探索时提供。

参考文件

仅在相关阶段开始时加载：

• references/brand-directions.md — 策略角度结构和差异化定位方案板。
• references/brand-identity.md — Logo 流程、符号规则、概念方向和方案板文案篇幅限制。
• references/brand-guidelines.md — 完整指南布局、渲染规范、页面结构和 QA 规则。
• references/brand-md-template.md — 必需的机器可读 brand.md 结构。

执行模式 — 本地优先，仅在需要时使用云端

此技能以本地为先。将确定性的制作工作保留在用户的机器上：

• **本地：**工作区设置、下载的字体、下载后的生成图像文件、图像压缩、透明背景清理、16x16 网站图标测试、HTML/CSS 页面构建、PDF 渲染、PNG/JPG QA 截图、Logo 资源组装、令牌/提示词文件，以及最终 zip 打包。
• **云端：**仅用于付费生成（使用 gpt-image-2 生成符号、情绪图像、摄影、插画和环境纹理）以及任务简介要求的 URL/来源研究。

默认情况下，不要使用云端 PDF 渲染器，也不要上传 PDF。将快速 PDF、方案板 PDF、指南 PDF 和品牌套件 zip 保存到 Mac 上的 ~/Desktop；若无法使用桌面，则保存到项目工作目录。只有用户明确要求托管文件时，才通过 CDN 上传/分享。

**PDF 资源规范：**绝不要在方案板或指南 PDF 中直接嵌入完整尺寸的 gpt-image-2 PNG。这样此前曾导致 PDF 过大，并在渲染器尝试获取数 MB 的 CDN 图像时出现 ASSET_FETCH_TIMEOUT 错误。下载每张生成图像，将其缩小/下采样至版面所需尺寸，并保存为约 85-180KB 的本地 JPEG，然后再用于渲染 HTML。仅将透明 PNG 用作 Logo/符号源文件以及网站图标/Logo 导出文件，不要用于页面中的摄影图像。渲染 HTML 中，绝不要对照片或 background-image 使用 CSS filter:/backdrop-filter:（暖色调、棕褐色、饱和度、亮度、模糊）——这会迫使 Chromium 在 PDF 中将该元素栅格化为全分辨率的无损位图，从而抵消上述 JPEG 处理带来的效果，并再次使文件变大（仅一页暖色调的情绪板就曾将一套方案扩大到 70 MB）。请在 JPEG 本身中应用任何色彩调整（通过 gpt-image-2 提示词，或使用 img.save(..., 'JPEG', ...)）；透明 Logo PNG 上的 drop-shadow() 是唯一安全的滤镜。

费用透明机制

进行任何付费 MCP 调用前，先调用一次 identity_balance({verbose: true})。展示当前余额、近期消耗速率和剩余可用时长，然后使用以下原文提示确认所选深度：

预计费用：快速品牌约需 100-300 积分（约 $1-$3），完整品牌手册约需 900-1,500 积分（约 $9-$15）。这些区间涵盖使用 gpt-image-2 生成符号/情绪图像/接触点素材，以及针对图像 QA 未通过项进行一次定向重新生成。快速品牌通常低于 $5；完整品牌手册超过 $5，因此请回复 proceed 继续，或回复 cancel 停止。

在用户回复 proceed 前，不要调用任何付费 MCP 工具。如果用户回复 cancel，则停止，不进行生成。对于非交互式的 --quick、--full 或 --config 调用方，必须在配置或调用元数据中提供 cost_ack=proceed；若缺少此项，则停止并显示费用预估，不得消耗积分。

深度模式

在进行任何耗时的生成或渲染工作之前，先选择深度模式：

1. 快速品牌（默认） — 用于首次运行创始人套件、--quick、创作者教程流程、批量/子 Agent 调用，或用户提出品牌需求但未明确要求完整品牌手册的情况。目标：在获得可用输入后 8-12 分钟内完成，不包括等待用户回复的时间；除非 QA 失败，否则生成的图片不超过 4 张；快速渲染 PDF 一次，必要时再进行一次 QA 重渲染。
2. 完整品牌手册（选择启用） — 仅当用户要求“完整”“品牌手册”“品牌指南”“14-16 页”“15 页”、--full，或同意快速路径中的“深入探索”升级选项时使用。目标：在锁定选择后 25-45 分钟内完成，不包括等待用户回复的时间。

快速品牌并非不完整或失败的完整品牌指南演示文稿。它是一份刻意缩小范围的交付成果，有自己的完成标准。如果选择了完整模式，则仍须满足完整指南的所有完成门槛。

模式选择

阶段 0 — 信息收集（空参数菜单）

如果调用时没有输入（没有创意、URL、照片、参考品牌，且对话中也没有相关上下文），请原样打印此菜单作为完整回复，然后停止。不要调用任何工具。等待用户的下一条消息。

我们要为哪类事物打造品牌？ 请提供以下任意内容：

• 创意 / 描述 — 例如：“面向爱猫人士的街头服饰品牌”
• 网站 URL — 例如：“为我现有的网站 example.com 重塑品牌”
• 产品照片 — 直接发送到聊天中
• 参考品牌 — 例如：“我想要 Aesop + Patagonia 那样的感觉”
• 需要焕新的现有品牌 — 品牌名称 + 哪些方面有效 / 哪些方面不理想

默认情况下，我会从快速品牌开始。如果你想要更深入的 14-16 页指南路径，请说 完整品牌手册。

如果用户已经提供了上述任意一项，请跳过菜单并进入所选模式：默认快速品牌路径进入快速步骤 1；选择完整品牌手册模式时进入下方的步骤 1。

阶段 0.5 — 快速品牌模式与非交互式快捷流程

当调用方传入 --quick、未明确要求完整深度，或表示他们正在 CI、子 Agent、批处理作业、教程录制或任何其他非交互式环境中运行时，使用快速品牌模式。

只有当调用方传入 --full、在配置中设置 mode: "full"、明确要求完整指南／品牌手册深度，或批准快速模式后提出的“深入展开”升级时，才使用完整品牌手册模式。

本节优先于下方的交互式询问／等待说明。 适用快速模式时，请使用下方的快速品牌工作流，不要 进入多轮完整工作流的需求收集流程，除非确实缺少必需的 输入。

• --config <path> 指向一个 JSON 文件，其中预先填写了需求收集的答案： input、photos、reference_brands、audience、positioning、assets_to_keep、 references、mode、chosen_direction、chosen_identity 和 export_kit。
• --quick 表示快速品牌模式。所有确认环节均由模型自行判断。 只有在完全缺少原始输入时才提问；否则推断合理的 默认值，选择最有力的策略方向和身份选项，然后 继续。
• --full 表示完整品牌手册模式。在非交互式运行中，确认环节仍由模型自行判断， 但不得省略所需的 14-16 页指南。
• 使用 --quick 或 --config 时，不要在交付物 预览、策略方向选择、身份选项选择或品牌套件 导出环节停下来等待确认。在相关位置记录假设，然后继续。
• 如果必需素材不可用，且无法根据输入推断， 则只需停止一次，并简洁列出缺失字段，不要启动 多轮问答。
• 在快速模式下，交付下方定义的快速品牌套件；不要将其描述为精简版完整指南演示文稿。
• 在完整模式下，不要仅因调用方处于非交互式环境或运行时间有限，就交付精简或不完整的品牌内容。精简的 6 页演示文稿不能替代所需的 14-16 页指南。如果运行的剩余时间预算不足，请保存包含已完成页面／素材的可恢复检查点并停止；不要将 工作流标记为完成。

**自主完整模式：**仅当存在明确的完整深度请求（--full、mode: "full"，或用户要求完整品牌手册／完整指南），且运行已设置 cost_ack=proceed 时，才使用此模式。此时，以简报为规范。不要等待用户选择方案板，也不要等待用户明确批准后才导出套件。一次运行中生成全部三项完整交付物：

1. brand-boards.pdf — 生成全部三块方案板，并由模型自行判断，选出最有力的方案板或混合方案。
2. brand-guidelines.pdf — 根据选定方向制作完整的 14-16 页指南。
3. brand-kit.zip — 指南通过 QA 后，导出完整套件。

在 brand.md 和最终回复中记录假设与选定方向。如果简报含糊到方案板选择会变得随意，则只需停止一次，指出缺少的决策，不要假装此次运行具备自主性。对于需求明确但未明确要求完整深度的非交互式简报，仍使用快速模式；绝不要仅因简报清晰，就将批处理／教程／创始人套件运行升级为完整模式。

快速品牌工作流（默认）

快速品牌模式使用此工作流。这是创始人套件的快捷流程：选择更少、生成的素材更少，并提供可供下游技能使用的完整入门品牌，同时避免消耗首次完整运行的配额。

快速步骤 1 — 一次性收集信息

如果已有可用输入，不要开始冗长的问卷。说明你采用的假设，并且只有在答案会实质性影响品牌时，才提出最多 3 个简短问题：

• 这个品牌销售什么或提供什么服务？
• 目标受众是谁？
• 是否需要保留任何现有名称、徽标、颜色、字体、照片或参考资料？

对于 --quick、--config、CI、子 Agent、批处理或教程录制流程，除非完全没有原始输入，否则不要等待这些问题的答案。推断合理的默认值，并在输出中记录这些默认值。

快速步骤 2 — 选择一个最有力的方向

快速模式下不要提供 2-3 个方向或 3 种品牌形象方案。凭借模型判断，选出一个最有力的策略和品牌形象。快速策略仍必须包含：

• 品牌名称或保留的名称
• 标语（最多 8 个词）
• 受众细分：主要细分群体、次要细分群体，以及一个核心用户画像
• 定位陈述
• 保留的资产
• 参考品牌／灵感来源（如有提供）

快速步骤 3 — 打造入门品牌形象

创建一套协调统一的品牌形象系统：

• 徽标概念：字标＋独立符号／标记＋组合方案。对于新符号，使用 generate_image 和 provider="gpt-image-2" 生成，并以透明背景 PNG 尺寸文件交付经批准的符号，而非 SVG。字标和组合标识可以使用 SVG，因为字标是由真实字体文本转换为轮廓路径的。
• 配色：4 种核心颜色，注明用途和十六进制值。
• 字体：一款有个性的展示字体，加一款实用的正文字体；有可用的 Google Fonts URL 时一并提供。
• 品牌语气：3 条语气原则、3 条示例文案和 5 个禁用词／短语。
• 图像方向：一套简短的照片／插画规则，以及不含文字的图像提示词限制。
• 入门应用：社交头像／应用图标、简洁的网站首屏方向，以及一个符合品牌类型的实用触点。

严格控制图像生成数量：最多生成 1 张符号／标记图像，以及 3 张情绪图或触点图。重试预算：每项生成的品牌图像资产最多尝试 2 次（首次生成＋一次有针对性的重新生成）。如果 QA 未通过，只重新生成未通过的资产。达到任一上限后，停止生成，并询问用户希望放宽哪项未通过的资产要求或布局问题，不要继续消耗额度。

快速步骤 4 — 交付快速品牌套件

快速交付物必须足够完整，让创作者可以立即使用：

[brand-name]-quick-brand/
├── quick-brand.pdf              # 3 pages: cover/strategy, identity system, starter applications
├── brand.md                     # compact machine-readable brand spec
├── README.md                    # how to use the quick brand and when to upgrade
├── logo/                        # symbol, wordmark, and lockup assets that were produced
├── tokens/
│   ├── tokens.css
│   ├── tokens.json
│   └── tailwind.config.snippet.js
└── prompts/
    ├── system-prompt.md
    └── imagery.md

3 页 quick-brand.pdf 的页面结构：

1. 封面＋策略 — 品牌名称、标语、定位、受众细分、核心用户画像、参考资料和主视觉。
2. 品牌形象系统 — 徽标系统、配色、字体、品牌语气规则和图像规则。
3. 入门应用 — 社交头像／应用图标、网站首屏／社交卡片方向、一张真实触点图或产品场景图，以及 3 条品牌专属的建议和 3 条禁忌。

使用无头 Chrome（或在 HTML 专为 WeasyPrint 编写时使用 WeasyPrint）在本地渲染 quick-brand.pdf，并在交付前检查 PNG／JPG 预览图。快速视觉 QA 必须检查文字是否被裁切、徽标／符号是否缺失、字体是否难以辨认、生成的图像中是否带有烘焙进去的文字、占位内容是否为空，以及是否存在明显的布局冲突。如果无法生成快速品牌套件或 zip 文件，则停止，并提供一个可继续处理的检查点，列出已完成文件、缺失文件、资产路径／URL 和具体阻碍。

交付快速品牌套件后，提供完整的 14-16 页品牌指南作为「深入了解」升级选项。除非用户明确提出要求，否则不要开始完整工作流。

完整品牌手册工作流（自选）

仅在完整品牌手册模式下使用此工作流。

第 1 步 — 了解输入

仅限完整品牌手册模式。

输入各不相同。在提问前，先简要列出议程，让用户知道接下来会发生什么：

here's how this works — 4 steps:
1. **Read the input** — i ask a few questions, you answer, i play back what i'm hearing
2. **3 visual brand boards** — i build a 3-page PDF with three complete brand directions, each with its own colors, fonts, photography, voice samples, and logo concept. you pick one or mix elements.
3. **Build the guidelines** — full 14-16-page brand book PDF for the chosen board
4. **Export the brand kit** — once you're happy with the guidelines, i'll bundle a `brand.md` spec + logo assets (symbol PNG sizes, wordmark SVG/PNG, lockup SVG/PNG) + fonts + tokens + AI prompts as a zip you can use anywhere

let's start. [questions follow]

然后在一条消息中提出 3–5 个有针对性的问题。根据输入类型调整问题：

如果对方提供了一个想法／描述：

• 这个品牌销售什么或提供什么服务？（产品／服务／应用／社群／其他）
• 这个品牌面向哪些人群？请描述品牌应服务的 2–3 个受众群体，并为主要群体描绘一位鲜明的代表性用户。
• 这个品牌为何存在？现有替代方案有什么问题，或者你想带来什么感受？
• 你有中意的名称吗？还是希望我们帮你起名？

如果对方提供了网站／现有品牌 URL：

• 我们是要焕新这个品牌，还是从头重建？
• 目前哪些方面有效，哪些方面无效？
• 现有客户是谁？你希望客户是谁？

如果对方提供了产品照片：

• 询问产品如何制作、谁购买或使用过、价格区间、当前销售／渠道情况，以及他们已有的任何方向。
• 将输出范围限定为品牌指南和品牌套件，而非电商上线方案。

如果对方只提供了参考品牌（“我想要一个兼具 Aesop + Patagonia 感觉的品牌”）：

• 这个品牌将关联什么产品、服务或事物？
• 你具体喜欢每个参考品牌的哪些方面？（摄影？语气？克制感？）
• 谁会购买？请描述品牌应服务的 2–3 个受众群体，并为主要群体描绘一位鲜明的代表性用户。
• 有什么限制吗？（行业、法规、地点、价格档位？）

无论输入类型如何，都要询问：

• 你有没有想保留或融入的现有品牌资产？（Logo、字标、符号、名称、颜色、字体、摄影、包装——任何你不想舍弃的东西。）
• 有没有希望借鉴的具体参考、灵感或情绪板？
• 这是数字产品吗（应用、网站、SaaS、网页工具）？这将决定完整指南中是否包含图标页面——对于非数字品牌（产品、服务、餐厅、时尚等），将跳过图标页面。

这两个问题至关重要——它们能避免生成用户已有的内容，并让创作以用户真正喜欢的参考为基础。务必包含这两个问题。

只发一条消息。总共提出 5–7 个问题（针对输入类型的问题 + 2 个通用问题），语气自然，不要像做临床问诊。等待对方回答后再继续。

收到回答后，结合输入和回答进行分析，并向用户复述：

• 美学领域：这属于怎样的视觉世界？
• 受众群体：主要群体、次要群体，以及一位主要群体中的鲜明代表性用户。不要把受众简化成一个过于具体的个人。
• 定位：品牌的切入点是什么——它代表了竞争对手没有代表的什么？
• 价格档位／品类契合度：它在市场货架上处于什么位置？
• 故事钩子：人们在情感上为何会在意？
• 保留的资产：明确列出用户表示希望保留的内容（现有字标、名称、颜色等）。
• 为创作定调的参考：列出用户提到的灵感来源。

接着预览交付内容并征求具体意见——在进入品牌方向之前，先向用户展示最终指南会包含哪些内容，让他们指出想添加、修改或特别强调的部分：

here's what i'll build into the brand guidelines (14-16 pages depending on your brand):

1. Cover (brand name, tagline, hero mood)
2. Strategy & positioning (primary/secondary audience segments + anchor persona)
3. Brand foundation (mission, values, story)
4. Logo (wordmark + symbol + variants)
5. Logo don'ts
6. Color palette
7. Typography
8. Icons — UI icon system + library guidance, ONLY IF this is a digital product (app / web / SaaS). Skipped for non-digital brands.
9. Voice & tone
10. Imagery rules (photography and/or illustration, adapted to brand medium; splits to 2 pages if hybrid)
11. Visual world / lifestyle imagery
12. Touchpoints (real photos showing the brand in use)
13. Brand applications (mockups: business card, app icon, favicon, etc.)
14. Digital + social
15. Do & don't

plus a brand kit zip at the end with: `brand.md` spec, logo assets (symbol PNG sizes, wordmark SVG/PNG, lockup SVG/PNG), brand fonts, design tokens (CSS / JSON / Tailwind), AI prompts (system prompt + task-specific starters), and the icon SVGs if applicable.

anything you want to add, change, call out specifically, or want me to handle differently? if not, i'll move on to the 3 brand boards.

等待回复。在进入第 2 步之前，纳入用户提出的具体要求（添加页面、替换内容、特别关注某个部分、排除某项内容）。这样可以尽早发现范围不一致的问题——比 PDF 做完后才发现要省心得多。

第 2 步 — 生成 3 份视觉品牌板（PDF）

此步骤是用户首次通过视觉接触品牌。不应在此之前出现纯文字的“说明”。品牌板就是说明，以可视化方式呈现。每张品牌板都应一目了然地展示完整的视觉识别，让用户能看出差异，而不只是读到差异。

制作一份 3 页 PDF（每张品牌板占 1 页，尺寸为 1200×850），并保存到 ~/Desktop/[brand-slug]-brand-boards.pdf。每个方向都必须是真正不同的品牌方向，不能只是模板换色。围绕品牌面向谁、为何存在来区分，同时让视觉系统、布局、字体、色彩逻辑、摄影风格和品牌语气各具特色。

每个选项必须包含：

• 字标，使用品牌展示字体——如果用户有喜欢的现有字标，就使用它；如果用户需要 Logo 或不喜欢现有字标，就提出一个新字标。新字标必须有专属的字母处理：调整间距、连字、切口、末端、大小写、下划线或其他可拥有的细节。不能只是把 Google Font 用某种颜色打出来。
• 符号／标记——一个脱离字标也能独立使用的图形。如果用户有喜欢的现有符号，就使用它；否则提出一个新符号。即使用户保留现有字标，只要没有符号，也要提出一个新符号——网站图标和应用图标需要非文字标记。对于新符号，使用 generate_image 并设置 provider="gpt-image-2"，生成透明 PNG。要求生成干净、独立、居中的方形透明背景标记，不带嵌入式字母、无水印、无样机。不要将生成的符号描摹为 SVG；应从获批的母版导出 PNG 尺寸。必须在 16×16 和 512×512 尺寸下都清晰可用。
• 徽章／标章——如果选项使用印章、徽章或字母组合，它在小尺寸和中尺寸下必须清晰易读、具有独特性。不能是通用的圆形字体组合、剪贴画纹章或低对比度的装饰性填充。
• 标语（最多 8 个词）
• 品牌语气示例，带有清晰可见的“VOICE”标签（引用句不超过 14 个词）
• 简短的品牌故事（约 35 个词以内，至少 2 句话）
• 生活方式场景描述，带有清晰可见的“WORLD”标签（约 22 个词以内，至少 1 个完整句子）
• 生活方式氛围图（使用 gpt-image-2 生成）
• 4 色调色板，包含十六进制色值和角色标签
• 展示字体和正文字体示例，并标注字体名称

品牌板页面的视觉差异必须足够明显，让用户无需阅读标签就能分辨所展示的品牌。不要只用同一模板换色 3 次；每张品牌板的布局都应体现对应选项的设计理念。杂志封面风格的选项应看起来像杂志封面（满版照片、刊头式标题）；柔和的消费品牌风格应看起来像主页首屏（圆润造型、用于展示色板的柔和圆形）；编辑风格应看起来像文学刊物跨页（居中的超大斜体字、内嵌照片）。示例见 references/brand-guidelines.md 中的“Brand Board Layout — Differentiate per Option”。

如果不读标签就无法凭视觉判断品牌有何不同——请在下方视觉质检重试次数限制内重新生成。

页面尺寸： 1200×850px。渲染器：优先使用本地 Chrome headless；仅当 HTML 是为 WeasyPrint 编写时，才允许使用 WeasyPrint。在本地渲染品牌板 PDF 和质检预览，然后将最终品牌板 PDF 复制到 ~/Desktop。

品牌板质量门槛： 3 页预览必须通过视觉质检，而不只是渲染质检。

重试次数限制：每个品牌板或品牌指南 PDF 的视觉质检循环，对于同一个选项／文档最多允许 2 次渲染／修复尝试（首次渲染加一次修复后重新渲染）。达到任一上限后，停止操作并询问用户希望放宽哪项未通过的素材或布局要求；同时提供未通过的页面／素材名称、质检原因，以及目前最佳的预览 URL。

1. 发送 PDF 前，检查每张 PNG 预览。以下情况均判定为不合格：密度失衡、层级不清、配色单调混浊、小字难以辨认、模型图／图片占位区为空、文字被裁切，以及正文或非刊头文字与图标、色板、印章、照片、手机模型图或装饰线相交。还要分别检查 16×16 和 512×512 尺寸的符号；如果小尺寸下难以辨认、显得混浊、过于普通或缩成一团噪点，请在交付前重新生成或简化。品牌展示板上可不放网站／社交媒体／应用模型图；除非其中包含真实内容，否则不要添加。如果包含，纯色矩形视为空占位区，明确作为配色样例展示的部分除外。
2. 以原尺寸查看每张展示板预览。低对比度文字、难以辨认的小字、文字与照片重叠、内容缺失、层级不清以及配色单调混浊，均判定为不合格。刊头字标／标语／期号信息可以叠加在照片上，但只能置于刻意留出的负空间内，或使用对比度遮罩，并且必须通过 references/brand-guidelines.md 规则 5 中定义的对比度 QA。仍禁止在图片上放置正文。
3. 交付前修复所有记录到的 FAIL。如果展示板在技术上有效但观感不佳，也应视为不合格；请简化层级、文案密度或装饰元素，然后重新渲染。

**字体规则：**每个品牌都必须选用全新的字体，而且字体必须有个性。切勿默认使用 Inter / Karla / Outfit / DM Sans / Lato——它们作为展示字体毫无个性。请全面探索 Google Fonts 字体库。有关不同风格中个性鲜明字体的建议，请参阅 references/brand-guidelines.md 中的“必须有个性——不要默认选择稳妥字体”。将选定的字体文件下载到本地，并在渲染后的 HTML 中使用绝对路径 file:// @font-face 声明。

**非拉丁品牌名称的字体回退：**品牌展示板、快速 PDF 和完整指南中的每个 font-family 字体链都必须包含广泛的文字系统回退字体。使用 Chromium 的逐字形回退机制，让拉丁文字保留所选品牌字体，同时让中日韩文字、阿拉伯文字、西里尔文字及其他文字系统使用 Noto 字体，而不是显示为方框。最低限度的字体链：展示／衬线字体：BrandDisplay, "Noto Serif SC", "Noto Serif TC", "Noto Serif JP", "Noto Serif KR", "Noto Sans Arabic", serif；正文／无衬线字体：BrandBody, "Noto Sans SC", "Noto Sans TC", "Noto Sans JP", "Noto Sans KR", "Noto Sans Arabic", system-ui, sans-serif。

在用户选定方案前，不要制作完整的 14–16 页指南 PDF——为被否决的品牌形象花费时间得不偿失。例外：在自主完整模式下，请根据模型判断选出最佳展示板或混合方案，并继续制作，无需等待。

清晰地展示全部 3 个方案。请用户选定一个，或组合不同方案中的元素。

第 3 步——制作完整品牌指南 PDF

用户确认展示板后，制作 14–16 页的品牌指南 PDF。在自主完整模式下，根据假设日志中记录的模型选定展示板或混合方案制作。

页数视情况而定：

• 14 页——非数字品牌（产品、餐厅、时尚、服务等），使用单一媒介图像。不包含图标页。
• 15 页——数字品牌（应用／网站／SaaS），使用单一媒介图像。包含图标页。
• 15 页——非数字品牌，使用混合图像（照片 + 插画）。图像内容拆分为 2 页；不包含图标页。
• 16 页——数字品牌，使用混合图像。包含图标页和拆分后的图像页。

根据实际包含的内容连续编排页码。不要留下页码空缺。

页面结构（完整列表——根据上述条件选用）：

1. 封面 — 品牌名称、标语、主视觉氛围图。铺满页面。
2. 策略与定位 — 方向名称。定位陈述（一句有力的话）。目标受众体系：主要细分群体、次要细分群体，以及主要细分群体中一个鲜明的代表性用户。不要只描述一个过于具体的客户。提供 3-4 个参考品牌，并附上“借鉴之处”说明。
3. 品牌基石 — 使命。品牌价值观（3-5 项）。“品牌为何存在”的故事（以品牌口吻撰写 2-3 段真实文案，而非模板）。
4. 标志 — 主标志及所有变体（横版、仅图标、反白版），使用规则（深色背景／浅色背景／彩色背景）、标志图形说明、安全留白规则。
5. 标志误用示例 — 用 CSS 明确呈现误用：绝不拉伸、绝不旋转、绝不搭配错误背景、绝不随意改色、绝不添加投影。每种违规用视觉示例和 ✗ 标记展示。
6. 色彩 — 所有色板及其 HEX、RGB、CMYK 值，主色搭配、无障碍／对比度说明、严禁使用的搭配。用铺满页面的色彩分栏展示，不要让色板孤零零地漂浮在白色背景上。
7. 字体排印 — 完整层级（从 H1 到说明文字，并标注精确的 px 字号）、展示／强调／正文字体、各类场景的使用规则、彩色背景上的文字排版、最小字号。
8. 图标（仅适用于数字品牌；产品、时尚、餐饮、服务品牌可跳过）— UI 图标系统：8-12 个核心图标（箭头向右、勾选、关闭、加号、设置、搜索、用户、铃铛、菜单、信息等），采用品牌的几何风格呈现，并说明描边／圆角／网格规则，以及图标集之外的图标库推荐。参见 references/brand-guidelines.md 中的“图标页面 — 结构与规则”部分。
9. 语气与风格 — 语气形容词；按使用场景提供文案示例（标题、正文、按钮、错误状态、社交媒体配文）；禁用词语／短语。展示品牌的真实文案，不要用泛泛的示例文案。
10. 图像规则 — 根据品牌的媒介类型调整。摄影主导 → 摄影规则（主体／光线／色彩／色调／纹理／禁忌 + 1 张示例照片）。插画主导 → 插画规则（风格／色彩／线条／角色／构图／禁忌 + 1 张示例插画）。混合型（两者占比相当）→ 拆分为两页，指南共 16 页。参见 references/brand-guidelines.md 中的“图像规则页面 — 根据品牌调整”部分。
11. 视觉世界 — 由 4 张图片组成的全出血四栏网格，图片类型应符合品牌的媒介组合（全为照片、全为插画或混合）。凡是出现人物，人物形象必须体现种族多样性。
12. 触点 — 真实照片 — 以 2×2 网格展示 4 张真实生成的照片，呈现品牌在实体环境中的应用。根据品牌类型调整：
    • 实体产品品牌：服装吊牌、织唛特写、内衬薄纸的牛皮纸快递袋、产品与包装平铺图
    • 数字／应用品牌：手持展示应用的手机、桌面上展示网站的笔记本电脑、贴有品牌贴纸的水壶、真实场景中的托特包
    • 服务品牌：手持名片、桌面上的品牌笔记本、建筑物上的标牌、真实场景中的品牌周边 本页不得使用 CSS 矢量样机 — 没有真实生成的照片，触点看起来就像 Figma 练习，而不是一个品牌。真实图片能证明品牌经得起现实世界的检验。
13. 品牌应用 — CSS 样机 — 用 CSS 渲染次要应用样机，并逐一标注规格：名片（含尺寸）、社交媒体头像（圆形裁切）、贴纸／应用图标（圆角方形）、电子邮件签名、演示文稿封面页。产品品牌还应包括：吊牌规格、织唛规格、购物袋规格。
14. 数字／社交媒体 — 网站首屏视觉风格（色彩、字体、版式观感）、Instagram 网格风格（含色彩调板与配文语气的 3×3 样机）、限时动态模板（品牌色彩 + 标志位置）、个人简介链接布局。
15. 应做与不应做 — 5 项应做和 5 项不应做，内容须符合品牌特点且可执行。不要写泛泛之谈（“应正确使用标志”），而要写符合品牌特点的具体要求（“社交帖子中的字标周围应留出一个完整破折号宽度的空白；绝不要在词中间裁切标语”）。 将第 2 页（策略）放在第 3 页（基础）之前，并确保这两页都排在标志／色彩／字体之前。策略决定了后续的每一项视觉设计。

在结构中包含所有页面。如果品牌没有包装，请根据品牌类型调整触点页面，而不是跳过；指南仍应展示品牌标识如何应用于实际场景。

**完成门槛：**不得交付精简版或不完整的品牌指南 PDF。 精简至 6 页的文稿、缺少视觉世界页面、缺少触点页面或 缺少品牌应用页面，都是未通过的检查点，而不是最终交付成果。 如果时间不够，请停在一个可继续的检查点，并列出已完成的页面、 缺少的页面、生成的素材 URL，以及下一步渲染步骤。只有在所有必需页面完成渲染并通过 QA 后，才能将文稿作为最终成果交付。

references/brand-guidelines.md 中的所有构建规则均适用：本地渲染规则、明确的 1200×850 页面尺寸、绝对本地素材／字体路径、生成的图像中不得包含承载关键信息的文字、文稿中不得重复使用生成的图像、深色背景上的文字对比度阈值，以及发送前必须预览并检查每一页。

**以 PDF 格式交付。**保存到 ~/Desktop/[brand-name]-brand-guidelines.pdf，并告知用户本地路径。如果用户使用的不是 Mac，请保存到项目工作目录，并在回复中说明路径。除非用户明确要求提供托管副本，否则不要上传或托管 PDF。

第 4 步 — 导出品牌套件（硬性门槛——仅在用户明确批准指南后执行）

交付 14-16 页的指南 PDF 后，等待用户明确批准，再导出品牌套件。不要自动导出——套件会确定最终品牌，因此只有品牌定稿后才能构建。例外：在自主完整模式下，明确的简报已授权交付全部成果，因此指南通过 QA 后即可导出 brand-kit.zip。

然后构建一个全面的品牌套件 ZIP，让用户能够在任何地方制作符合品牌规范的内容——在 Claude、GPT、Figma 中，也可以交由设计师或开发者制作。

套件结构：

[brand-name]-brand-kit.zip
├── brand.md                       # comprehensive machine-readable spec
├── brand-guidelines.pdf           # full 14-16-page guidelines PDF (the visual deliverable)
├── README.md                      # 1-page how-to-use guide
├── logo/
│   ├── symbol/                    # standalone mark — RASTER ONLY, no SVG (symbol is generated PNG, not traced)
│   │   ├── symbol-[color]-16.png
│   │   ├── symbol-[color]-32.png
│   │   ├── symbol-[color]-64.png
│   │   ├── symbol-[color]-128.png
│   │   ├── symbol-[color]-256.png
│   │   ├── symbol-[color]-512.png
│   │   ├── symbol-[color]-1024.png
│   │   └── symbol-[color]-2048.png
│   ├── wordmark/                  # the brand name — vectorized via text-as-paths
│   │   ├── wordmark-[color].svg
│   │   └── wordmark-[color].png
│   └── lockup/                    # symbol + wordmark together at locked measurements
│       ├── horizontal/
│       │   ├── lockup-h-[color].svg
│       │   └── lockup-h-[color].png
│       └── stacked/
│           ├── lockup-s-[color].svg
│           └── lockup-s-[color].png
├── icons/                         # digital brands only — UI icons from the Icons page as SVGs
│   ├── arrow-right.svg
│   ├── check.svg
│   ├── close.svg
│   ├── plus.svg
│   ├── search.svg
│   ├── user.svg
│   ├── settings.svg
│   ├── bell.svg
│   ├── menu.svg
│   ├── info.svg
│   └── [+ any brand-specific icons]
├── fonts/                         # actual TTF font files (OFL-licensed Google Fonts)
│   ├── [display-font]-Variable.ttf
│   ├── [body-font]-Variable.ttf
│   └── README.md                  # license + install instructions
├── tokens/                        # design tokens for devs
│   ├── tokens.css                 # CSS custom properties — paste into :root
│   ├── tokens.json                # same content in JSON — for AI tools / CI
│   └── tailwind.config.snippet.js # paste into tailwind.config.js extend block
└── prompts/                       # AI prompts for downstream brand use
    ├── system-prompt.md           # paste at the top of a Claude/GPT thread for brand voice
    ├── tweet.md                   # task-specific starter: write a tweet
    ├── landing-hero.md            # task-specific starter: landing page hero copy
    ├── email.md                   # task-specific starter: marketing/transactional email
    ├── error-message.md           # task-specific starter: write a friendly error
    ├── photography.md             # task starter: generate brand-style photography (with cliché guardrails + brand-photography rules embedded)
    └── illustration.md            # task starter: generate brand-style illustration (only if the brand uses illustration as a medium)

要导出的色彩变体（按标志分别导出）：浅色背景上的主色版、深色背景上的主色版、浅色背景上的中性色版（墨色）、深色背景上的中性色版（奶油色），以及一种彩色背景上的强调色组合。每种标志类型通常需要 4-5 组配色。

brand.md — 完整结构请参阅 references/brand-md-template.md。必须包含：

• 快速参考区块（在一个便于快速浏览的部分中列出名称、标语、主色、字体和品牌声音）
• 品牌定位 + 受众细分
• 使命、价值观、品牌故事
• 品牌声音与语气（形容词、不同场景下的文案示例、禁用词）
• 色彩（包含 HEX／RGB／CMYK／Pantone／用途的表格）
• 字体（展示字体 + 正文字体 + Google Fonts URL + 完整字体层级）
• 标志（文字标志说明 + 图形符号说明 + 组合规范 + 含路径的文件列表）
• 摄影规则
• 视觉世界说明
• 触点规范
• 应做与不应做事项清单
• 参考品牌及“可借鉴之处”说明
• 使用方法部分，说明下游工具／人员如何应用规范 Logo 资源流程：

1. 符号资源 — 符号是生成的栅格图形，因此仅导出 PNG。从经批准的 2048x2048 透明主文件开始，验证 Alpha 通道确实透明，然后按每种所需的颜色／背景变体生成 16/32/64/128/256/512/1024/2048 PNG。不要将其描摹为 SVG，也不要声称它是矢量图。
2. 字标资源 — 将品牌名称渲染为真正的字体文本，然后把选定字体的文本转换为轮廓路径，生成 wordmark-[color].svg；另导出一个宽度为 1024 的透明 PNG 备用版本。字标可复现，因为它属于字体排版，而非图像生成产物。
3. 组合标识资源 — 按照锁定的尺寸，将经批准的符号 PNG 与轮廓字标组合起来。导出 lockup-[orientation]-[color].svg，其中内嵌 PNG，字标为路径；另提供一个宽度为 1024 的 PNG 备用版本。所有颜色变体的几何结构必须一致。
4. 可选印刷 PDF — 仅在用户或印刷商明确要求时添加 PDF。PDF 可以嵌入栅格符号和矢量字标，但它并非纯矢量 Logo 文件。
5. 图标 SVG — 仅适用于数字品牌，将图标集编写为独立 SVG，并统一应用 stroke="currentColor"、viewBox="0 0 24 24" 以及品牌选定的描边粗细和圆角样式。关于应包含哪些图标，请参阅 references/brand-guidelines.md 中的 "Icons Page — Structure & Rules"。
6. 设计令牌 — 根据品牌规范生成以下三个文件：
   • tokens.css — 包含 --color-*、--font-*、--font-size-*、--line-height-*、--space-*、--radius-*、--shadow-* 自定义属性的 :root 块
   • tokens.json — 相同内容的 JSON 对象，包含以下分区：color、font、fontSize、lineHeight、spacing、radius、shadow
   • tailwind.config.snippet.js — 可粘贴到 module.exports.theme.extend 中的 JavaScript 代码片段，涵盖颜色、fontFamily、fontSize、borderRadius、boxShadow
7. AI 提示词 — 根据品牌具体信息生成各提示词文件：
   • system-prompt.md — 可粘贴到任何 Claude/GPT 对话线程顶部的系统提示词。包括：品牌语气形容词、禁用词、文案规则、摄影方向、颜色／字体规范、语气示例。结尾写上 "Always apply this brand voice unless explicitly instructed otherwise."
   • tweet.md — 任务起始提示：最多 280 个字符、语气限制、目标推文示例，然后写上 "Task: [USER FILLS IN]"
   • landing-hero.md — 任务起始提示：首屏文案结构（标题 + 副标题 + CTA）、品牌语气规则、指南中的示例
   • email.md — 任务起始提示：邮件语气、主题行指南、正文结构、结尾署名惯例
   • error-message.md — 任务起始提示：品牌如何以符合语气的方式处理错误／空状态／加载状态（亲切而不机械，具体而不含糊）
   • photography.md — 用于生成品牌风格摄影作品（gpt-image-2 等）的任务起始提示。必须包括：根据品牌摄影方向定制的主提示词模板（主体、光线、色彩调校、群体多样性、质感）；明确列出“提示词中应避免的内容”（影棚闪光灯、图库用语、玻璃办公空间、“工程师在笔记本电脑前”、“专业”、“高端”等）；陈词滥调概念禁用清单（沙漏、灯泡、握手、网络节点、发光的大脑等）；“正在做 X 的人”的主体替代方案；质量要求（黄油色点缀、多样性、胶片颗粒、纪实风格）；明确的禁止文字防护语句；禁止提及真实出版物的说明。
   • illustration.md — 仅当品牌使用插画作为一种媒介时提供。用于生成品牌风格插画的任务起始提示。包含严格遵循调色板和风格规则（扁平矢量／线稿等）的主提示词模板、禁用元素（渐变、投影、3D、摄影质感），以及何时使用插画而非摄影的说明。若品牌视觉体系中没有插画，则完全跳过此文件。
8. 品牌字体 — 本地导出步骤。从 Google Fonts（或品牌字体所在位置）下载实际字体文件，并放入 fonts/：
   • 如有可变字体文件，则使用：[FontName]-Variable.ttf（单个文件，支持所有字重）
   • 或使用品牌采用的各个静态字重
   • 在本地渲染 HTML 中通过绝对 file:// 路径使用本地 TTF 文件
   • 添加 fonts/README.md，注明许可证（常见的是允许再分发的 OFL）以及用于在线安装的 Google Fonts URL
9. 品牌指南 PDF — 将第 3 步生成的 14-16 页品牌指南 PDF 复制到工具包中，命名为 brand-guidelines.pdf。缺少此文件的工具包是不完整的。
10. README.md — 一页指南，向用户说明：工具包包含哪些内容、如何将 brand.md 与 AI 工具搭配使用、不同场景应使用哪个 Logo 文件、字体安装位置（本地 TTF 文件或 Google Fonts URL），以及如何使用摄影／插画提示词。
11. 打包所有内容：zip -r [brand]-brand-kit.zip brand.md brand-guidelines.pdf README.md logo/ icons/ fonts/ tokens/ prompts/ **品牌工具包完成门槛：**用户确认导出，或在 --config 中设置 export_kit 时，品牌工具包 zip 必须作为交付物。 只有在 zip 存在且包含 brand.md、brand-guidelines.pdf、README、Logo 素材、图标、字体、设计令牌 和提示词时，才能将品牌工具包标记为已完成。如果无法生成任何必需文件，请停下并提供可恢复的检查点，列出缺失文件，而不是交付不完整的 zip。

README.md — 1 页指南，告知用户：

• 工具包包含哪些内容
• 如何将 brand.md 与 AI 工具配合使用（粘贴到 Claude/GPT 中，生成符合品牌风格的作品）
• 不同场景应使用哪个 Logo 文件（网站 favicon → PNG 符号；印刷品 → PDF；网站页眉 → SVG 字标；等等）
• 字体安装链接（Google Fonts URL 和本地 TTF 文件名）

交付：

• Mac 本地用户的 zip 保存到 ~/Desktop/[brand-name]-brand-kit.zip。
• 如果环境无法下载字体或写入本地 zip，请勿交付不完整的工具包。停下并提供可恢复的阻塞检查点，列出 已完成的产物（本地 PDF 路径、brand.md、设计令牌、Logo 素材）、缺失的 文件，以及具体的文件系统／网络阻塞原因。
• 仅在用户明确要求时托管已完成的 zip。
• 告知用户已完成的 zip 中包含哪些内容，并提供 brand.md 链接，让用户无需解压即可预览。

交付后质量门槛

在宣布任一交付物成功之前，先渲染本地预览图像，并执行结构化视觉 QA 检查，给出结构化判定：

• 快速模式：交付快速品牌包之前，检查 quick-brand.pdf 的 PNG/JPG 预览图或缩略图表。
• 完整模式：交付本地 PDF 路径之前，检查用于审核指南 PDF 的最终页面 PNG/JPG 预览图或缩略图表。不要将对最终 PDF 运行 analyze_media 作为主要 QA 路径；页面预览是 QA 产物，因为它能展示页面级布局，并避免大型 PDF 光栅化失败。

Return JSON only: {
  "verdict": "clean" | "degraded" | "catastrophic",
  "observations": string[],
  "quality_warning": string | null,
  "re_roll_suggestion": string | null
}
Check that the brand name is spelled consistently, the `quick-brand.pdf` or guidelines PDF preview shows the required pages, low-contrast text is not present, the wordmark/symbol are not garbled, and there are no blank or duplicate-looking pages.

• 如果 verdict 为 clean，正常返回快速品牌包或本地 PDF 路径。
• 如果 verdict 为 degraded，返回快速品牌包或本地 PDF 路径，并附上 quality_warning，供用户在发布前审核。
• 如果 verdict 为 catastrophic，不要将方案集标记为完成；应展示判定和 re_roll_suggestion，而不是宣布成功。

核心原则

• **输入就是需求说明。**不要要求用户填写冗长的资料表。阅读现有内容，并提出 3-5 个精准问题。
• **明确描述客户群体，但不要将品牌局限于某一个人。**受众描述模糊会导致品牌薄弱，但过于具体的个人画像会让产出狭隘到无法使用。先定义受众细分：一个主要细分群体、1-2 个次要细分群体，以及一个让主要细分群体变得具体的核心人物画像。
• **完整模式的主要选择环节提供 3 个方案板。**步骤 2 始终提供三个视觉品牌方案板，而不是纯文字方向或套用模板重新配色。
• **有主见，也乐于协作。**自信地阐述你的判断，同时允许对方提出异议。
• 生成实际文案——不要提供带有 [方括号] 的模板。用品牌语气写出真实文案。
• **所有图像都必须真实且精心制作。**生成的生活方式／触点图像需要有胶片颗粒感、自然光线、些许瑕疵和编辑式构图。禁止：完美对称、渐变背景、影棚闪光灯、图库照片质感、光滑如 AI 生成的表面、白色背景上的悬浮物体。如果图像看起来不真实，请使用上文规定的图像重试次数；达到上限后不要继续重新生成。
• **每种所选深度只交付一套成果。**快速模式交付快速品牌包。交互式完整模式交付一份品牌指南 PDF；只有用户确认指南后，才可选交付品牌工具包。自主式完整模式交付全部三项完整产物：品牌方案板、指南和品牌工具包。

---

品牌质量标准

此技能生成的每个品牌都应符合以下标准。泛泛而谈的输出就意味着失败，因为交付成果是为了指导真实的设计决策，而不是装点模板。

反平庸测试

交付任何内容之前，先问自己：这也可以是任何其他东西的品牌吗？ 如果答案是肯定的，那就还没做好。

强势品牌 = 具体的产品／服务 + 清晰的受众画像 + 鲜明的立场。弱势品牌 = 氛围感 + 美学情绪板 + 空洞的标语。绝不要交付后者。

文案标准

优秀的品牌文案应当：

• 提出具体主张：“厚实羊毛。经久耐穿，十年如一日。”／“为每天一段安静时光而打造。”
• 有鲜明立场：“不追潮流。不做量产。”
• 能对细分受众中的读者说具体的话：“在查看手机之前，你会先打开的应用。” 这是文案风格，不是受众策略；不要把品牌的受众画像缩窄到只有这类读者。
• 营造张力或对比：“手工制作。反复穿着。刻意如此。”
• 信任读者：不过度解释，不说“适合任何场合”，不说“温馨氛围”

糟糕的品牌文案听起来像：

• “倾注爱意，精心打造”／“用心制作”／“满怀热情设计”
• “适合任何场合”／“永不过时的点缀”
• “品质，触手可及”／“设计，激发灵感”
• 泛泛的标语：“品质与风格的交汇”／“穿出你的故事”
• 空洞的最高级：“高端”“奢华”“格调升级”“精心甄选”“匠心”
• 任何无需改动一个字，就能描述其他 500 个品牌的内容

**标语测试：**出色的标语只能属于这个品牌。“手工制作。反复穿着。刻意如此。”属于 WORN。“Just do it.” 属于 Nike。如果你的标语随便放在任何一家 Etsy 商店或 Squarespace 网站上都不会有人察觉，就重写。

设计标准

编辑风格的品牌设计应当：

• 字体层级鲜明——最重要的元素一目了然
• 大胆运用色彩——使用大面积色块，而非点缀色点
• 摄影图像铺满边缘——不让图片带着投影悬浮
• 形成尺度对比——一个元素占据主导，其他元素退居次位
• 页面看起来经过设计，而不是拼装而成
• 留白经过刻意安排，而不是默认的内边距

平庸的品牌设计看起来像：

• 尺寸相同的方框整齐排列成网格
• 正文与其他所有内容字号一样
• 所有内容都居中
• 白色背景上点缀几个彩色方框
• 照片带圆角，悬浮在空白处
• 写着“字体名称在此”或“示例文本”的字体样张
• 看起来像油漆店宣传册的色卡

**版式规则：**如果一个页面能在 10 分钟内用 Canva 或 PowerPoint 做出来，那就还不够好。每个页面都应包含只有有品位的人才会做出的设计决策。

摄影与多元化标准

生成的图片组中若有人物，应展现种族多元性。这样可以避免每个品牌世界都默认采用同一套狭窄的人物组合。

• 对所有 4 张以上的生活方式图片，默认采用多元人物组合：包括黑人、亚裔、拉丁裔、南亚裔、中东裔或混血人物
• 丰富体型，而不只是肤色
• 如果只展示一个人，要刻意选择这个人是谁——不要默认选择白人／浅肤色人物
• 多元化不是打勾了事，而是一种设计选择，能让品牌更有共鸣，也更真实

摄影必须像真实抓拍，而非刻意摆拍：

• 有真实生活痕迹的真实房间（纸张、植物、磨损的家具）
• 不完美的光线（窗边光线、阴天光线、清晨光线）
• 始终带有胶片颗粒——哪怕只有一点
• 人物不要看镜头，除非这是经过深思熟虑的选择

Deck / 指南设计标准

• 必须加载字体。下载实际字体文件，并在本地渲染 HTML 中使用绝对 file:// 路径。签核渲染结果前，务必确认字体已加载。如果字体回退到系统默认字体，这份 Deck 就不合格，不能交付。
• 完整的本地渲染规范和 QA 规则请参阅 references/brand-guidelines.md。
• 每一页都必须有清晰的视觉层次——让人一眼知道先看什么。
• 满版摄影页面应有杂志跨页的感觉，而不是幻灯片的样式。
• 色板页面：使用满版色彩分栏，而不是漂浮在白底上的色样。
• Logo 页面：Logo 要足够醒目且尺寸大，并清楚展示不同版本，不能显得过于低调或太小。
• 品牌语气页面：展示真实的品牌文案，而不是通用示例文案。
• 触点页面：必须包含实际触点的生成照片——绝不能使用 CSS 方框。

将指南交付为一个本地 PDF，而不是单张页面图片。保存 PDF 路径，并在导出品牌套件时将其复制到品牌套件 zip 中。

品味检查

交付任何品牌成果前，先问自己：

1. 一个品味不错的 25 岁年轻人，会想购买这个品牌的产品、使用这个品牌或为这个品牌工作吗？
2. 文案听起来像真人写的吗？
3. 设计看起来像真正的设计师做的吗？
4. 照片中的人物多元且看起来自然吗？
5. 品牌是否有明确的立场——有某种它所坚持、而其他品牌没有的东西吗？

如果有任何一个问题的答案是“不确定”，就先改进再交付。始终牢记，鲜明而具体胜过稳妥而泛泛。

---

承载核心要求的短语

以下短语是避免这项技能偏离方向、产出千篇一律品牌手册的关键锚点：

短语	位置	为何是核心要求
different business answer — not aesthetic variations	步骤 2：视觉方案板	先确保定位多样，再追求视觉多样。
fonts must have character	步骤 2：视觉方案板	防止安全牌字体让每个品牌看起来都千篇一律。
no load-bearing text on generated images	指南制作规则	确保品牌主张能在确定性 HTML/PDF 中编辑且清晰可读。
film grain, natural light, slight imperfections	图像质量标准	让生活方式和触点图片摆脱图库照片般的过度平滑感。
Name a specific ethnicity per prompt	多元角色阵容调整	相比泛泛的多元化表述，更可靠地纠正模型倾向于默认生成全白人角色的情况。

---

引擎选择：gpt-image-2（注意事项）

所有品牌图像默认使用 gpt-image-2，设置 quality: "medium"。原因：

• 对角色多样性提示词的遵循度最高（除非提示词写得非常充分，否则 nano-banana-pro 往往会偏向默认生成白人角色）。
• 遵循禁止文字的要求最为可靠——这对触点图片至关重要，例如吊牌、织唛和贴纸；图像中只要生成了文字，就会毁掉样机效果。
• 原生 3:4 / 4:3 / 9:16 比例在裁切清晰主体时效果干净，不会出现奇怪的拉伸。

这项技能中应避免使用 nano-banana-pro——提示词中提到“editorial”时，它会在产品图中生成杂志封面风格的文字。对于 1200×850 的 PDF 页面，gpt-image-2 的 1K 分辨率绰绰有余；只有在特定触点确实需要印刷级分辨率时，才提高到 gpt-image-2 的 2K 档位（或改用 seedream 获得更高分辨率）。（gpt-image-2 的 4K 仅支持 16:9 / 9:16；如果这项技能需要 4K 的 3:4 / 4:3 比例，则会改用 seedream。）

运行时间预期

一开始就告知用户大致总耗时——长时间的阶段没有状态更新，会让人觉得流程卡住了。提供时间戳时，始终使用 PST 时间。

快速品牌目标

阶段	目标耗时	备注
接收需求 + 明确假设	1-2 分钟	除非原始输入缺失，否则跳过多轮问答
一套策略 + 品牌形象	2-3 分钟	选择最强方向；不绕道提供 3 个选项
标志／氛围／触点素材	3-5 分钟	总共最多生成 4 张图，除非 QA 未通过
快速 PDF + 套件文件	2-3 分钟	3 页 PDF、精简版 brand.md、设计令牌、提示词、可用的标志素材
快速 QA + 交付	1-2 分钟	检查 PNG 预览；仅在出现阻断性问题时重新渲染

快速目标总耗时：收到可用输入后 8-12 分钟，不包括等待用户回复的时间。

完整品牌手册时间清单

每次完整运行都要在工作笔记中维护时间清单，并将其纳入最终交付或可恢复检查点。记录以下时间的 PST 时间戳：

• 收到输入／选择模式
• 完成需求梳理
• 起草视觉方案板
• 开始／完成品牌板渲染
• 锁定用户的品牌形象选择
• 开始／完成第 1 批图像生成
• 开始／完成第 2 批图像生成
• 开始／完成完整指南渲染
• 开始／完成整套页面的 QA
• 开始／完成品牌套件导出（如有需要）

如果一次运行又耗时约 2 小时，不要猜测时间都花在哪里。使用这份清单找出实际最耗时的阶段，并将相关证据纳入下一轮优化。

完整品牌手册目标

阶段	耗时	备注
阶段 0 → 步骤 1（问答循环）	5–15 分钟	依用户回复速度而定；将问题放在一条消息中
步骤 2（3 个视觉品牌方案板 PDF）	6–10 分钟	每个方案板包含标志 + 一张氛围图 + 本地 Chrome 渲染
步骤 3 图像生成（通过 gpt-image-2 生成 8 张照片，分 2 批并行，每批 4 张）	8–12 分钟	最耗时的阶段；每批约 4–6 分钟
步骤 3 页面构建（14-16 个 HTML 页面 + 本地渲染）	2–5 分钟	优先使用 Chrome 无头模式；备用方案为 WeasyPrint
步骤 4 品牌套件 zip	3–5 分钟	标志 PNG 尺寸 + 字标／组合标志 SVG+PNG + 按需提供的图标 + 设计令牌 + 字体 + 提示词

完整目标总耗时：约 25–45 分钟的实际用时，不包括等待用户回复的时间。近期实地反馈显示，为付费创作者教程录制从头到尾耗时约 2 小时；应将其视为需要改善的基线问题，而非可接受的目标。

---

故障模式

从 generate_image 上游 5xx 错误中恢复

如果任何付费生成或渲染 MCP 调用返回：

• code: "provider_5xx" 且 retry_class: "retry_after_backoff"
• 或上游图像提供方返回 HTTP 502 / 503 / 504

请按以下步骤处理：

1. 等待 5 秒。
2. 使用完全相同的参数重新调用完全相同的 MCP 工具。不要重写提示词、替换字体、更改配色、更改 HTML、更换提供方或重新生成输入。
3. 如果重试后仍返回 5xx，则中止并告知用户：“提供方两次返回暂时性上游错误。请在 1-2 分钟后重试；这类问题通常会自行消失。”

重试次数不得超过 1 次。这是暂时性服务中断，不是品牌方向问题；更改创意简报会浪费额度，也会增加比较重试结果的难度。

从上游 4xx／moderation_blocked 中恢复

如果 generate_image 使用 provider="gpt-image-2" 时返回上游 4xx 或 moderation_blocked：

1. 不要使用相同提示词重试；审核拦截和大多数 4xx 验证失败都是确定性的。
2. 如果失败的素材是生成的标志或生活方式图片，只有在简报允许的情况下才尝试一次备用提供方：高分辨率品牌图像使用 seedream，简单几何标志使用内联 SVG。
3. 如果备用提供方也失败，或会实质性改变品牌方向，则告知用户：“图像提供方拒绝了此品牌图像提示词。请尝试使用不那么容易识别的参考图，移除真实出版物／名人相关线索，或批准使用 SVG／简易标志替代方案。”

从上游 429（速率限制）中恢复

如果任何上游返回 HTTP 429 并附带退避提示：

1. 等待提示的退避时间；如果没有提供提示，则等待 30 秒。
2. 使用完全相同的参数，再次调用完全相同的 MCP 工具。
3. 最多只能重试一次。如果仍返回 429，请中止操作并显示速率限制消息，不要再发起其他调用。

capture_website 返回空内容／页面未加载

此技能通常根据用户的回答和提供的素材构建内容，但 URL 来源的参考资料或未来的接收辅助工具可能会调用 capture_website。如果 capture_website 返回 200，但 action_bboxes 为空或 recording_viewport 为 0x0：

1. 不要重试；页面未能在捕获环境中呈现。
2. 显示：“无法捕获 。该页面可能受到屏蔽／需要付费订阅／需要身份验证。请改为提供屏幕截图、徽标或托管的素材。”

task_status 长时间运行并超过上限

每个异步 MCP 调用都会返回内联结果或用于轮询的 {task_id, status}。在判断任务卡住之前，请使用以下时间上限：

• gpt-image-2 高质量：每次调用 3 min
• Seedream 图像生成：每次调用 3 min

使用以下两者中较早的时间：提供商时间上限 × 1.5，或特定技能的硬性轮询上限。如果 task_status 在较早的上限之后仍返回 status: "processing" 或 status: "queued"，请调用 task_cancel({task_id}) 并提示：“提供商耗时异常；正在中止。请重试。”

症状	原因	修复方法
PDF 中的字体显示为 Times / Arial	@font-face 指向缺失的本地路径或相对路径	将 TTF 下载到本地工作区，使用绝对 file:// 路径声明字体，并在生成完整 PDF 前渲染一页本地预览
生成的图像带有内嵌杂志标题或水印	提示词提到了“magazine cover”、“Vogue”、“TIME”、“Bloomberg”或任何真实出版物	从提示词中移除出版物名称；逐字附加禁止文字的约束；在图像重试预算内重新生成一次。描述视觉特征，而不是出版物
接触点 / 生活方式照片只显示额头 / 只裁剪出手部	9:16 纵向源图被裁剪到横向单元格	重新生成并设置 aspect_ratio: "4:3" 或 "16:9" 以匹配单元格比例，或将版式改为纵向单元格
页面超出 850px 上限	标题超过 60px，且同一页正文段落超过 3 段	精简内容，将标题缩至 48px，或拆分为两页。重新渲染并通过截图检查
展板虽然符合技术要求，但观感不佳	装饰过多、文字太小、配色单调暗沉、模拟图为空，或层级不清	按照 brand-identity.md 中的预算重写展板文案，移除装饰性微型文字，将正文字号增至 18px 以上，增加留白和对比度，并重新运行 PNG + 视觉 QA
文字与图标 / 色样 / 印章 / 模拟图重叠	装饰元素或绝对定位元素与文案占用了相同的阅读区域	为文字提供清晰的阅读栏 / 卡片，仅将图形放在文字区域后方，并重新渲染。scrollHeight 检查通过并不够；如果同级图形遮挡文字，仍然有问题
多页展板看起来像换了配色的模板	重复使用同一模板，仅更换配色	根据 references/brand-guidelines.md 中的“Brand Board Layout — Differentiate per Option”重新构建——每个展板的版式都必须切实体现其设计理念
多页合并失败	缺少 pdfunite 或本地合并工具	对完整 HTML 文档使用 Chrome --print-to-pdf，或改用 Python pypdf.PdfWriter().append()
用户选择混合风格的品牌形象（“02 的配色 + 01 的语气”）	技能假定用户只会选择单一选项	在步骤 3 前制定混合规格简报，并在渲染 14-16 页前向用户确认
用户要求托管 PDF，但上传失败	PDF 上传路径通常会拒绝 application/pdf	将本地 PDF 作为规范版本；如需托管，请使用用户认可的文件托管服务或部署路径
尽管要求多元化，生活方式网格中的人物肤色仍全都偏白	如果提示词没有明确写出族裔，gpt-image-2 默认会生成较浅的肤色	在每条提示词中指定具体族裔（Black、mixed-race East-Asian-and-white、East Asian、Latina、South Asian、Middle Eastern），并在 4 条网格提示词中交替使用