social-theme-design-spec-generator

name	social-theme-design-spec-generator
description	根据已确认的 Social 图文主题配置生成或更新主题级 AI_DESIGN_SPEC.md，沉淀可复用的视觉方向、组件视觉绑定和装饰配方；不生成具体事件或工具图文内容。

Social 主题设计规范生成

根据主题 JSON 和已确认的视觉方向，生成一份供图文 Agent 读取的 AI_DESIGN_SPEC.md。这份文件只描述主题如何表达视觉语言，不承载具体候选的事实、报道或故事板内容，也不定义页面模板、全局版式或程序渲染结构。

输入

至少需要：

• 主题 id、label、version；
• tokens.colors、字体家族和 tokens.shape；
• social.recipes、social.effects 和 social.components；
• 主题可使用的组件语义和视觉效果（若有）。

输出

只输出完整 Markdown 文档，不要把整份文档包在代码围栏中，也不要把候选内容输出成独立 JSON/HTML。文档必须包含：

1. 主题定位：适用内容、视觉气质和视觉重心；
2. 颜色、字体家族、圆角、阴影等主题 Token；
3. 主题前缀和组件视觉接入方式；不重复定义完整 HTML 骨架或全局布局；
4. 主题视觉在通用组件中的适用建议；页面角色、内容层组合和页面编排由视觉契约与生成技能定义；
5. 装饰的视觉意图和实现边界：根据 social.recipes.decoration 和 social.effects 说明如何形成可感知的装饰层，但不固定页面坐标、尺寸或伪元素写法；
6. 语义组件配方：说明数字焦点、流程/步骤、并列信息、风险/证据、代码/命令和结论/收束组件在本主题下适合采用的视觉处理；这些配方供 Agent 自由组合，不是页面模板。

规则

• 所有颜色、字体家族、形状、类名和主题 ID 必须来自输入，不能臆造与主题冲突的 Token。
• 同时给出实际颜色值和运行时变量映射：var(--bg)、var(--page)、var(--surface)、var(--ink)、var(--muted)、var(--accent)、var(--accent2)、var(--line)、var(--inverse)、var(--code)。
• 主题专属类名必须使用输入主题对应的前缀；不要把某一主题的 ic-* 类名复制给其他主题。
• 设计规范可以说明视觉意图和局部实现边界，但不得包含候选事实、来源 URL、内部 ID、事件数字或仓库信息。
• 主题 SPEC 只负责主题视觉：候选运行时读取 social-theme-design-spec.md 获取颜色、字体家族、组件视觉处理和装饰方向；通用结构、布局、字号、视觉振幅、内容占用和事实语义分别由 AI 视觉技能内置的视觉契约、Layout Guide 和组件映射参考负责，不要把这些内容复制进 SPEC。
• 主题组件必须能在通用版式约束下使用；主题规范不另设布局或排版数值。
• 规范应允许 AI 自由组合组件，不要把每一页固定成同一种卡片；只需说明哪些视觉处理适合当前主题，以及哪些事实适合使用这些处理。
• 主题应说明如何用自己的 accent / accent2 / surface / inverse 形成层级对比，并支持数字焦点、证据边界和结论收束；这里只定义视觉映射，不规定页面必须出现何种角色或组件。
• 主题应至少提供一种高对比、强识别的视觉处理方式，例如主题化边框、色块、投影、渐变或装饰；具体使用页数、组件数量、布局值和组件结构由 AI 视觉技能决定。投影写法按主题阴影类型适配：hard 用硬投影、soft 用柔和投影、glow 用霓虹光晕、none 用边框或色块分层。
• 语义组件配方只规定“什么事实适合什么视觉处理”，不规定每页的固定 HTML、组件数量或内容占用；不得要求 Agent 虚构事实来满足视觉效果。
• 装饰应在原尺寸下可感知，但具体页面可以选择背景层、伪元素或主题组件承载装饰；不得强制所有页面复用相同的坐标、尺寸或装饰构图。
• 更新已有 SPEC 时保留稳定章节和主题事实，只修正与当前主题配置不一致的内容。

参考资料

• 组件和文档结构参考 references/spec-template.md。
• 若任务要求贴近小红书图文规范，再读取 xiaohongshu-article-generator 的 DESIGN_SYSTEM.md 和 LAYOUT_GUIDE.md，只吸收布局与组件规则，不复制其具体候选内容。