运行目录
每次成品放在本 skill 根目录下的
output/<YYYY-MM-DD>-<slug>/(下文简称 <run>,用户可以改名)。不要写到会话工作目录。
output/2026-09-22-avoid-brain-rot/
draft.md # 用户给的文案,原样保存
spec.json # 渲染脚本读取的卡片规格
cards/*.png # 3:4 图片 + preview.html + manifest.json
下面命令里的路径都相对本 skill 根目录。脚本会把相对路径落到 skill 目录,
与当前工作目录无关。给用户看图片。
输入
用户提供文案。至少要有标题和正文。来源、截图、头像有就收下,没有就不编。
文案不完整(没有正文,或只有一句标题)就停下来问。不要自己写成一篇笔记,也不要改写用户的句子。
把原文存成 <run>/draft.md。
配图
先读 references/card-spec.md:十套模版的选择表、字段说明和完整自检都在里面。
一篇笔记只选一个模版:按这篇文案的内容形态选一套写进 meta.template,整篇所有页都用
这一套渲染。不要给每张卡各选一套,也不要先定风格再硬塞字段。
不放话题标签、角标、评论号召。
分页、换行和 **强调** 是为了上屏。判断、数字、原话保持用户的说法。
字被压得太小就删重复句或拆页,不换一种说法。
python3 scripts/render_cards.py output/<run>/spec.json \
--out output/<run>/cards
每张卡片是精确的 1080×1440 PNG,外加 preview.html 和 manifest.json。
分页按内容量定:内容少就 2–3 页,不硬凑;一句话的末页并回上一页(用引用块收尾),
不单独占页。先写 spec 渲一遍,按输出逐条修到干净:
text shrunk to且低于 85%——这一页塞多了,删字或拆成两张,字太小手机上读不了;only ... filled——正文页填充率不到 60%,合并短页或把邻页内容挪过来,
不允许靠留白凑页数(封面大字页除外)。
交付前逐张打开图片看一遍(中文字形、换行、裁切),再按 card-spec.md 的自检逐条过,
全部通过才算完。然后在对话里用绝对路径把图片直接显示出来,告诉用户文件夹在哪。