/handdrawn-article-illustrator

name: handdrawn-article-illustrator
description: 为微信公众号文章、长文、博客或 Newsletter 生成一组统一视觉系统的手绘风格配图（公众号首图、正文横图、方形卡片）。先理解文章结构与段落核心观点，再为每张图写 Image Brief 和英文视觉 prompt，最终由内置图片生成能力出图；同一篇文章只用一种重点色，配色通过主题包（themes/）配置，可切换或自定义。适用于“手绘配图”“文章配图”“公众号配图”“给文章配图”等需求。
version: "1.1.0"
license: MIT
author: 杨卫薪律师（微信ywxlaw）
homepage: https://github.com/cat-xierluo/legal-skills

手绘文章配图

为微信公众号文章、博客和 Newsletter 生成一组同一视觉系统的手绘风格配图。核心不是绑定某个品牌，而是稳定产出：大留白、对象卡片、单一固定重点色（由主题包配置）、受控粗黑手绘墨线、低信息密度和清晰隐喻。配图首先服务于理解文章，其次才是风格探索；不要为了新奇牺牲可读性。

核心流程

1. 读取文章材料。

• 如果用户给的是微信公众号链接，先获取正文内容，再进入配图规划。
• 如果用户给的是 Markdown 或粘贴文本，直接分析标题、二级标题、转折段、案例段和结论段。

2. 生成配图计划。

• 默认生成：1 张公众号首图 + 高密度正文横图。
• 短文可以降到 6-8 张正文横图；中长文默认 12-16 张正文横图；长文、案例复盘或产品复盘默认 18-24 张正文横图。
• 公众号长文优先按“每个二级标题或重要三级标题 2-3 张图”规划，而不是每章只放 1 张分隔图；大致每 250-450 个中文字符安排 1 张。
• 长文按每个二级标题、三级标题、关键转折段、功能清单段、案例段、金句段和结论段布图。
• 每张图只承载一个概念，不把整段文章做成信息图。

3. 选择图像类型。

• **首图**：手绘对象卡片架构，中心为一个方形物件插画，四周留白，适配公众号首图裁切。
• **正文横图**：16:9 横向插画，用一个隐喻解释当前段落。
• **方形卡片**：1:1，用于朋友圈、文章列表或单概念卡片。

4. 生成提示词或批量出图。

• 默认正式路线是 ImageGen/Codex/ChatGPT 内置生图：Agent 先写 `Image Brief` 和最终英文视觉 prompt，再调用宿主环境提供的内置图片生成能力产出 PNG。
• 批量时使用 `--mode codex` 生成内置生图队列；队列不是终稿，Agent 需要逐张调用内置生图工具。
• 默认不要运行 `--mode local`，不要生成 `local_preview/`，不要把本地预览纳入默认交付。
• 只有用户明确要求“构图草图”“占位预览”“本地预览检查”时，才可以运行 `--mode local`；输出必须标注为草图，不能算终图。
• 当用户要求“测试效果”“生成效果给我看”“跑几轮看看”时，必须调用 ImageGen/内置图片生成能力生成真实样图；本地预览不算成片测试。
• 不要为了“提升默认效果”主动调用外部图片 API；只有用户明确要求模型对照、API 实测或候选探索时，才走 `guided-edit`、`t2i` 或 `edit`。
• 只需要提示词时，输出中文配图计划 + 英文图片 prompt。

5. 压缩交付图片。

• ImageGen 生成后的 PNG 通常偏大。默认使用 `scripts/compress_images.py` 原地压缩最终交付图。
• 压缩目标是每张尽量低于 `200KB`，硬上限低于 `500KB`；除非用户明确要求保留原始大图，否则覆盖原图。

6. 做质量复核。

• 检查是否出现可读文字、Logo、写实照片、复杂背景、过多元素或直接复刻任何品牌官网图案。

手绘风格要点

先阅读 `references/builtin_image_generation_workflow.md`，理解构图家族的文字描述。执行时抓住这些要点：

• 背景以暖米白为主（具体色值由当前主题包的 `paper_background` 决定，默认蓝灰主题用 `#FAF9F5` / `#F5F4ED` 这类暖白）。
• 主线条用近黑墨线（具体色值由当前主题包的 `ink_color` 决定，默认 `#141413`），更接近“手工描摹出来的填充墨块路径”。轮廓要先稳定干净，但不能像机械矢量图标；粗细变化来自单遍手绘墨线的起笔、收笔、转角压痕和重叠处笔压，长边有自然收放但不随机抖动。
• 重点色固定从当前主题包读取（`config/style.json` 的 `active_theme` 决定用哪个主题，默认蓝灰主题是 `#435C68`）；同一篇文章只使用这一种重点色。
• 背景支持两种模式：`paper` 是暖米白底 + 重点色局部点缀；`inverted` 是重点色底 + 米白主体 + 近黑墨线。长文成组配图必须混用这两种模式：大多数使用 `paper`，少数关键图使用 `inverted` 做节奏重音。
• `inverted` 不是新配色，而是同一重点色的颜色反转：背景整面使用当前主题的重点色，主体块面使用暖米白，线条仍使用近黑墨线；不要在反转底图里再加入第二种强调色。
• 图片像“对象卡片”，不是复杂场景：一个主物件 + 少量贴近主体的辅助元素；主体必须足够大，不要退化成留白中的小图标。
• 以本技能沉淀的构图家族作为主要风格基准：链路、书页/容器、重点色轨道、云团漏斗、放射网络、活动链块、档案堆叠、嵌套框、流程到网络、文件夹归档、模块拼接。多样性应在这些家族内展开，而不是发明难懂的新怪异物件。
• 物件优先选择关系型抽象隐喻：漏斗、棱镜、迷宫、飞轮、脚手架、广播扩散、指南针地图、样品托盘、天平、窗口、放大镜、节点、门、桥、仪表盘、文件夹和流程轨道。每张图都要能一眼看出它在表达压缩、筛选、分发、判断、路径、沉淀或协作中的哪一种关系。
• 第 4-5 轮测试中的“轻微异样机制感”只作为边界探索记录，不作为默认方向。不要主动追求诡异、神秘、器官感或过度抽象；如果某个意象不能帮助读者理解当前章节，就换回参考图里的清晰构图家族。
• 使用 Codex/ChatGPT 内置生图时，抽象程度要受控：可以使用 `object-card mechanism`、`hand-drawn workflow object`、`blank slabs`、`rounded capsules`、`thick connector band`、`archive tray`、`nested frame`、`funnel output` 等词；谨慎使用 `nameless abstract mechanism`、`soft shell`、`organic plume` 这类更容易跑偏的词；少写 `role card`、`document card`、`permission`、`dashboard` 等容易被直译的词。
• 长文同组配图必须控制隐喻重复：不要连续使用“方框 + 圆圈 + 连线”的节点图；优先在压缩、分发、筛选、判断、路径、沉淀、协作等关系之间轮换，并按构图家族轮换。
• 长文同组配图还必须控制版式重复：不要让多张图都变成“左侧输入 - 中间收束/闸门/滤波 - 右侧输出”的横向机制图。这个版式最多作为少量压缩、筛选、转化章节使用，不是默认安全构图。
• 不使用可读文字；如果需要表现“文档/合同/条款”，只画短线和块面，不画真实字。
• 不使用 checkmark、人像、星标、铅笔、工具、app 符号、箭头等熟悉 UI 图标；角色、权限、节点关系要用空白卡片、圆点、短线和抽象块表达。
• 不使用植物枝叶、花草、装饰性散点和边角装饰；模型容易把“自然手绘”误解成插画装饰，必须主动排除。
• 不使用脸、眼睛、嘴、身体部位、恐怖符号、宗教神秘符号、超现实物件或难以解释的陌生器械；不要把“抽象”做成读者看不懂的谜题。
• 不把文章标题、章节标题、关键词原样放进图片 prompt；先改写成 visual-only 概念，避免模型把英文标题、产品名、技术词画进图里。
• 不复制任何品牌官网现成 SVG、Logo、字标或具体图案，只提取通用的结构语言。
• 本 Skill 是后续文章配图的唯一主入口。不要再为相近风格新建并列 Skill；如需调风格，优先切换或新建主题（`themes/`）、调 `abstraction_strength` 或改 `references/`，不要在 SKILL.md 或脚本里硬编码色值。

主题包（Theme Pack）

本 Skill 的配色（重点色、纸面色、墨线色）不再硬编码，而是由**主题文件**提供。一个主题文件 = 一组配色。这样不同律所、团队或作者可以复用同一套构图与流程，只替换色彩。

内置主题包在 `themes/` 目录：

| 主题包 | 重点色 | 适用 | |--------|--------|------| | `blue-gray`（默认） | `#435C68` 蓝灰 | 法律、公众号长文、编辑类 | | `ink-black` | `#2A2A28` 墨黑 | 极简、无品牌色需求；复用 blue-gray 参考图 | | `terracotta` | `#A65A3D` 赭石 | 人文、文化、生活方式；复用 blue-gray 参考图 |

`blue-gray` 是默认激活主题。完整说明见 `themes/README.md`。

切换主题

三选一，优先级从高到低：

1. **命令行参数**（单次出图）：`generate_prompts.py --theme ink-black` 或 `batch_article_images.py --theme ink-black`。 2. **大纲级覆盖**（整篇文章生效）：在 outline JSON 里写 `"style": { "theme": "terracotta" }`。 3. **改默认激活主题**（长期生效）：编辑 `config/style.json`，把 `active_theme` 改成主题包名。

切换后，`generate_prompts.py` 会从 `themes/<name>.json` 读取配色注入 prompt，无需改其他文件。

创建自己的律所主题包

适合律所、品牌号或个人作者注入自己的主题色。核心步骤：

1. 新建 `themes/my-firm.json` 文件。 2. 定义 `colors`（`accent_color` 重点色、`paper_background` 纸面色、`ink_color` 墨线色）。 3. 用 `--theme my-firm` 或改 `active_theme` 激活。

详细模板见 `themes/README.md`。**关键约束**：一篇文章只用一种重点色；纸面色保持低饱和暖白。

色值微调（不改主题包）

如果只想临时改一个色值、不想新建主题包，在 `config/style.json` 的 `overrides` 里写：

{ "active_theme": "blue-gray", "overrides": { "accent_color": "#3A4F5C" } }

`overrides` 优先级高于主题包，低于命令行 `--theme` 和 outline `style.accent_color`。

抽象强度

本 Skill 内置三档抽象强度，写在 `config/style.json` 的 `abstraction_strength`，也可以在 outline 的 `style.abstraction_strength` 或单张 `illustrations[].abstraction_strength` 覆盖：

| 档位 | 使用场景 | 风格边界 | |------|----------|----------| | `reference_card` | 想更接近前序参考图、优先服务理解、避免跑偏 | 优先 `folder archive`、`cloud funnel output`、`nested frame`、`workflow book`、`chain active block` 等可解释构图；少用无名机制、软壳、雾状扩散 | | `balanced` | 默认档，适合大多数公众号文章 | 在参考图家族内适度抽象，避免直译成文档卡片、UI 面板、权限图标或 dashboard，但保留一句话能讲清的隐喻 | | `high_abstract` | 想使用最近测试里抽象程度更高的机制感 | 可用 `nameless abstract mechanism`、`soft slabs`、`rounded shells`、`slots`、`hinges`、`vessels`、`organic plumes`、`endpoint capsules`，但必须有清晰 `reader_takeaway_zh` |

默认使用 `balanced`。长文成组配图可以混用：关键章节或结论图用 `reference_card` 保持清晰，少数更概念化的章节用 `high_abstract` 提升风格变化。不要连续多张使用 `high_abstract`，除非用户明确要更实验化的视觉方向。

比例与尺寸

沿用本技能从前序配图流程沉淀下来的比例策略：

| 用途 | 默认生成比例 | 默认生成尺寸 | 交付建议 | |------|--------------|--------------|----------| | 公众号首图 | 宽画幅生成后导出 | 内置生图宽画幅；API 实验可用 `2048x872` | 导出 `2400x1024`，主物件放中心安全区 | | 正文横图 | 宽画幅