从想法/网站/参考品牌搭出可交付品牌识别（快速品牌或完整品牌…

当用户要「build me a brand / 设计品牌识别 / 品牌手册 / 重做现有品牌」但不需要完整电商上线时，用 Pika MCP 生成策略、视觉识别、指南 PDF 与品牌工具包。

适用场景

解决思路

1. 先选深度模式：默认走 quick brand（8-12 分钟、最多 4 张生成图、一次快速 PDF 渲染加一次必要重渲染）；只有用户明确说 full / brand book / brand guidelines / 14-16-page / --full，或在快速交付后同意 go deeper 时才走完整品牌手册（25-45 分钟）。快速品牌是独立完整的小交付物，不是失败或残缺的完整手册。
2. 空参数调用时（没有想法、URL、照片、参考品牌、无相关上下文），原样打印 intake 菜单并停止，不调用任何工具，等用户下一条消息。已有任一输入就跳过菜单直接进入所选模式。
3. 非交互快车道：--quick 或 --config 或 CI/subagent/批量/教程录制场景下，用模型判断推断默认值并内联记录假设，不在交付预览、策略方向选择、识别方案选择、品牌包导出这四个关卡停下确认；只有原始输入完全缺失、或必需资产无法推断时才停一次并给一份紧凑的缺失字段清单。--full 不得因此交付精简版。
4. 付费闸门：任何付费 MCP 调用前先调 identity_balance({verbose: true})，展示当前余额、近期消耗速率、剩余可用量，然后给出费用估算消息（快速品牌约 100-300 credits / $1-$3，完整手册约 900-1500 credits / $9-$15），等用户回复 proceed 才继续，回复 cancel 就停止生成；非交互调用要求在 config 或调用元数据里有 cost_ack=proceed，否则停并给估算而不花钱。
5. 本地优先执行：工作区搭建、字体下载、图片下载后的落盘、图片压缩、透明背景清理、16x16 favicon 测试、HTML/CSS 页面构建、PDF 渲染、PNG/JPG QA 截图、logo 资产组装、token/prompt 文件、最终 zip 打包都在用户本机做；只有付费生成（gpt-image-2）和需要时的 URL/来源研究走云。不要用云端 PDF 渲染器，也不要默认上传 PDF。
6. PDF 资产瘦身：绝不把全尺寸 gpt-image-2 PNG 直接嵌进 board 或指南 PDF；每张图先下载、降采样到槽位尺寸、另存为约 85-180KB 的本地 JPEG 再进渲染 HTML。透明 PNG 只保留给 logo/symbol 源资产和 favicon/logo 导出，不用于照片类版面。
7. 渲染 HTML 里禁止对照片或 background-image 使用任何 CSS filter / backdrop-filter（暖调、sepia、saturate、brightness、blur）——Chromium 会把该元素在 PDF 里栅格化成全分辨率无损位图，抵消上面的 JPEG 优化；颜色分级要烘焙进 JPEG 本身（在 gpt-image-2 prompt 里，或 img.save(..., 'JPEG', ...) 时）。只有透明 logo PNG 的 drop-shadow() 是安全滤镜。
8. Quick Step 1 单轮 intake：有可用输入就不做长问卷，直接声明所用假设；只在答案会实质改变品牌时问最多 3 个紧凑问题（卖什么/做什么、给谁、是否保留既有名称 logo 配色字体 照片或参考）。非交互流程直接推断默认值并写进输出。
9. Quick Step 2 只选一个最强方向，不呈现 2-3 个方向、不给 3 个识别方案；用模型判断挑最强策略与识别，且必须包含：品牌名或保留名、8 词以内 tagline、受众（primary 段、secondary 段、一个 anchor persona）、定位陈述、保留资产、用户提供的参考品牌/灵感。
10. Quick Step 3 建一套自洽的起步识别：logo 概念（wordmark + 独立 symbol/mark + lockup 方案，新 symbol 用 generate_image 且 provider="gpt-image-2"，以透明 PNG 尺寸而非 SVG 交付；wordmark 和 lockup 可以出 SVG，因为 wordmark 由真实字体文字转轮廓路径）；4 个核心色带角色和 hex；字体（一个有性格的 display + 一个实用 body，附 Google Fonts URL）；声音（3 条语气原则、3 条示例文案、5 个禁用词/短语）；图像方向（一套简短照片/插画规则 + 无文字图像 prompt 护栏）；3 个起步应用（社交头像/app 图标、简单 web hero 方向、一个符合品牌类型的实用触点）。
11. 图像生成配额：1 张 symbol/mark 图 + 最多 3 张 mood 或 touchpoint 图；每个生成资源总共最多 2 次尝试（初次 + 一次定向重生成）；QA 失败只重生成失败的那个资源；任一上限用尽后停下，问用户想放宽哪个失败资源或版面问题，不要继续烧 credits。
12. Quick Step 4 交付一个可直接使用的快速品牌包：[brand-name]-quick-brand/ 内含 quick-brand.pdf（3 页）、brand.md、README.md、logo/、tokens/tokens.css + tokens.json + tailwind.config.snippet.js、prompts/system-prompt.md + imagery.md。3 页结构为：1) 封面+策略（品牌名、tagline、定位、受众分段、anchor persona、参考、主视觉）；2) 识别系统（logo 系统、色板、字体、声音规则、图像规则）；3) 起步应用（社交头像/app 图标、web hero/社交卡片方向、一个真实触点或产品场景图，外加 3 条品牌专属 do 和 3 条 don't）。
13. 本地用 Chrome headless 渲染 quick-brand.pdf（HTML 为其适配时可用 WeasyPrint），交付前检查 PNG/JPG 预览；视觉 QA 必须抓住文字被裁、logo/symbol 缺失、字不可读、生成图里烘进了文字、空占位、明显布局碰撞。若包或 zip 无法产出，停下给可续跑 checkpoint，列出已完成文件、缺失文件、资产路径/URL 和确切阻塞点。
14. 快速品牌交付后再主动提供 14-16 页完整指南作为 go deeper 升级；用户明确要求前不要启动完整流程。
15. Full Step 1 先给 4 步 agenda（读输入 → 3 个视觉品牌板 → 构建指南 → 导出品牌包），再用一条消息问 3-5 个针对性问题，按输入类型适配（想法/描述、网站或现有品牌 URL、产品照片、只有参考品牌）；无论哪种输入都固定附带两个通用问题：是否有想保留或纳入的既有品牌资产、是否有特定参考/灵感/moodboard；并问是否为数字产品（决定 Icons 页是否保留）。只发一条消息，等回答再继续。
16. 用户回答后，把输入与回答合起来分析并回读：美学领域、受众分段（primary、secondary、一个生动的 anchor persona，不要把受众压缩成单个过度具体的人）、定位（差异楔子）、价格层级/品类位置、故事钩子、明确列出要保留的资产、用户点名的参考品牌。
17. 构建前先预览最终指南内容，邀请用户指出要增加、修改、特别强调或排除的东西，等回复并把具体指引纳入后再进 Step 2——这比 PDF 建完才发现范围不匹配便宜得多。
18. Step 2 生成 3 页 brand boards PDF（每页 1200×850，存 ~/Desktop/[brand-slug]-brand-boards.pdf），三个方向必须真不同，按「为谁做、为什么存在」区分，而不是同一模板换色；每个方案必须包含：wordmark（用品牌 display 字体，新 wordmark 必须有自定义字形处理——调整字距、连字、切口、端点、大小写、下划线等可拥有的细节，不是随便挑个 Google Font 打字）、独立 symbol/mark（新 symbol 用 gpt-image-2 出透明 PNG，要求干净孤立、居中于正方形、无烘进文字、无 watermark、无 mockup；不要描成 SVG；必须在 16×16 和 512×512 都能用）、seal/badge（若使用，必须在小中尺寸可读且可拥有，不能是通用圆形字体组合、剪贴画徽章或低对比装饰填充）、8 词以内 tagline、带可见 VOICE 标签的 14 词以内引语、约 35 词以内且至少 2 句的 board 故事、带可见 WORLD 标签的约 22 词以上 WORLD 描述、一张 gpt-image-2 生成的生活氛围图、4 色带 hex 和角色标签、display + body 字体样本（写出字体名）。
19. Board 版面要能不看标签就分辨出是哪个品牌：不用同一模板换色三次，每个 board 的布局要体现该方案的设计哲学（杂志封面方案要像杂志封面，柔和消费方案要像主页 hero 圆角+圆形色块，编辑方案要像文学跨页）。
20. Board 视觉 QA：先看每张 PNG 预览，失败项包括密度丑、层级弱、单色浑浊、小字不可读、空 mockup/图片槽、文字裁切、正文或非报头文字与图标/色块/seal/照片/手机 mockup/装饰线相交；同时对 symbol 在 16×16 和 512×512 检查，小尺寸不可读、浑浊、太通用或糊成噪点就重生成或简化。再按全尺寸重读一遍，失败低对比字、小字不可读、文字/照片碰撞、内容缺失、层级弱、单色浑浊。Board 上的报头式 wordmark/tagline/期号叠在照片上只有在使用刻意留白或对比蒙版并通过对比 QA 时才允许，正文压在图上仍禁止。技术合规但难看同样算失败，要简化层级、文案密度或装饰后重渲。
21. 重试预算：每个 board 或指南 PDF 的视觉 QA 循环对同一方案/同一套牌最多 2 次渲染/修复尝试（初次 + 一次修复重渲）。任一上限用尽就停下问用户想放宽哪个失败资源或版面问题，附失败页/资源名、QA 原因和目前最好的预览。
22. 字体规则：每个品牌换新字体，且字体必须有性格；绝不默认 Inter / Karla / Outfit / DM Sans / Lato（作 display 字体没有观点）。探索整个 Google Fonts 库；把选定字体文件下载到本地，在渲染 HTML 里用绝对 file:// 的 @font-face 声明。非拉丁品牌名要给所有 font-family 链加宽脚本回退（display/serif 链带 Noto Serif SC/TC/JP/KR、Noto Sans Arabic；body/sans 链带 Noto Sans SC/TC/JP/KR、Noto Sans Arabic），靠 Chromium 逐字形回退避免豆腐块。
23. 只有用户选定某个 board（自主全量模式下由模型判断选最强或混合并记录假设）后才构建完整指南，避免在会被否掉的识别上浪费时间。页数条件化：非数字品牌单选媒介 14 页（跳过 Icons）、数字品牌单选媒介 15 页（含 Icons）、非数字品牌混合媒介 15 页（图像拆两页、跳过 Icons）、数字品牌混合媒介 16 页；按实际包含内容连续重编号，不留页码空缺。
24. 完整指南按条件包含这些页：1 封面（品牌名、tagline、主视觉、全出血）；2 策略与定位（方向名、一句定位陈述、primary/secondary 段 + 一个 anchor persona、3-4 个参考品牌带 borrow this 备注）；3 品牌基础（使命、3-5 条价值观、2-3 段真实品牌口吻的存在故事）；4 Logo（主标 + 全部变体、明暗/彩底使用规则、mark 说明、clear space）；5 Logo 禁忌（用 CSS 渲染拉伸/旋转/错误底色/改色/投影等违规，每条带 ✗）；6 色彩（全部色板带 hex + RGB + CMYK、主配色、可访问性/对比说明、禁止组合，全出血色柱而非白底漂浮色块）；7 字体（H1 到 caption 的完整层级与精确 px、display/accent/body 字体、各场景用法、彩底排版、最小字号）；8 Icons（仅数字品牌：8-12 个基础 UI 图标按品牌几何风格渲染 + 描边/转角/网格规则 + 图标库建议）；9 声音与语调（语气形容词、按场景的头条/正文/按钮/错误态/社交文案示例、禁用词，展示真实品牌文案而非通用示例）；10 图像规则（按品牌媒介适配为摄影主导/插画主导/混合拆两页，各含规则清单 + 1 个示例）；11 视觉世界（全出血 4 列 4 图网格，媒介组合匹配品牌）；12 触点真实照片（2×2 四张真实生成照片，按品牌类型适配：实体产品用吊牌/织唛微距/牛皮纸邮件袋/产品+包装平铺，数字产品用手持手机/桌上笔电/水瓶贴纸/场景托特包，服务品牌用名片在手/桌上笔记本/建筑标识/场景周边；此页不用 CSS 矢量 mockup）；13 品牌应用 CSS mockup（名片带尺寸、社交头像圆形裁切、贴纸/app 图标圆角方、邮件签名、演示封面；产品品牌再加吊牌/织唛/购物袋规格）；14 数字/社交（网站 hero 美学、3×3 Instagram 网格 mockup 带色板和 caption 语气、story 模板、link-in-bio 布局）；15 Do & Don't（5 条 do + 5 条 don't，品牌专属可执行，不要通用套话）。策略页和基础页必须排在 logo/色彩/字体之前。
25. 完整性闸门：不得交付精简或部分指南——6 页精简版、缺 Visual World 页、缺 Touchpoints 页、缺 Brand Applications 页都算失败的 checkpoint 而非交付物；时间不够就停下给可续跑 checkpoint，列已完成页、缺失页、生成资产 URL 和下一步渲染动作。所有页面渲染并通过 QA 前不得宣称完成。
26. 图片质量与多样性：所有生成的生活/触点图要有胶片颗粒、自然光、轻微不完美、编辑级构图；禁止完美对称、渐变背景、影棚灯、图库感、AI 光滑表面、白底漂浮物。有人物的图集要展现种族多样性（Black、Asian、Latina、South Asian、Middle Eastern、mixed-race），每个 prompt 明确写出具体族裔而不是泛泛写 diversity；同时变化体型，不只换肤色；只出现一人时也要刻意决定是谁，不要默认白/浅肤。
27. Step 4 品牌包导出是硬闸门：全量交互模式下，交付指南 PDF 后等用户明确批准再导出；不要自动导出。自主全量模式下，单一清晰的 brief 已授权全套交付，指南通过 QA 后即可导出 brand-kit.zip。zip 必须含 brand.md、brand-guidelines.pdf、README.md、logo/、icons/（数字品牌）、fonts/、tokens/、prompts/；任一必需文件产不出来就停下给可续跑 checkpoint 并列出缺失文件，不要发部分 zip。
28. Logo 资产管线：symbol 是生成的栅格 mark，只导出 PNG——从批准的 2048×2048 透明母版开始，验证真 alpha，再按每个颜色/底色变体生成 16/32/64/128/256/512/1024/2048 PNG；不要描成 SVG，不要声称是矢量。wordmark 用真实字体渲染后转轮廓路径出 wordmark-[color].svg，并加一张 1024 宽透明 PNG 兜底。lockup 用批准的 symbol PNG + 轮廓 wordmark 按锁定尺寸组装，出横版和竖版的 SVG（内嵌 PNG、wordmark 为路径）加 1024 宽 PNG 兜底，各颜色变体几何完全一致。只在用户或印厂明确要求时加打印 PDF。数字品牌的图标写成独立 SVG，用 stroke="currentColor"、viewBox="0 0 24 24"，全set统一描边粗细和转角风格。
29. 从品牌规格生成三个 design token 文件：tokens.css（:root 块里的 --color-*、--font-*、--font-size-*、--line-height-*、--space-*、--radius-*、--shadow-* 自定义属性）、tokens.json（同内容 JSON，分 color/font/fontSize/lineHeight/spacing/radius/shadow 段）、tailwind.config.snippet.js（可粘进 module.exports.theme.extend 的片段，覆盖 colors、fontFamily、fontSize、borderRadius、boxShadow）。
30. 生成 AI prompts 文件并内插品牌细节：system-prompt.md（品牌声音形容词、禁用词、文案规则、图像方向、色/字规格、示例声音，结尾写「Always apply this brand voice unless explicitly instructed otherwise.」）、tweet.md（280 字以内、语气约束、目标示例，结尾 Task: [USER FILLS IN]）、landing-hero.md（hero 文案结构 headline + subheadline + CTA）、email.md（邮件语气、主题行指引、正文结构、署名惯例）、error-message.md（错误/空/加载态的品牌口吻处理）；photography.md 必须含主 prompt 模板、明确「prompt 中要避免什么」列表、被禁的陈词滥调概念列表、人物类主体替代写法、质量要求、明确的无文字护栏字符串、绝不点名真实出版物的说明；illustration.md 只在品牌把插画当作媒介时才出，否则整个文件跳过。
31. 字体导出：从 Google Fonts（或品牌字体所在处）下载真实字体文件放进 fonts/，优先可变字体单文件，或用品牌实际使用的静态字重；本地渲染 HTML 用绝对 file:// 路径引用本地 TTF；加 fonts/README.md 写明许可（常见为 OFL，允许再分发）和在线安装用的 Google Fonts URL。
32. 打包命令：zip -r [brand]-brand-kit.zip brand.md brand-guidelines.pdf README.md logo/ icons/ fonts/ tokens/ prompts/。Mac 用户存 ~/Desktop/[brand-name]-brand-kit.zip，非 Mac 存项目工作目录并在回复里说明路径。只有用户明确要求才托管上传；报告 zip 内容并链接 brand.md 让用户不解压也能预览。
33. 交付前 post-flight 视觉 QA：渲染本地预览图或 contact sheet 做结构化检查（快速模式查 quick-brand.pdf 预览，完整模式查最终页预览，不要拿 analyze_media 跑最终 PDF 当主 QA 路径），核对品牌名拼写一致、页数齐全、无低对比文字、wordmark/symbol 未乱、无空白或重复页，然后只返回 JSON：{verdict: clean|degraded|catastrophic, observations: string[], quality_warning: string|null, re_roll_suggestion: string|null}。clean 正常交付；degraded 附 quality_warning 让用户先行复核；catastrophic 不算完成，给出 verdict 和 re_roll_suggestion。
34. 反通用检查：交付前问「这能不能是任何其他东西的品牌？」能就是没做完。强品牌 = 具体产品/服务 + 清晰受众模型 + 具体观点；弱品牌 = 氛围 + 美学 moodboard + 空 tagline。文案要有具体主张、有观点、有张力、信任读者，禁止「crafted with love / made with care / perfect for any occasion / quality you can feel / premium / luxury / elevated / curated / artisanal」和「Where quality meets style」这类可套用在 500 个品牌上的句子；tagline 必须只属于这个品牌。
35. 设计标准：强字体层级（一眼看出什么最重要）、色彩大胆用大面积色块而非点缀、照片出血到边不用浮动阴影图、尺度对比、页面像被设计过而不是拼装、留白有意为之。避免等大盒子网格、正文和所有元素同号、全部居中、白底加几个彩盒、圆角浮动图、写着 Font Name Here 的字体样本、像油漆店色卡的色板。字体必须真正加载（下载实际字体文件、绝对 file:// 路径、签署前验证字体已加载，回退到系统字体即视为交付物损坏）。
36. 图像引擎默认用 gpt-image-2、quality: "medium"；避免 nano-banana-pro（提示词提到 editorial 时会把杂志封面式文字烘进产品图）。1200×850 PDF 页面 1K 足够；只有某个触点真需要印刷级分辨率时才升到 2K 或改用 seedream（gpt-image-2 的 4K 仅支持 16:9/9:16，3:4/4:3 要 4K 时路由到 seedream）。
37. 失败恢复按类型处理：5xx / provider_5xx 且 retry_class=retry_after_backoff / HTTP 502-504 时等 5 秒，用完全相同的参数原样重调一次，不改 prompt、不换字体、不换色板、不改 HTML、不换 provider；第二次仍失败就中止并告知用户 1-2 分钟后重试。4xx 或 moderation_blocked 不重试同 prompt（确定性问题），可对 symbol/生活图尝试一次 fallback（seedream 或简单几何 mark 用内联 SVG），fallback 也失败或会实质改变品牌方向就告知用户换更不可识别的参考、去掉真实出版物/名人线索或接受 SVG/简单 mark 替代。429 按提示退避（无提示则等 30 秒）原样重调一次，仍失败就中止并上报速率限制。capture_website 返回 200 但 action_bboxes 为空或 viewport 为 0x0 时不重试，直接说明页面可能被拦/付费墙/需鉴权，请用户提供截图、logo 或托管资产。task_status 超过 min(provider 上限×1.5, 技能硬上限)（gpt-image-2 high quality 3 分钟、Seedream 3 分钟）仍是 processing/queued 时调 task_cancel({task_id}) 并告知用户中止重试。
38. 全程维护 timing manifest（PST 时间戳）：输入接收/模式选择、intake 完成、视觉板起草、board 渲染开始/完成、用户锁定识别、图像生成第 1 批和第 2 批开始/完成、完整指南渲染开始/完成、全牌 QA 开始/完成、品牌包导出开始/完成；把它写进最终交付或可续跑 checkpoint，用于定位最慢阶段。给用户的时间一律用 PST 表述。
39. 运行前先告知用户大致总时长，长阶段没有状态更新会让人感觉流程坏了。快速品牌目标 8-12 分钟（可用输入后，不含用户回复时间）：intake+假设 1-2 分钟、一个策略+识别 2-3 分钟、symbol/mood/触点资产 3-5 分钟、快速 PDF + 包内文件 2-3 分钟、快速 QA + 交付 1-2 分钟。完整手册目标 25-45 分钟（不含用户回复时间）：Stage 0→Step 1 问答 5-15 分钟、3 个视觉板 6-10 分钟、8 张 gpt-image-2 照片分两批各 4 张并行 8-12 分钟（最长阶段）、14-16 页 HTML 构建 + 本地渲染 2-5 分钟、品牌包 zip 3-5 分钟；把约 2 小时的旧基线当作要击败的症状而非可接受目标。

适用边界 · 注意事项

• 用户需要的是完整电商上线（Shopify、商品上架、社交媒体发布）时——本技能只做策略、识别、设计和文案，不含商业发布。
• 环境里没有 Pika MCP 工具（generate_image / task_status / identity_balance）或用户不愿支付图像生成积分时——整个流程依赖付费生成和余额检查。
• 用户想跳过品牌策略与身份系统、直接要成品矢量 logo 时——生成的 symbol 只交付透明 PNG 多尺寸，不描成 SVG。