social-graphics

用途

Social Graphics 用于把一条消息和一个平台转化为可直接发布的图形。它为每个素材产出一份 Social Graphic Spec——平台、精确尺寸、布局、叠加文案和完整的生成提示词——然后通过仓库管线（docs/creative_cli.py，模型 fal-ai/nano-banana-pro）生成图片。

其主导原则是：社交图形在不到两秒内被读取——一条消息、一个焦点、一个 CTA；如果观看者在缩略图大小的一瞥中无法抓住要点，那么无论全尺寸看起来多好，设计都是失败的。

何时使用 / 何时不使用

适用于平台绑定的静态视觉：信息流帖子、故事、Pins、链接预览图、公告图、引用卡片、轮播。

不适用：

Logo、图标、图案、品牌标识 → skills/creative/brand-asset
独立产品主图（无平台框架、无叠加文案）→ skills/creative/product-photography
动态内容 → skills/creative/product-video（产品主导）或 skills/creative/talking-head（人物主导）
尚无品牌风格且用户想要一致外观 → 先运行 skills/creative/creative-strategist；其风格指南会输入本技能
如果视觉语言本身显得通用、需要原创身份 → 先运行 skills/creative/original-design

信息收集

一次性集中询问，只问缺失项：

消息——这条帖子用一句话在说什么？观看者应该做什么（CTA）？
平台与格式——Instagram 信息流/故事/轮播、LinkedIn、Twitter/X、TikTok、Pinterest？单一平台还是多平台组合？
品牌约束——来自 skills/creative/creative-strategist 的风格指南、品牌颜色/字体、要展示的产品图像？
语气——专业、潮流、极简、俏皮？

可推断而非询问：从平台推断语气（LinkedIn → 专业；TikTok → 活力），从项目中的任何品牌材料推断颜色。不要卡住：有了清晰的消息和平台，对其余部分说明假设并继续。

平台规格（尺寸的事实来源）

平台	格式	像素	CLI 宽高比	设计姿态
Instagram	信息流帖子	1080×1080	1:1	鲜艳、高对比、潮流美学
Instagram	故事 / Reel 封面	1080×1920	9:16	全出血垂直、文字在安全区内
Instagram	轮播	1080×1350	4:5	每张卡片一个想法、卡片间视觉连续
LinkedIn	信息流帖子	1200×627	16:9*	专业、可信、价值导向文案
LinkedIn	文档页	1200×1500	4:5	干净、可读、商务图像
Twitter/X	帖子图片	1200×675	16:9	醒目、简单、即时视觉冲击
TikTok	缩略图/图形	1080×1920	9:16	粗体文字叠加、活力、真实感
Pinterest	标准 Pin	1000×1500	2:3	垂直、鼓舞人心、高质量图像

*最接近的受支持比例；CLI 支持 21:9、16:9、3:2、4:3、5:4、1:1、4:5、3:4、2:3、9:16——始终选择最接近的并注明任何裁剪。

工作流程

1. 确定平台与格式

如果用户指定了平台，使用上表。如果没有，判断：B2B/专业受众 → LinkedIn；消费者/生活方式 → Instagram；发现/教程/向往 → Pinterest；向现有粉丝公告 → 他们已有的平台（仅在确实未知时询问）。多平台请求 → 先为约束最强的格式（通常是 1:1 或 9:16）设计主版，然后按平台适配；绝不要拉伸一张图片用于所有平台。

2. 先写文案，再做视觉

标题：≤10 个词，消息本身，不是预告。
正文（可选）：≤2 短行，支持标题。
CTA：2–4 个词，动作动词（"Shop now"、"Get the guide"、"Link in bio"）。

如果文案无法符合这些限制，说明帖子承载了不止一条消息——将其拆分为轮播或多条帖子，并告诉用户原因。

3. 设计布局

选择一个焦点（产品图、插画、粗体排版），并将文案放在最安静的区域。决策规则：照片主导 → 标题在顶部或底部三分之一，覆盖在变暗/模糊的色带上；排版主导 → 标题就是焦点，图像最少；轮播 → 每张卡片使用相同的布局网格，只改变内容。三分法、充足留白、最多 2–3 种字体角色（标题/正文/CTA）。

4. 构建生成提示词

公式——每个提示词按顺序包含全部六个部分：

[平台 + 格式] graphic, [主体/焦点], [来自品牌或选定的调色板], [构图：焦点 + 预留文案空间的位置], [语气/情绪词], [尺寸], professional design, high contrast, eye-catching

始终在提示词中明确保留 "clean negative space at [position] for text overlay"——nano-banana-pro 渲染文字不完美，因此计划在设计工具中叠加最终文案，而不是信任生成的文字用于超过 2–3 个词的内容。

5. 生成

如果设置了 FAL_API_KEY（或 FAL_KEY），运行仓库 CLI（底层为 docs/fal_api.py，模型 fal-ai/nano-banana-pro）：

python docs/creative_cli.py social \
  --platform instagram --topic "Product Launch" \
  --prompt "<full prompt>" --aspect-ratio 1:1 --resolution 2K

--platform 接受 instagram|linkedin|twitter|tiktok|pinterest。当用户在多个方向间选择时，生成 --num-images 2。如果未设置密钥，交付带有可直接运行命令的 spec。

6. 对照质量标准自检，交付 spec + 图片。

必需输出格式

每个素材一个块；多平台组合是主版后跟适配块：

# Social Graphic Spec — [Campaign/Message]

## Asset 1 — [Platform · Format]
- **Dimensions:** 1080×1080 (aspect `1:1`) · **Role:** master | adaptation
- **Message:** [one sentence]

### Copy
- Headline: "..." (≤10 words)
- Body: "..." (≤2 lines, or —)
- CTA: "..."

### Layout
- Focal point: ... · Copy placement: ... · Palette: [colors + source: brand guide / chosen]

### Generation prompt
> [full prompt, all six parts]

`python docs/creative_cli.py social --platform [x] --topic "[x]" --prompt "..." --aspect-ratio [x] --resolution 2K`

### Result
- [generated file path(s), or "pending — FAL_API_KEY not set"]
- Post-gen step: overlay final copy in design tool: [yes/no + what]

## Asset 2 — [Platform · Format]
(same structure; for adaptations, note only what changes from the master)

质量标准（交付前检查）

尺寸与平台表完全匹配；宽高比是受支持的 CLI 值。
标题 ≤10 个词；总文本 ≤3 个元素（标题、正文、CTA）；每个素材一条消息。
文案位置位于预留留白之上，而非焦点之上。
文字-背景对比被明确处理（在布局中说明色带、阴影或模糊）。
存在品牌风格指南时，调色板和语气与之匹配；偏差向用户标记。
提示词包含全部六个公式部分，包括预留文案空间。
多平台组合：按格式适配，绝不拉伸一张图片；轮播卡片共享一个网格。
不编造互动统计数据；此处的 "最佳实践" 指导是启发式的——如被询问则标注。

集成

skills/creative/creative-strategist → 输入：每个 spec 必须遵守的风格指南（调色板、排版、情绪）。
skills/creative/original-design → 输入：当用户想要原创视觉世界时的设计语言简报；每个图形都成为其产物。
skills/creative/product-photography → 输入：作为焦点图像复用的产品图。
skills/creative/product-video → 输入：作为帖子视觉复用的主关键帧；消费：无。
skills/creative/brand-asset → 输入：要放置的 Logo/标识；消费：无。
skills/creative/orchestrator → 将多素材活动按平台路由到此技能。