max-xhs-design-skill

name	max-xhs-design-skill
description	中文社交图文排版 skill（小红书/ins）。做「八卦图文/AI 快讯」时用内置 Zine 小报生成器出整期图组；其他长图文走固定框架 + 排版品味规则手排；给参考图或要现成版式时用模板库 + 量化复刻；也可用于审查现有图文版式。用户要做图文、长图、轮播、封面、照参考图做同款，或让你点评版式时使用。
compatibility	macOS（依赖 /Applications 下的 Google Chrome 做无头渲染与 sips 读图），Python 3（量化闭环需 Pillow）；字体已随仓库自带则无需联网，若 fonts/ 下没有字体文件先运行 bash fonts/download.sh 联网补齐
metadata	{"author":"Maximax","version":"1.1.0"}

max-xhs-design-skill：中文社交图文排版

一个 skill，四条车道。先路由，再动手；任何一条车道交付前都必须跑 references/taste.md 第 7 节的出厂检查表，逐项打钩，不许凭记忆默认自己合规。

首次使用：若 fonts/ 下没有 ttf/otf 字体文件（SkillHub 等平台不允许上传二进制字体），先运行 bash fonts/download.sh 从 GitHub 补齐全部开源字体。完整仓库：https://github.com/MaxGzLi/max-xhs-design-skill

路由表

用户需求长这样	车道
「八卦图文」「做一期」/ 推文截图 + 本人观点 / 按期发行的快讯吃瓜体	A：Zine 生成器
其他长图文：干货清单、金句卡、教程轮播、盘点、生活记录……	B：通用框架
「看看这张图哪里不对」「帮我审下版式」	C：审查模式
「照这张参考图做一张」/「要 XX 风格的版式」/ 想直接套一套成熟版式	D：模板库 + 量化复刻

拿不准就问用户一句，只问一个问题。路由优先级：专用生成器 > 模板 > 手排——有生成器不用、手排模仿它，是毁品牌一致性的头号错误；有闭环过的模板不用、白手重排，是第二号。

车道 A：八卦图文（Zine 小报生成器）

用户只提供两样东西：截图 + 观点，其余全部由流程和生成器决定。版式是定稿的品牌资产（黄油体/得意黑/文楷、纸色油墨、四种页型），不改字体、不改配色、不加装饰；觉得版式有问题直接告诉用户，不擅自改样式。

快速流程（完整字段文档与所有实测规则见 references/zine.md，动手前先读它）：

1. 收素材：每条新闻的截图（一般自带翻译）+ 用户本人的观点。缺观点就问，不代写立场
2. 建期目录 issue-NNN/，截图进 assets/；裁切用 PIL 顶部锚定 crop((0, 0, w, h))，不用 sips --cropOffset（会静默居中裁）
3. 写 issue.json：四种页型按内容选——对话用 duel、金句用 quote、图强话少用 hero、其余 take；同一期至少 2–3 种页型；评论钩子（hook）与引流条（promo）只出现在尾页
4. 生成：python3 ~/.claude/skills/max-xhs-design-skill/build.py path/to/issue-NNN/issue.json
5. 目检：每张 PNG 用 Read 看一遍——无溢出、无单字孤行、反白高亮没有难看的断行、封面页码对得上、英文数字没用中文字体裸奔（易混字形包 <span class="en">）
6. 过检查表（taste.md 第 7 节）→ 修到全过 → 交付本地 PNG 路径，不发 Artifact

车道 B：通用框架（没有专用生成器的长图文）

第 0 步：读 references/taste.md，之后每一步照它的规则做。

1. 版式判读：输出 taste 0.B 那一行（内容类型 / 素材 / 平台画幅 / 版式家族 / 字体组合 / 三旋钮），歧义只问一个问题
2. 定结构：文字列出分页骨架（几页、每页放什么、视觉主角、收藏点和评论钩在哪页），给用户确认后再动手
3. 手排 HTML：一页一个文件；字体只从 taste 3.A 可商用池选，字体文件在本 skill fonts/ 下（@font-face + file:// 绝对路径）；画幅默认 1080×1440（3:4）或 1080×1800
4. 渲染：python3 ~/.claude/skills/max-xhs-design-skill/render.py page.html 1080 1440 page.png
5. 目检 + 检查表：每张 PNG 用 Read 看；跑 taste 第 7 节检查表，逐项打钩贴给用户
6. 交付：本地 PNG 路径 + 每页一句说明，不发 Artifact

排完若用户会复用这个版式，主动提议固化成新的生成器（issue.json 式输入 + build.py 式确定性渲染），并在路由表登记。

车道 C：审查模式

读 references/taste.md，把用户给的图逐条对照第 3–6 节规则和第 7 节检查表，按「问题 → 违反哪条 → 怎么改」输出。无渲染依赖，任何平台可用。

车道 D：模板库 + 量化复刻

第 0 步：读 references/replicate.md（判命路由 + 六步 SOP + 教训清单）；templates/README.md 是 7 套模板的规格摘要与预览。

D1 套模板（用户要现成版式，或参考图与某套模板同命）：

1. 按 templates/README.md 选声部，复制模板 HTML 到工作目录，把 @font-face 的 ../fonts/ 改成本 skill fonts/ 的绝对 file:// 路径
2. 换内容不换关系：只改文字节点；文字长度变了调字号/字距，不挪块；换字体等于换内容
3. 渲染（一次一张，timeout 给足）→ 目检 → python3 measure.py 成图.png 对照该模板规格（覆盖率/边距 ±5%）→ taste 第 7 节检查表

D2 全量复刻（用户给了新参考图）：

1. 先判命：命在几何+字体 → 走六步 SOP；命在手工笔墨/插画/摄影/实物材质 → 明确说做不到八成以上，给转译方案（从模板库挑可达声部），不硬做七成品
2. 按 replicate.md 六步：全尺寸精读 → 量化（有变形/投影文字必须量笔画轴向）→ 写规格（命 + 数字 + 负清单）→ 照建 → 闭环 diff ±5% → 换内容不换关系
3. 收敛且可复用的新版式写进 templates/ 并在其 README 登记规格

边界

不做网页 / 落地页 / PPT / 视频封面。观点类内容缺用户立场时必须问，不代写。池外字体一律先查商用授权。真实素材不足不准造假截图。复刻判命够不到的参考（书法/插画/摄影/材质命）直接说明天花板，不交七成品。