画图 Skill

把文章、研究与灵感，变成有人文气息的小红书图文。

画图 Skill 是一个面向 Codex / Agent 的小红书视觉叙事 Skill。它不把内容机械塞进固定模板，而是先理解论点、关系与情绪，再决定每一页的角色、图像、留白和阅读节奏，最后输出可编辑的 JSON、HTML 预览、1080×1350 PNG 与 QA 报告。

Constraints keep the page safe. Interpretation makes it meaningful.

画图 Skill 示例

它解决什么

将长文章、研究笔记或已有草稿改写成 6–10 页轮播叙事
用可检查的 designManifest 记录视觉命题、隐喻、节奏与构图意图
支持 editorial、mixed、image-led、photo-diary、object-study、poetic-poster 六种视觉模式
知识型内容默认走 image-led / mixed 图文交替路径，并可复用 6 种 diagram SVG 模板表达流程、步骤、层级、时间、象限与对比关系
支持本地 PNG、JPEG、WebP、SVG，并赋予 hero、evidence、atmosphere 等语义角色
检查溢出、低对比度、重复构图、弱图像节奏与近期设计相似度
生成本地 HTML 预览和逐页 PNG，但把最终审美判断与发布权留给人

设计原则

先写每页的叙事任务，再开始排版。
图像必须承担意义，而不是给文字加一层装饰。
规则是护栏，不是模板；内容变化应该带来构图变化。
自动检查只能证明页面没有坏，不能证明它好看。
不复制其他创作者的文字、水印、头像或标志性身份元素。

安装

git clone https://github.com/ythx-101/huatu-skill.git ~/.codex/skills/huatu-skill

也可以克隆到其他支持 SKILL.md 的 Agent skills 目录。

在 Codex 中使用

直接说：

使用 $huatu-skill，把这篇文章做成 8 页小红书图文。
先提出三种真正不同的视觉方向，选择后再渲染；加入有语义作用的图像，最后检查每一页和整组节奏。

Skill 会引导 Agent 完成：内容契约 → 分页叙事 → 视觉解释 → JSON spec → 本地渲染 → 自动检查 → 人工视觉 QA。

本地渲染

先检查结构：

python3 scripts/render_carousel.py examples/mixed-carousel.json \
  --output-dir rendered --check-only

再生成 HTML 和 PNG：

python3 scripts/render_carousel.py examples/mixed-carousel.json \
  --output-dir rendered --no-history

输出包括：

carousel.html：可编辑的本地预览
slide-01.png 等：1080×1350 图片
qa.json：尺寸、溢出与诊断结果
design-manifest.json：可检查的设计意图

渲染 PNG 需要本地 Chromium 或 Playwright；仅做 JSON 结构检查不需要浏览器。

SKILL.md                      Skill 工作流
agents/openai.yaml            Codex 展示信息
assets/                       HTML 模板与起始 spec
references/                   叙事、构图、图像与 QA 规范
scripts/render_carousel.py    校验与渲染器
scripts/compare_directions.py 候选方向差异检查
tests/                        单元测试
examples/                     可复现示例

测试

python3 -m unittest discover -s tests -v

隐私与版权

图片只接受本地文件路径，远程 URL 会被拒绝。
Skill 不登录、上传或自动发布小红书；发布是独立的人工动作。
请只使用原创、已授权或公有领域素材，并自行核对事实与来源。

huatu-skill