Punk XHS Cards 是一个面向多平台内容创作者的技能，用于把发布在 𝕏、微信公众号等平台的长文，转换成适合小红书阅读和发布的竖版知识卡片。它尽量保留原文核心内容与关键图片，同时融入个人 IP 和专属视觉风格。
用途
该技能的核心用途是内容复用：将 Markdown 长文重新排版为小红书竖版知识卡片，并生成配套的发布文案。它强调保留理解文章不可缺少的关键图，包括截图、图表和流程图。
主要能力
- 个人 IP 建立：从用户上传的真人照片生成个人 IP 形象，或登记用户已有的 IP 图，提炼可观察的脸、发型、体型、服装和配件，生成角色设定板与干净全身参考图。
- 主题色系统：用户指定主题色时优先使用，否则从人物服装或配件提取稳定强调色，生成 theme.json，并让该主色驱动封面背景、标题区、macOS 窗口细节、内页编号、分区线和重点框。
- 卡片样式样稿：按用户确认的卡片动作生成透明人物图，渲染正文样稿供确认。
- Markdown 解析：解析标题与图片清单，标记关键图，支持教程模式（建立“步骤—截图—完成标志”映射）。
- 封面制作：使用 $punk-ip-article-illustrations 生成 16:9 IP 主题插图，再合成 1080×1440 主题色封面，中间嵌入 960×620 的 macOS 窗口。
- 内页生产：默认交付 1 张无页码封面＋9 张内页，内页从 01 开始编号，可依文章需要调整数量。
- 发布文案：生成一个推荐标题、三个备选标题、一段正文和 6–10 个 tags。
- 输出校验与打包：运行 validate_output.py 检查关键图是否进入卡片，通过后打包 ZIP。
使用方式
技能按三个确认门依次执行：人物确认、卡片样式确认、封面确认。未通过前一门时不得进入后一阶段，也不得提前拆分 Markdown。
首次使用时，若没有已确认人物，技能只发送引导信息，不读取文章，要求用户准备四项：一张清晰人物照片或已完成 IP 形象、人物名称或昵称、一个主题色（Hex 色值或颜色参考）、希望人物在卡片里做的动作。
人物草稿不得用于封面或卡片，只有用户明确说“确认”“定稿”“就用这个”时才运行确认命令。人物确认后仍须取得明确的卡片动作。
封面阶段需先运行：
python3 scripts/parse_markdown.py <source.md>
生成 cards.json 后使用跨平台 Python 渲染器：
python3 scripts/render_cards.py <cards.json绝对路径> <output目录绝对路径> <profile.json绝对路径>
Windows 使用 py -3 scripts\render_cards.py ... 或 scripts\render_cards.ps1；macOS 与 Linux 也可使用 scripts/render_cards.sh。样稿追加 --allow-draft。
输出结构：
<article-slug>-小红书/
├── source.md
├── cover-illustration.png
├── assets/
│ └── article-images/
│ ├── image-01.png ...
│ └── manifest.json
├── cards.json
├── publish-copy.md
├── output/
│ ├── cover.png
│ ├── card-01.png ... card-09.png
└── <article-slug>-小红书.zip
适用场景
- 把 𝕏、微信公众号等平台的长文转换为小红书竖版知识卡片。
- 需要保留原文关键截图、图表、流程图的教程类文章。
- 希望统一个人 IP 形象与主题色视觉风格的内容创作者。
- 需要同时产出卡片图与小红书标题、正文、话题标签的发布流程。
限制
- 必须使用已安装的 $punk-ip-article-illustrations Skill 生成封面主题插图；若该 Skill 不可用，需明确说明缺少依赖并停止在封面阶段。
- 没有图像生成能力时，输出缺少的依赖或已编译提示词与保存计划，明确说明封面尚未完成。
- 不把真人照片、生成角色、用户文章或本次封面插图写入 Skill 安装目录。
- 原始照片默认不复制进文章输出、不提交 GitHub、不公开上传。
- 作者名只读取当前已确认 profile 的 author_name，不得从 Markdown 中的 author:、作者：或“关于作者”内容提取。
- 封面不显示页码、总页数、栏目名、品牌名或账号；内页账号来自 profile，没有则省略。
- 所有图片 1080×1440；封面主题插图源图为 16:9。
- 人物每张只出现一次，必须等比例、不裁头、不改变脸。
- 教程中的操作截图与检查点截图是内容，不是装饰；缺少任意必备步骤图时不得宣布完成。
- 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。