Gracker Diagrams

Gracker Diagrams

默认目标：低压感、高解释力、强结构化，视觉克制但信息扎实。采用“先结构化内容，再生成视觉 prompt，最后按需渲染”的流程，把风格固定成 Gracker 偏好的技术手绘风。

强制执行原则

不要把原文直接丢给图片生成/绘图工具，也不要临场手写最终 prompt。必须先按流程产出中间文件：

1. source.md：保存原始输入或原文摘录
2. analysis.md：分析信息结构和取舍依据
3. structured-content.md：由 Skill 决定哪些内容进入视觉成品
4. copy.md：对所有可见标题、模块名、标签、脚注做图前文案把关
5. prompts/infographic.md：基于对应 prompt template 生成最终视觉 prompt

只有完成以上文件后，才能进入交付或可选渲染。内容很长时先按章节拆页；单页内再筛选高价值信息。禁止把多章压进一张总览海报，也禁止用临场 prompt 任意压缩。

分页默认规则

除非用户明确说「只要一张图 / 单页 / 压成一张」，信息图默认按内容章节分页，一章一图，把该章讲细。不要等用户每次再说一遍。

适用

• 风格 B 马卡龙、风格 C Gracker 信息图
• 视频、文章、调研、课程、长笔记等「把一份材料画出来」的任务
• 风格 D 小红书：用户说「双图」才固定 2 张；否则同样按章节出卡，每张独立可读

不要硬套

• 用户只要一张架构图、一张 Mermaid 转图、或一个单独概念
• 风格 A 白板架构图默认仍是一张；只有系统大到一张看不清主路径时，才按子系统/分层拆页

怎么切

1. 优先用原文官方章节、时间轴、小标题
2. 没有官方章节时，按主题转折切，不要发明额外章
3. 过薄的钩子/片头可并入下一章；不要为了凑页数再切一刀
4. analysis.md 必须写清：切了几张、每张对应哪一章、为什么合并
5. copy.md 按 Card 01 … Card NN 列出每页可见文字
6. prompt 写成 prompts/infographic-01.md … infographic-NN.md；成图 *-01.png … *-NN.png

禁止

• 为了省时间把多章压成一张
• 用「内容太多所以先摘要」代替分页
• 多图画完只交付第一张

图前文案把关

生成 prompt 之前，必须先把 structured-content.md 转成 copy.md。copy.md 是最终图上可见文字的准入层，不能把分析语、编辑语或 AI 味句子直接送进图片生成。

文案把关只抽取 gracker-writing 的核心原则，不依赖 gracker-writing skill：

• 准确：所有标题、数字、术语和判断都要能回到 source.md、analysis.md 或引用材料；不补不存在的数据和结论。
• 有用：每个标题、模块名、列表项都要自带信息增量。只剩名词或口号仍能成立的文案不合格。
• 易读：短标题负责概括本页任务，正文标签负责交代证据、条件和边界；不要用长句当标题。
• 标题自己会说话：主标题要说明本页在解决什么问题，例如 已确认的泄露范围、还没坐实的爆点；避免 发生了什么、为什么重要、别把推测当结论 这类泛标题。
• 判断必须带边界：涉及传闻、媒体报道、样本核验、推断、风险时，必须在同屏写清口径。
• 默认写成内容陈述：图面用于说明原始材料里的事实、结构、机制、证据、边界和影响；除非用户明确要求写作建议、传播建议或发布建议，否则不要把任何一页写成“如何表达 / 不要怎么写 / 推荐表述”的建议清单。
• 去掉编辑过程感：不出现 这一版、按要求、这里要讲、下面来看、先别急着、真正的、值得注意、核心在于 等元叙述或填充词。
• 避免反差口号：不使用 不是 X，而是 Y、并不是 X，而是 Y、不只是 X，还 Y 作为标题或底部总结。
• 列表不是目录：每个列表项用 对象 + 判断/口径/影响 的结构，例如 黑客声称 630GB：媒体只做样本核验，不要只写 泄露规模。
• 图文优先：同一意思不要在系列名、主标题、副标题、模块标题里重复；标题层级负责分工，不负责反复喊同一句话。

copy.md 建议包含：

系列名（可选，XHS 默认不显示）:
Card 01:
- 页码:
- 主标题:
- 副标题（可选，XHS 默认不显示）:
- 模块:
- 标签:
- 脚注:
Card 02:
- 页码:
- 主标题:
- 副标题（可选，XHS 默认不显示）:
- 模块:
- 标签:
- 脚注:
文案自检:
- 是否有重复标题:
- 是否有泛标题:
- 是否有无依据判断:
- 是否有 AI 味/编辑语:

渲染硬约束

如果用户要求“画图 / 出图 / 渲染 / 生成 PNG / Mermaid 转图”，最终成品必须调用 image_generate，使用当前 Hermes 图像配置的 GPT Image 2（image_gen.provider: fal, image_gen.model: fal-ai/gpt-image-2）。prompts/infographic.md 只是中间产物，不是最终交付图。

禁止用本地 HTML、SVG、Mermaid 截图、浏览器截图、ASCII 或低质本地生成代替最终图片。缺少 GPT Image 2 后端凭证时，明确报告缺失配置，不要降级糊弄。

风格路由

根据用户意图选择风格：

判断不了的默认走白板架构图。

风格 A：白板架构图（默认）

先读：

• references/style-guide.md
• references/prompt-template.md
• references/quality-checklist.md

输出流程

1. 建立本次工作目录

手动创建：

<root>/<slug>/
├── source.md
├── analysis.md
├── structured-content.md
├── copy.md
├── prompts/
│   ├── infographic-01.md   # 多章则 01..NN；用户只要一张图时可用 infographic.md
│   └── infographic-02.md
└── output/
    └── diagram-01.png  # 可选：只有实际渲染后才需要；多章编号

如果用户已经给了固定目录，直接用用户目录，不额外新建层级。

2. 保存原始内容

把原始输入按原样写到 source.md。

来源可以是：

• Mermaid
• Markdown 正文
• 文章段落
• 已有图片的结构描述
• 手工列出的模块/关系/步骤

规则：

• 不补新信息
• 不改事实
• 只做结构整理

3. 分析信息结构

在 analysis.md 里只回答 5 件事：

1. 图的目标（一句话）
2. 内容形状（顺序 / 中心-辐射 / 分层 / 拆解 / 对比）
3. 主元素 3-7 个
4. 次级标注有哪些
5. 哪些地方适合加 Perfetto-style tracks（如果有时间、阶段、等待、并行）

4. 生成结构化内容

把图整理成视觉可消费的模块，写到 structured-content.md。

格式尽量稳定：

• 标题
• 一句话摘要
• 主模块列表
• 连接关系
• 辅助标注
• 图例/说明
• 文案标签清单

5. 文案把关

根据 structured-content.md 生成 copy.md，只保留能进入图上的可见文字。所有标题、模块名、标签、脚注都要经过“准确 / 有用 / 易读 / 有边界”检查。

6. 选布局

根据内容形状选择：

• 顺序流程 → linear-progression
• 中心系统 + 周边依赖 → hub-spoke
• 系统组件拆解 → structural-breakdown
• 分层机制 → hierarchical-layers
• 高密度总览 → dense-modules

除非用户指定，否则优先 可解释性，不是视觉花活。

7. 生成 prompt

基于 references/prompt-template.md 生成 prompts/infographic.md。

风格硬约束：

• 白底或浅米色纸张底
• 粗黑描边
• 圆角模块
• 低饱和浅色边框分区
• 简化黑白图标
• 正交箭头
• 留白充足
• 手绘/白板精修感
• 如果有时间、阶段、并发，加入 Perfetto-style 横向 tracks 或 timeline bars

8. 交付或可选渲染

默认交付 source.md、analysis.md、structured-content.md、copy.md 和 prompts/infographic.md。如果用户要求成图，且当前运行环境提供图片生成、绘图、浏览器渲染或设计工具，可以使用可用工具渲染；不得在 Skill 中固定模型、供应商或工具名。

建议输出约束：

• aspectRatio: 16:9（默认，横屏）
• filename: <slug>.png

9. 验收

用视觉工具检查结果是否满足：

• 一眼能看懂主路径
• 不是 corporate PPT 风
• 不是写实海报风
• 不是卡通卖萌风
• 线条粗、结构清、颜色轻
• 如果有时序/阶段，Perfetto-style tracks 真的出现了

不满足就改 prompt，再重试 1 次。不要无止境重抽。

Mermaid 转图片的额外规则

如果原始输入是 Mermaid：

• 保留 Mermaid 源码
• 如有可用渲染能力，同时生成一张展示版图片；否则交付展示版 prompt
• 如果需要精确版，再补一张 SVG 或 Mermaid 原生渲染版
• 文档里推荐顺序：展示版 → 精确版 → Mermaid 源码

风格 B：马卡龙信息图

先读：

• references/macaron-style-guide.md
• references/macaron-prompt-template.md

输出流程

与风格 A 共享步骤 1-5（建目录 → 保存原始内容 → 分析信息结构 → 生成结构化内容 → 文案把关），但后续步骤有差异：

6. 选布局（马卡龙适配）

马卡龙信息图的布局选择逻辑：

• 默认按章节拆页，一章一图；用户明确只要一张图时才做单页
• 竖屏优先（1024x1536 或 768x1024）
• 顺序流程 / 逐步展开 → 纵向箭头串联
• 对比 / 优缺点 → 左右分栏卡片
• 组成 / 要素 → 并列马卡龙卡片
• 层级 / 质检体系 → 嵌套或阶梯式
• 循环 / 迭代 → 环形
• 多模块总览 → 卡片矩阵 + 连接线

7. 生成 prompt

基于 references/macaron-prompt-template.md 生成。

核心风格硬约束（已在模板中，不需重复）：

• 暖奶油纸底 #F5F0E8
• 马卡龙色圆角卡片，不完全填满轮廓
• 手绘波浪箭头
• 简笔画卡通 + 涂鸦装饰
• 粗体大号手绘字标题居中
• 底部总结可选；如果使用，必须是正向短句，禁用“不是 X，而是 Y”式反差句

8. 交付或可选渲染

默认交付 prompt pack。若用户要求成图，且当前运行环境提供图片生成或设计工具，可以使用可用工具渲染；不得在 Skill 中固定模型、供应商或工具名。

建议输出约束：

• size: 1024x1536
• filename: <slug>-macaron.png

9. 验收

• 一眼能看懂信息结构
• 马卡龙色块出现且不完全填满轮廓
• 有手绘抖动感
• 有涂鸦装饰（星星、下划线、小箭头）
• 如有底部总结，必须是正向短句，且未使用“不是 X，而是 Y”式反差句
• 竖屏比例
• 不是白板架构图风格

不满足就改 prompt，重试 1 次。

风格 C：Gracker 信息图

先读：

• references/gracker-style-guide.md
• references/gracker-prompt-template.md

输出流程

与风格 A 共享步骤 1-5（建目录 → 保存原始内容 → 分析信息结构 → 生成结构化内容 → 文案把关），但后续步骤有差异：

6. 选布局（Gracker 适配）

• 竖屏优先（1024x1536）
• 默认按章节拆页，一章一图；只有用户明确只要一张图时才做单页长图
• 高密度纵向布局，模块间手绘线条连接递进
• 背景色自然区分，不要卡片框
• 单页内内容多时用编号区块组织，不要靠再压一章进来换密度

7. 生成 prompt

基于 references/gracker-prompt-template.md 生成。

核心风格硬约束（已在模板中，不需重复）：

• 暖奶油纸底 #F5F0E8
• 不要卡片框，背景色自然过渡
• 文字密度优先，图标克制
• 手绘线条和波浪箭头连接
• 底部总结可选；如果使用，必须是正向短句，禁用“不是 X，而是 Y”式反差句

8. 交付或可选渲染

默认交付 prompt pack。若用户要求成图，且当前运行环境提供图片生成或设计工具，可以使用可用工具渲染；不得在 Skill 中固定模型、供应商或工具名。

建议输出约束：

• size: 1024x1536
• filename: <slug>-gracker-01.png … <slug>-gracker-NN.png；用户只要一张图时才用 <slug>-gracker.png

9. 验收

• 一眼能看懂信息结构
• 没有卡片框、气泡框、虚线框
• 背景色自然过渡区分模块
• 文字密度高，技术细节保留完整
• 有手绘线条和波浪箭头连接
• 图标少，文字为主
• 如有底部总结，必须是正向短句，且未使用“不是 X，而是 Y”式反差句
• 竖屏比例

不满足就改 prompt，重试 1 次。

风格 D：Gracker 小红书风格

先读：

• references/xiaohongshu-style-guide.md
• references/xiaohongshu-prompt-template.md

输出流程

与风格 A 共享步骤 1-5（建目录 → 保存原始内容 → 分析信息结构 → 生成结构化内容 → 文案把关），但后续步骤有差异：

6. 选布局（小红书适配）

• 用户说「双图」时拆成两张连续图片：01/02 和 02/02
• 用户没说双图时，按内容章节出卡：01/NN … NN/NN，不要先压成 2 张
• 单张优先社交网络竖图（建议 1080x1440；内容确实密时可在 1080x1440 到 1200x1600 之间轻微放宽），整体仍接近 3:4，禁止再做超长图
• 两张图标题必须有明确逻辑：编号、上下篇、好消息/市场担忧、结论/验证点等
• 标题体系固定为“统一页码角标 + 每张不同主标题”；默认只显示一个主标题，不显示小系列名和副标题
• 页码角标必须在两张图中使用同一位置、颜色、形状、字号和手绘风格，只允许页码文字从 01/02 变为 02/02
• 两张图主标题必须各自承担不同信息功能，避免重复喊同一句标题；主标题字号、字重和留白节奏必须一致
• 来源、口径或限制说明需要出现时，放到正文小标注、脚注或来源行里，不作为第二标题或副标题
• 信息不缩水：把同一主题的完整内容分配到两张图，而不是删掉细节
• 每张图都要独立可读：保留主题标题、页码、关键来源或限制说明
• 默认密度要接近 Gracker 长图：每张通常 6-8 个信息区，每个信息区 2-4 条短句或标签；优先压缩图标、装饰、标题留白和边距，不要用大留白换取“干净”
• 密度守恒：小红书适配只能改变排版、字号、分栏和文案压缩方式，不能把 copy.md 里的模块删成低密度摘要。每张图至少保留本页模块的 80% 可见信息，关键事实、原因链、边界、来源口径和行动点不能因为“手机可读”被删掉。
• 如果画面放不下，处理顺序是：缩短句子 → 增加分栏/编号/侧栏 → 减少图标和装饰 → 放宽到 1200x1600 或 1024x1536；禁止先减少到 3-4 个大块。
• 小红书风格的“可读”不是低密度，而是字号、行距、分组和层级更适合手机

7. 生成 prompt

基于 references/xiaohongshu-prompt-template.md 生成。

必须在 prompts/infographic.md 中写完整双图 prompt pack；需要更细时可额外写：

• prompts/xiaohongshu-01.md
• prompts/xiaohongshu-02.md

核心风格硬约束（已在模板中，不需重复）：

• 继承 Gracker 信息图：暖奶油纸底、自然色块、无卡片框、少图标、文字优先
• 两张图是一组轮播，而不是把长图机械裁成两半
• 单张文字密度仍然高，但正文必须比长图更大、更易读；可读性靠分组、字号层级、短标签和分栏实现，不靠删掉信息实现
• 每张图承载完整结构的一半左右，保留口径、证据、判断和边界，避免用户在小红书上手动放大
• prompt 必须使用 copy.md 里的最终可见文案，不要把 analysis.md 中的分析句直接搬进图上

8. 交付或可选渲染

默认交付 prompt pack。若用户要求成图，必须渲染两张最终图片；不要只交付第一张。

建议输出约束：

• size: 1080x1440；信息密度较高时可放宽到接近 3:4 的 1200x1600
• filenames: <slug>-xhs-01.png, <slug>-xhs-02.png

9. 验收

• 两张图同一视觉系统，标题逻辑清楚，页码清楚
• 页码只出现一次，作为角标或页眉标记；主标题里不得重复页码
• 页码角标同款同位；不能一张用红色椭圆、另一张用紫色色块
• 两张图主标题不重复，应该形成“事实 / 原因”“证据口径 / 风险边界”“利好 / 市场追问”等承接关系
• 两张图默认只显示一个主标题；不能出现“小系列名 + 主标题 + 副标题”的重标题堆叠
• 两张图主标题字号、字重、位置和顶部留白一致
• 单张图不是长图，移动端无需放大即可阅读主要文字，但不能为了显得清爽牺牲关键事实
• 信息密度足够：每张通常 6-8 个信息区，关键数字、来源口径、因果链、限制条件都在图上
• 信息密度守恒：每张至少保留本页模块的 80% 可见信息；不能只留下标题、图标和 3-4 条口号式摘要
• 文案通过 copy.md 自检：没有泛标题、重复标题、编辑语、无依据判断、反差口号和 AI 味填充句
• 两张合起来覆盖原始结构和关键细节，没有为了排版删掉核心内容
• 没有卡片框、气泡框、虚线框
• 背景色自然过渡区分模块
• 图标少，文字为主
• 如有底部总结，必须是正向短句，且未使用“不是 X，而是 Y”式反差句
• 需要重试时最多重试 1 次，并明确改动目标

以下情况不要硬套：

• 数据图表、折线图、柱状图，用 vega / data visualization 工具
• UML、ER 这类严格工程图，优先 mermaid / graphviz
• 只想要快速可维护，不关心视觉，直接 mermaid

输出总结格式

最终汇报只说：

• 图名
• 选用布局
• prompt pack 路径
• 成图路径（如已渲染）
• 是否保留 Mermaid/SVG
• 是否通过一轮视觉验收（如已渲染）