
article2media
文章 / 视频 → 小红书卡片、杂志长图、公众号排版、口播视频、原文排版、翻译、白板与漫画:10 个独立能力 + 推荐组合
- version
- 2.3.1
- GitHub stars
- 433
Install
/plugin install article2media@article2mediaRun it inside Claude Code after adding the marketplace with /plugin marketplace add threerocks/article2media.
Contents
Discovered from sourceSkills 11
漫画(article-comic)
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
生成图让角色、场景、动作和结果可见;HTML 把文字写准确。同时输出长漫画和 3:4 卡片。
参数:$ARGUMENTS
0. 输入与能力
- 文章
article.md(原文、译文或逐字稿)。给的是链接、文件或视频时,先用article-fetch/video-transcript取原文(见../article2media/references/pipeline.md)。 - 先确认有出图能力:
node ${CLAUDE_SKILL_DIR}/scripts/doctor.mjs的ai-illustration一行。没有就告诉用户做不了漫画,建议改用长图(long-image)或白板(logic-whiteboard)。
1. 流程
- 完整读一遍文章,读
references/mode-comic.md,写<目录>/comic.json(认知因果拍点 + 固定角色)。 node ${CLAUDE_SKILL_DIR}/scripts/comic.mjs check <目录>/comic.json,修完提示。node ${CLAUDE_SKILL_DIR}/scripts/comic.mjs make <目录>/comic.json:出图(约 1–1.5 分钟一格,3 格并行)+ 排版。只改文字时用comic.mjs render(分格已缓存)。- 讲概念、机制的内容,按
../article-rewrite/references/writing-guide.md第 6 节把具体情形、判别依据、关系和结果接起来。
2. 审片与交付
comic/review/里有覆盖全部高度的重叠切片,逐张看完;也看每一格生成图里有没有画出文字、角色是否一致。- 报告:PNG 路径与像素尺寸、来源、格数与因果链、生成图张数、用的出图服务;3:4 卡片目录。制作范围写在交付回复里,不写进图里。
文章抓取(article-fetch)
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
把任意文章变成 article.md:后面所有能力(改写、翻译、长图、卡片、公众号、口播、白板、漫画)都从这份文件开始。视频不归这里管,用 video-transcript。
参数:$ARGUMENTS
1. 环境检查(本会话第一次)
node ${CLAUDE_SKILL_DIR}/scripts/doctor.mjs
需要 Node 22+;网页和公众号要用到本机 Chrome。失败时把修复建议转告用户,然后停下。
2. 抓取
node ${CLAUDE_SKILL_DIR}/scripts/fetch.mjs "<url 或文件>" # 默认输出到 ./article2media-out/<slug>/
node ${CLAUDE_SKILL_DIR}/scripts/fetch.mjs "<url>" --out <目录> # 指定目录
- X / Twitter:通过 FxTwitter 公开 API,长文、帖子、线程都支持,不需要登录。
x.com/i/article/…这种内部链接解析不了,请用户给发布文章的那条推文链接。 - 普通网页:依次尝试 r.jina.ai、defuddle.md,最后用本地 Chrome 提取。加
--no-proxy不经过第三方服务。 - 微信公众号:直接用本地 Chrome 提取。
- 本地文件:Markdown / 文本直接读,HTML 用 Chrome 提取正文。
--title、--author可以补标题和作者。 - 用户直接粘贴正文:不用抓取,自己写
./article2media-out/<简短英文 slug>/article.md:front matter 写title、author、platform、date,正文第一行# 标题,其余原样粘贴,不改字。 - 给的是视频链接、音视频或字幕文件时,脚本会拒绝并提示:改用
video-transcript。
输出:<目录>/article.md、meta.json;终端打印一段 JSON(目录、标题、作者、平台、字数)。
3. 检查
完整读一遍 article.md:
- 正文明显不全(只有摘要、被登录墙截断、只抓到评论区)时,告诉用户,请对方粘贴正文;
- 标了
<!-- 未识别的内容块 -->的地方可能缺内容,交付时说明。 - 脚本提示「⚠ 正文只有 N 字,主要内容可能在视频 / 图里」时(常见于图解帖、短视频帖):X 帖子的视频写成了「封面图 + ▶ 视频链接」。先看图;视频用 ffmpeg 抽帧(第一帧常是带标注的完整图解)看画面。有配音的交给
video-transcript;只有画面文字的,把文字按原语言逐字整理进article.md(放在对应的图 / 视频后面,用原文的分组做小标题),交付时说明哪些内容来自画面。
4. 交付
单独使用时:给出 article.md 的绝对路径、标题、作者、平台、字数,以及上面发现的缺漏。
在组合里:把目录交给下一个能力(见 ../article2media/references/pipeline.md)。
改写(article-rewrite)
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
把一篇文章重组成改写稿 content.json:你负责读懂、规划、改写、选图、核对数字;脚本负责校验。改写稿只写内容,不含颜色和字体,换风格不用重写。改写和总结是同一件事。
参数:$ARGUMENTS
| 产出 | 给谁用 |
|---|---|
content.json(改写稿) | long-image(总结长图)、image-cards(总结卡片)、explainer-video(参考事实与结构) |
rewrite.md + rewrite-assets/(改写稿的文章形态,export.mjs 导出) | wechat-layout(公众号总结),也可以直接给人读 |
输入
article.md(原文、译文或逐字稿)。给的是链接或文件时,先用 article-fetch(视频用 video-transcript)取原文;调用方式和工作目录见 ../article2media/references/pipeline.md。同一篇已有 content.json 时不要重写:只补新版式需要的字段。
逐字稿是口语:去掉口头禅和重复,事实、数字、人名以视频为准;识别可能出错的专有名词对照 transcript/segments.md 判断,拿不准的交付时说明。来源写成「内容整理自 <作者> 的<平台>视频《标题》」。
第一次使用先跑 node ${CLAUDE_SKILL_DIR}/scripts/doctor.mjs(校验和导出要用到 Node 22+、Chrome;ai-illustration 一行是出图能力)。
1. 规划
完整读一遍 article.md,再读 references/writing-guide.md,然后确定:
- 核心主张(一句话);
- 页数和每页的
part,按references/content-schema.md末尾的密度表定(--pages可强制 1–4 页); - 每节的标题、两张图的类型、面板类型;
- 主题:用户没指定时,按
../article2media/references/styles.md选一个,写进theme。
不需要先把大纲给用户确认,除非用户要求先看大纲。
2. 核对数字(只在 --verify 或用户要求时)
- 对文中 3–8 个关键数字或事实,用 WebSearch / WebFetch 查原始出处。
- 在对应面板里写明结论,例如"与 IAB 一致;2026 年为预测值""未找到出处",面板标题写"· 编者核对"。
- 没核对时,任何地方都不能出现"核对"字样。
3. 写 content.json
写之前必须读 references/content-schema.md 和 references/figures.md(每种图表、面板的完整写法见 examples/gallery.json;一篇 3,700 词长文的完整示例见 examples/dan-koe.json)。写到原文同目录的 content.json,然后校验:
node ${CLAUDE_SKILL_DIR}/scripts/check.mjs <目录>/content.json # 长图
node ${CLAUDE_SKILL_DIR}/scripts/check.mjs <目录>/content.json --ratio 3:4 # 还要出卡片时,同时检查卡片
- 要出卡片时,再读
../image-cards/references/xhs-guide.md,写上cover、xhs,需要时给个别节加card提示。 - 要出公众号总结时,再读
../wechat-layout/references/wechat-guide.md,写上wechat.title、wechat.digest。 - ✗ 必须修完。⚠ 提示逐条处理到 0 再出图:长度提示缩短文字;"数字在原文里找不到"改成原文数字或在 note 里注明;"第一人称"改成第三人称;"数据面板偏少""整页卡偏少""原文配图一张没用"按提示补上。只有确认提示不适用时才保留,并在交付时说明原因。
- 校验会和同目录的
article.md比对(数字来源、人称、配图),所以 content.json 要和 article.md 放在一起。 - 改 content.json 用编辑工具或
node/python脚本,不要用sed -i:macOS 和 Linux 的写法不同,改不上也不报错。 - 讲概念、机制的内容,按 writing-guide 第 6 节把具体情形、判别依据、关系和结果接起来。
4. AI 插画(只在用户要插画或传了 --illustrate 时)
- 按
figures.md的 illustration 一节写:cover.illustration.prompt(封面),再挑 1–2 个故事性强、缺数据的节,把其中一张图换成{"type": "illustration", "prompt": "…"}。 - 生成:
node ${CLAUDE_SKILL_DIR}/scripts/illustrate.mjs <目录>/content.json。脚本按 content.json 的主题选画风;之后换主题要画风一致,就加--theme 新主题再生成一次。 - 生成失败(没有出图能力、免费层没有图像额度等)时,把报错原话告诉用户,然后去掉插画字段照常继续。不要交付带"插画待生成"占位框的图。
- 打开生成的图看一眼:有没有画出文字、主体是否清楚、和主题搭不搭。不满意就改 prompt,加
--force重新生成。
5. 导出文章(公众号总结、或用户要一篇总结稿时)
node ${CLAUDE_SKILL_DIR}/scripts/export.mjs <目录>/content.json # → <目录>/rewrite.md + rewrite-assets/
node ${CLAUDE_SKILL_DIR}/scripts/export.mjs <目录>/content.json --theme quiet # 图表按指定主题截图
- 图表截成图片,颜色跟主题走,主题写进
rewrite.md的 front matter;公众号排版默认用同一个主题。换主题要重新导出。 - 导出后会把
rewrite.md解析回来校验;有 ✗ 说明 content.json 里有会被当成 Markdown 结构的文字,按提示改 content.json 后重导,不要手改 rewrite.md。
6. 交付
- 单独使用时:
content.json(和rewrite.md)的绝对路径、一行大纲(每页的 part)、主题和理由,以及:要出图用long-image/image-cards,要发公众号用wechat-layout排rewrite.md。 - 在组合里:把目录交给下一个能力。
- 需要用户留意的:未核对的数字、抓取不全的段落、编者补的节、插画用的服务商和张数。
全文翻译(article-translate)
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
把 article.md 译成 article.zh.md。这是翻译,不是改写:一句不删、一句不加,结构与原文逐块对应。要提炼、总结,用 article-rewrite。
参数:$ARGUMENTS
输入
article.md。给的是链接、文件或视频时,先用 article-fetch / video-transcript 取原文(见 ../article2media/references/pipeline.md)。默认译成简体中文;用户要别的语言时,文件名用对应代码(article.en.md),规则相同。
1. 看清原文
node ${CLAUDE_SKILL_DIR}/scripts/translate.mjs stats <目录>/article.md
告诉你一共多少块(段落、标题、列表项、表格单元、图注……)、多少词。然后完整读一遍原文。
2. 翻译
读 references/translate-guide.md,然后写 <目录>/article.zh.md:
- front matter:复制原文的全部字段;
title换成中文标题;加lang: "zh"、translated_from: "article.md"、source_title: "<原标题>"。 - 正文:逐块翻译,块的种类和顺序不变——原文一段就是译文一段,一个列表项就是一个列表项,表格行列不变,
# 标题那行换成中文标题。 - 原样保留:代码块、图片
、链接地址、人名和品牌名的原文写法(可以首次出现时括注中文)。 - 原文里粗体、斜体在哪,译文对应的词也加上。
- 长文分几次写完没关系(先写前半,再用编辑追加),但不能为了省事概括。
3. 检查
node ${CLAUDE_SKILL_DIR}/scripts/translate.mjs check <目录>/article.md <目录>/article.zh.md
- ✗(块数不一致、某块类型变了、代码或图片地址被改)必须修,直到 0 个错误。
- ⚠ 逐条看:「像是没翻译」「比其他段短很多(可能漏译)」「数字没找到」。确实是名字、链接或把数字写成了汉字的,可以保留,交付时说明。
4. 交付
- 单独使用时:
article.zh.md的绝对路径、块数("42 / 42 块对应")、检查结果,以及你保留原文的专有名词。 - 在组合里(外文搬运、原文卡片):把
article.zh.md交给下一个能力——它对排版来说就是"原文",按一字不改的规则排。来源写明「译自 <作者> 的<平台>文章《原标题》」。 - 翻译他人文章公开发布前,提醒用户确认授权。
article2media:推荐组合
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
article2media 由 10 个能力组成,每个都是独立的 skill,可以单独用,也可以按任意顺序组装。本 skill 是总入口:听懂用户要什么,选一个组合,依次调用各个能力,最后统一交付。本目录的 engine/ 是所有能力共用的脚本、主题和版式。
参数:$ARGUMENTS
能力
| skill | 能力 | 输入 → 产出 |
|---|---|---|
article-fetch | 文章抓取 | X 长文 / 网页 / 公众号 / 本地文件 → article.md |
video-transcript | 视频转文字 | 抖音、YouTube、B 站、本地音视频、.srt/.vtt → article.md(逐字稿) |
article-rewrite | 改写(总结) | article.md → content.json(改写稿),可导出 rewrite.md |
article-translate | 全文翻译 | article.md → article.zh.md(不删减,逐块对应) |
long-image | 长图 | content.json → 总结长图;article.md → 原文长图 |
image-cards | 卡片 | content.json → 总结卡片;article.md → 原文卡片(3:4 / 4:5 / 1:1 / 9:16) |
wechat-layout | 公众号排版 | 文章(原文、译文或 rewrite.md)→ 可粘贴的图文 + 封面 |
explainer-video | 口播视频 | 文章(可参考 content.json)→ 1080×1920 竖屏讲解视频 |
logic-whiteboard | 白板论证 | article.md → 把推理摊成纵向主干的长图 |
article-comic | 漫画 | article.md → 黑白漫画 + 3:4 卡片(需要出图能力) |
能力之间只通过工作目录里的文件交接;交接文件、"原文还是改写"的默认判断、怎么调用别的能力,都在 references/pipeline.md。开始前先读它。
推荐组合
| 组合 | 用户通常这么说 | 链路 |
|---|---|---|
| 总结长图(默认) | 做成图、长图、总结图 | 取原文 → 改写 → 长图 |
| 小红书总结 | 做成小红书、卡片、3:4、IG | 取原文 → 改写 → 卡片 |
| 公众号排版 | 排成公众号、公众号排版 | 取原文 → 公众号排版 |
| 公众号总结 | 总结成一篇公众号 | 取原文 → 改写 → 导出 rewrite.md → 公众号排版 |
| 外文搬运 | 翻译成中文发公众号 | 取原文 → 翻译 → 公众号排版 |
| 原文长图 | 原文排版、全文长图、一字不改、-f | 取原文 → 长图(原文) |
| 原文卡片 | 全文做成小红书卡片、原文卡片 | 取原文 →(外文先翻译)→ 卡片(原文) |
| 视频转图文 | 这个视频做成长图 / 小红书 | 视频转文字 → 改写 → 长图或卡片 |
| 视频转文字 | 视频转文字、逐字稿 | 视频转文字(交付 article.md) |
| 一稿多发 | 长图、小红书、公众号都要 | 取原文 → 改写一次 → 长图 + 卡片 + 公众号(rewrite.md) |
| 文章转口播 | 做成视频、口播、视频号 | 取原文 → 口播视频 |
| 白板 / 漫画 | 论证图、-w;漫画、四格、-c | 取原文 → 白板 / 漫画 |
| 批量 | 一次给多个链接、"这周这几篇都做成…"、links.txt | batch.mjs init → 逐条按同一规格做 → 发布清单(见「批量」) |
- 取原文:文章用
article-fetch,视频用video-transcript;用户直接粘贴正文时,自己写article.md(见 pipeline.md 第 1 节)。 - 用户可以点名组合(
/article2media 小红书总结 <链接>),也可以自己组装("先翻译,再出原文卡片""改写后只要 1:1"),按用户说的顺序调用即可,表里没有的组合同样成立。 - 用户没点名组合时,按 pipeline.md 第 2 节的默认表判断原文还是改写,再从上表挑最接近的组合。输入和输出分开判断:给视频只说明原文是视频,产出仍按用户说的定。
- 以前的参数照样有效:
-f= 原文长图,-w= 白板,-c= 漫画,--ratio/ 平台名 = 卡片,"公众号" = 公众号排版,"视频" = 口播视频;--style、--illustrate、--verify、--pages、--lang交给对应的能力。
流程
- 环境检查(本会话第一次):
node ${CLAUDE_SKILL_DIR}/engine/scripts/doctor.mjs。失败时把修复建议转告用户,然后停下。local-fonts一行显示没装本地字体、而用户网络不稳定(出图报"字体没有加载")时,建议他运行一次node ${CLAUDE_SKILL_DIR}/scripts/fonts.mjs(约 65 MB,可加--mirror <主机>):这是下载,要用户同意再跑;之后出图不再联网加载字体。 - 定组合:不需要先跟用户确认,除非 pipeline.md 第 2 节说要问。
- 依次调用能力:按 pipeline.md 第 3 节调用每个 skill,照它的 SKILL.md 做完、检查通过(✗ 全部修完),再进入下一步。所有能力用同一个工作目录。
- 一份改写稿多处用:一稿多发时只改写一次;同一篇已有
content.json时不要重写,只补新版式需要的字段。 - 交付:把每个能力的交付项合在一起说,按产物分组:
- 每个产物的绝对路径;
- 走了哪条组合(例如"原文 → 改写 → 3:4 卡片");
- 用了哪个主题(你选的就一句话说明理由),以及怎么换主题、换版式;
- 卡片贴出发帖文案,公众号贴出标题、摘要和封面路径;
- 需要用户留意的地方:未核对的数字、抓取不全的段落、识别可能出错的专有名词、翻译检查的提示。
- 产物是要发布的(卡片、长图、公众号、视频)时,最后加一句:"发布后把链接和数据告诉我,我记下来"(见「发布之后」)。
批量
用户一次给多个链接(或一个 links.txt)时用。规格整批固定,脚本管抓取、队列和状态,改写和出图仍由你一条一条按各能力的 SKILL.md 做。
node ${CLAUDE_SKILL_DIR}/scripts/batch.mjs init links.txt --name 本周 --spec "cards:3:4,long,wechat" # 也可以直接写几个链接;--theme 整批固定主题
node ${CLAUDE_SKILL_DIR}/scripts/batch.mjs next 本周 # 下一条内容 + 确切的下一步(能直接跑的会给出命令)
node ${CLAUDE_SKILL_DIR}/scripts/batch.mjs status 本周 # 从磁盘重新计算状态,更新看板 queue.md
node ${CLAUDE_SKILL_DIR}/scripts/batch.mjs checklist 本周 # 给做完的每一条写发布清单 publish.md
- init:
--spec按用户说的定(cards[:比例]总结卡片、long总结长图、wechat公众号原文排版、wechat-rewrite公众号总结、full原文长图、full-cards原文卡片、video、whiteboard、comic;没说就是long)。已抓过的链接自动跳过(--refetch重抓),视频链接记为"待转写",不会让整批失败。用户说了自己打算几点发,才写--schedule "xhs=周二 20:00";不要替用户编发布时间。 - 循环:运行
next→ 照它说的做这一步(改写用article-rewrite,出图用对应能力,检查的 ✗ 修完)→ 再运行next。一次只做一条内容,做完一条再做下一条;主题没固定时每篇各自按 styles.md 选。 - 停下来问用户,不要自己决定:
next末尾列出的"等用户确认"的条目——抓取失败(换链接、粘贴正文,或skip)、正文偏短或疑似付费墙(看一眼article.md,确认内容完整才confirm,否则请用户粘贴正文)。其余条目照常做完,最后一起问,不要让一条坏链接卡住整批。 - 收尾:
next显示"能做的都做完了"后运行checklist,再运行status,把看板(article2media-out/batches/<批次>/queue.md)的表格贴给用户:每条的产物路径、失败和跳过的原因、发布清单里的 ✗ / ⚠。
发布之后
- 发布清单:单篇也可以出,
node ${CLAUDE_SKILL_DIR}/scripts/batch.mjs checklist <工作目录>写publish.md:每个平台按顺序上传哪些文件、标题候选(content.json的xhs.title/wechat.title加publish.titles里的备选)、正文、标签、封面,以及平台硬性限制的 ✓ / ✗(小红书标题 ≤ 20、正文 ≤ 1000、图 ≤ 18;公众号标题 ≤ 64、摘要 ≤ 120)。有 ✗ 先改 content.json 再出。 - 记数据:用户说"发了"或报数据时,记到这篇的工作目录里(
publish.json)。发了什么(形式、主题、封面版式、张数、标题)脚本自己从产物里读,只有读错时才用--form / --theme / --cover / --title改;用户没给的数字不要填、不要估。
平台:node ${CLAUDE_SKILL_DIR}/scripts/stats.mjs add <工作目录> --platform xhs --url <链接> --views 1200 --likes 80 --saves 150 --comments 9 --shares 12 --follows 5 node ${CLAUDE_SKILL_DIR}/scripts/stats.mjs list <工作目录> node ${CLAUDE_SKILL_DIR}/scripts/stats.mjs report # 汇总 ./article2media-out 下所有记录,写 stats-report.mdxhs小红书、wechat公众号、x、douyin抖音、channels视频号、weibo、other。数据名各平台叫法不同:--views阅读 / 曝光 / 播放,--likes点赞,--saves收藏,--comments评论,--shares转发 / 分享,--follows涨粉。同一篇过几天再报数据,再运行一次add就多一次快照。 - 看报告:用户问"哪种效果好"时运行
report,把结论照实说:n < 5 的组报告里标着"样本不足,仅供参考",转述时要带上这句,不要把两三条帖子的差别说成规律。选主题时怎么用这份报告,见references/styles.md的选择指南。
口播视频(explainer-video)
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
文章 → 竖屏讲解视频。你是导演:读懂内容、决定讲什么和怎么讲,写 video.json;脚本负责配音、对齐、动画、渲染、混音和审片。
参数:$ARGUMENTS
0. 输入
- 文章
article.md(原文、译文、逐字稿)。给的是链接、文件或视频时,先用article-fetch/video-transcript取原文(见../article2media/references/pipeline.md)。 - 同目录已有
content.json时,直接用它的事实、数字和结构,不必重新提炼。没有也不需要先改写:口播稿本身就是一种改写,由你在 video.json 里完成。 - 外文原文直接写中文口播即可,不需要先全文翻译。
1. 流程
node ${CLAUDE_SKILL_DIR}/scripts/video.mjs doctor看本机能力(配音、对齐、插画、ffmpeg),按references/video-guide.md第 1 节决定要不要问用户(通常不用问)。- 完整读一遍文章,再读
references/video-guide.md,写<目录>/video/video.json:定调(受众、核心、开场策略)→ 封面 → 每镜口播和画面 → 选音色、选主题(按../article2media/references/styles.md)。首句 ≤ 19 字、5 秒内说完;解说最忌急,说不完就删字,不加快语速。用户手里有原视频或音乐文件时,可以在镜头里放片段(clip)、垫背景音乐(music)、换转场(transition),见指南 2.7;都只用本地文件,不下载、不生成。 video.mjs check修完提示,再video.mjs make(配音、可选插画、渲染、混音、审片一步完成;配音按句缓存,改口播只重配改动的句子)。- 按指南第 4 节审片:看
contact-sheet.jpg和检查项,改video.json重渲,最多 2 轮。 - 按指南第 5 节交付:视频、封面、镜头大纲、音色(公开 / 本机个人)、缺了哪些能力、发布前的 AI 声明提醒。
音色:默认用随包公开音色(video.mjs voices 查看)。克隆自他人或平台的音色只能进本机个人音色库,不能放进 skill 的公开音色目录;用了本机个人音色时,提醒公开发布前确认授权。
卡片(image-cards)
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
| 输入 | 产出 |
|---|---|
content.json(改写稿) | 总结卡片:<目录>/<主题>-3x4/card-01.png …、overview.jpg、caption.md |
article.md(原文、译文、逐字稿、rewrite.md) | 原文卡片:<目录>/full-3x4/card-01.png …、overview.jpg、caption.md |
参数:$ARGUMENTS
比例怎么定:用户提到小红书、RED、xhs、抖音图文、3:4 → --ratio 3:4(默认);Instagram、IG、4:5 → 4:5;方图、正方形、朋友圈、1:1 → 1:1;竖屏、Stories、快拍、9:16 → 9:16。
0. 先确定输入
- 已有
content.json→ 总结卡片;用户只给了文章、又说"原文 / 全文 / 一字不改" → 原文卡片。 - 给的是链接、文件、粘贴的正文或视频 → 先用
article-fetch/video-transcript取原文。 - 只有文章、用户没说原文还是总结 → 卡片默认改写:先用
article-rewrite写 content.json(卡片专用字段按references/xhs-guide.md写)。原文是外文、又要原文卡片 → 先用article-translate。 - 判断规则、工作目录和调用其他能力的方式:
../article2media/references/pipeline.md。
第一次使用先跑 node ${CLAUDE_SKILL_DIR}/scripts/doctor.mjs(Node 22+、Chrome)。
1. 总结卡片(content.json)
读 references/xhs-guide.md:封面、每张卡只讲一件事、发帖文案(cover、xhs、card 字段)。
node ${CLAUDE_SKILL_DIR}/scripts/cards.mjs <目录>/content.json --ratio 3:4 --check # 只校验:会出几张
node ${CLAUDE_SKILL_DIR}/scripts/cards.mjs <目录>/content.json --ratio 3:4 # 出图,一组大约 5 秒
node ${CLAUDE_SKILL_DIR}/scripts/cards.mjs <目录>/content.json --ratio 3:4 --theme brutal
node ${CLAUDE_SKILL_DIR}/scripts/cards.mjs <目录>/content.json --covers # 只出封面的几个版本,供挑选或对比发布
node ${CLAUDE_SKILL_DIR}/scripts/cards.mjs <目录>/content.json --form onepage # 轻量形态:onepage 一页看完 | quotes 金句图 | qa 问答卡
- 封面多版本、轻量形态、品牌包(头像、品牌色、期号):xhs-guide.md 第 2.5 节。用户说"多出几个封面""金句图""一张图讲完""问答形式""加上我的头像 / 做成系列"时用。
- 主题:content.json 的
theme(可写成{"long": …, "cards": …}分开指定);都没有时按../article2media/references/styles.md选。卡片场景的主题调整见 styles.md 第 3 步。 - 检查(最多 2 轮:出图 → 发现问题 → 改 content.json 或参数 → 再出图,算一轮;只跑 check.mjs 不算):先看
overview.jpg,有问题再打开单张卡。✗ 必须修;报「内容超出」「已自动省略」「图只放大到 x 倍」时,按 xhs-guide.md 第 2 节的顺序处理(缩短card.text、改split、skip次要的节)。出图阶段最多 2 轮,到了就停:剩下的 ⚠ 写进交付说明,不要为了让提示归零删掉面板、图或正文(内容比提示数要紧)。check.mjs 的内容提示仍然处理到 0。只改 content.json 再重渲,不手改 HTML。
2. 原文卡片(article.md)
读 references/original-cards.md 和 ../article2media/references/verbatim.md。
node ${CLAUDE_SKILL_DIR}/scripts/cards.mjs <目录>/article.md --ratio 3:4
node ${CLAUDE_SKILL_DIR}/scripts/cards.mjs <目录>/article.md --ratio 3:4 --theme quiet # 用主题的颜色与字体
全文校验未通过就是错误,不能靠目测放行。看 overview.jpg 检查断开的位置;张数超过上限时按 original-cards.md 处理,不删原文。
3. 交付
- 卡片目录、张数、每张的尺寸;
overview.jpg路径; - 把
caption.md里的标题、正文和标签直接贴在回复里,方便复制(原文卡片要你补标签、必要时缩短标题); - 总结卡片:用的主题和理由;换主题
--theme 名称、换比例--ratio 4:5都不用重写内容; - 原文卡片:原文块数与全文校验结果、生成图 0 张;
- 需要用户留意的地方。
白板论证(logic-whiteboard)
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
呈现作者怎样一步步走到结论,不是摘要:读者只看成品,也应能复述"为什么下一步从上一步发生"。
参数:$ARGUMENTS
0. 输入
文章 article.md(原文、译文或逐字稿)。给的是链接、文件或视频时,先用 article-fetch / video-transcript 取原文(见 ../article2media/references/pipeline.md)。不需要先改写。
第一次使用先跑 node ${CLAUDE_SKILL_DIR}/scripts/doctor.mjs(Node 22+、Chrome)。
1. 流程
node ${CLAUDE_SKILL_DIR}/scripts/whiteboard.mjs <目录>/article.md:生成来源清单whiteboard-source.json(每段一个编号和哈希)。- 完整读一遍文章,读
references/mode-whiteboard.md,写<目录>/whiteboard.json(论证账本:每段原文必须进入某一步,或写明省略理由)。 whiteboard.mjs <目录>/whiteboard.json --check通过后,whiteboard.mjs <目录>/whiteboard.json渲染 →<目录>/whiteboard/whiteboard.png。- 讲概念、机制的内容,按
../article-rewrite/references/writing-guide.md第 6 节把具体情形、判别依据、关系和结果接起来。
2. 审片与交付
whiteboard/review/里有覆盖全部高度的重叠切片,逐张看完再交付。- 报告:PNG 路径与像素尺寸、来源、步骤数、可见转折数、来源段落的去向(几段进入步骤、几段省略及理由)。制作范围、是否核对过,写在交付回复里,不写进图里。
长图(long-image)
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
| 输入 | 产出 |
|---|---|
content.json(改写稿) | 总结长图:默认手机版,单栏、1080 宽,手机上不用放大就能读;--wide 出 1200 宽的双栏杂志版(适合电脑上看、打印、做展示图)。<目录>/<主题>/page-01.png … |
article.md(原文、译文、逐字稿、rewrite.md) | 原文长图:一字不改,1080 宽,<目录>/full/full.png(过长时 full-01.png …) |
参数:$ARGUMENTS
0. 先确定输入
- 已有
content.json→ 总结长图;用户只给了文章、又说"原文 / 全文 / 一字不改 / -f" → 原文长图。 - 给的是链接、文件、粘贴的正文或视频 → 先用
article-fetch/video-transcript取原文。 - 只有文章、用户没说原文还是总结 → 长图默认改写:先用
article-rewrite写 content.json。原文是外文、又要原文长图 → 先用article-translate。 - 判断规则、工作目录和调用其他能力的方式:
../article2media/references/pipeline.md。
第一次使用先跑 node ${CLAUDE_SKILL_DIR}/scripts/doctor.mjs(Node 22+、Chrome)。
1. 总结长图(content.json)
node ${CLAUDE_SKILL_DIR}/scripts/long.mjs <目录>/content.json # 主题取 content.json 的 theme
node ${CLAUDE_SKILL_DIR}/scripts/long.mjs <目录>/content.json --theme midnight # 用户指定主题
node ${CLAUDE_SKILL_DIR}/scripts/long.mjs <目录>/content.json --wide # 1200 宽双栏杂志版(文字在左、图在右)
node ${CLAUDE_SKILL_DIR}/scripts/long.mjs <目录>/content.json --theme all # 全部主推主题,分目录输出
node ${CLAUDE_SKILL_DIR}/scripts/long.mjs --list # 列出主题
- 每页输出 PNG 和同名
.html、qa.json,一页大约 4 秒。其他参数:--page 1,3、--scale 2、--format jpeg --quality 90、--max-height 7600(手机版默认 7600,宽版 4400)、--brand brand.json、--out 目录。 - 默认出手机版:用户在微信、朋友圈、微博里看长图,双栏的字在手机上太小。用户说"杂志版 / 宽版 / 双栏 / 电脑上看 / 要打印"时加
--wide。手机版一页很高(常见 9000–13000 px);超过 16000 px 时会自动降低输出倍数并提示,这时把这一页拆成两页。 - content.json 没写主题、用户也没指定时,按
../article2media/references/styles.md选一个,写进 content.json。 - 有 AI 插画还没生成时会出占位框并提示:用
article-rewrite的illustrate.mjs生成,生成不了就去掉插画字段。
检查与修正(最多 2 轮:出图 → 发现问题 → 改 content.json 或参数 → 再出图,算一轮;只跑 check.mjs 不算)
- 版面检查:✗(图内溢出、文字截断、元素重叠、图片加载失败)必须修——缩短图内文字、减少项目,或换一种图;⚠「末行只剩一个字」给那句话增减两三个字;⚠「页面过高」删减内容或拆成两页。
- 亲眼看图:用 Read 打开每张 PNG,看图能不能一眼看懂、图和图注是不是一回事、有没有哪节太空或太挤。
- 只改
content.json(字段写法见../article-rewrite/references/content-schema.md、figures.md),然后重新渲染。不要手改 HTML。
2. 原文长图(article.md)
node ${CLAUDE_SKILL_DIR}/scripts/long.mjs <目录>/article.md # 白底阅读面
node ${CLAUDE_SKILL_DIR}/scripts/long.mjs <目录>/article.md --theme quiet # 用主题的颜色与字体
读 references/original-long.md(阅读面规格)和 ../article2media/references/verbatim.md(允许与禁止、逐块校验)。全文校验未通过(改字、调序、漏块、重复)就是错误,按提示修,不能靠目测放行。看 full/review/ 里的重叠切片,逐张看完再交付。
3. 交付
- 每张图的绝对路径(原文长图加像素尺寸);
- 总结长图:一行大纲(每页的 part)、用的主题(你选的就一句话说明理由)、怎么换:
--theme 名称、--theme all都不需要重写内容;要卡片用image-cards,要公众号用wechat-layout; - 原文长图:原文块数与全文校验结果("45 / 45 块逐字一致")、实际字体、分成了几张、生成图 0 张;
- 需要用户留意的地方(未核对的数字、抓取不全的段落)。
视频转文字(video-transcript)
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
把视频变成一篇逐字稿文章 article.md:之后可以直接交付,也可以交给改写、翻译、长图、卡片、公众号排版等能力,流程和文章完全一样。文章链接不归这里管,用 article-fetch。
参数:$ARGUMENTS
1. 能力检查(本会话第一次)
node ${CLAUDE_SKILL_DIR}/scripts/doctor.mjs
看 video-input 一行:有没有 yt-dlp(YouTube、B 站)、ffmpeg(转音频)、本地语音识别(没有字幕时)。缺了的告诉用户怎么装,不要自己安装或下载。只有 .srt / .vtt 时什么都不需要。
2. 转写
node ${CLAUDE_SKILL_DIR}/scripts/transcribe.mjs "<视频链接或文件>" # → ./article2media-out/<平台>-<id>/
node ${CLAUDE_SKILL_DIR}/scripts/transcribe.mjs "<链接>" --prompt "人名 术语" --terms 词表.txt
node ${CLAUDE_SKILL_DIR}/scripts/transcribe.mjs ./talk.mp4 --title "标题" --author "作者"
- 文字来源:人工字幕优先,其次平台的原语言自动字幕(不用机器翻译的字幕轨),都没有时本地 Whisper 识别。已有的逐字稿默认复用,
--force重来。 - 专有名词:先用
--prompt "人名 术语"提示,再用--terms 词表.txt(每行错词=>正词)替换。 - 平台要求浏览器 cookie 时(YouTube 的机器人校验、抖音分享页不带数据):先问用户能不能复用本机浏览器状态,同意后才加
--cookies-from-browser chrome;不同意就请用户把视频保存到本地,直接传文件。 - 其他参数:
--lang识别语言、--keep-video保留 MP4(截图用)、--out指定目录。来源、清理、产出文件的细节见references/video-input.md。
3. 核对
- 完整读一遍
article.md,对照transcript/segments.md的上下文核对人名、作品名、术语。识别明显不对的,用--prompt/--terms重跑;拿不准的不要猜,交付时列出来。 - 逐字稿只补标点、分段,不改字。不要手工"润色"它——要整理成文章,是改写(
article-rewrite)的事。
4. 交付
单独使用时:article.md 和 transcript/segments.md 的绝对路径、平台、时长、文字来源(人工字幕 / 自动字幕 / 本地识别)、段数与字数,以及拿不准的专有名词。
在组合里:把目录交给下一个能力(见 ../article2media/references/pipeline.md)。发布由逐字稿做成的图文或视频时,来源写成「内容整理自 <作者> 的<平台>视频《标题》」。
公众号排版(wechat-layout)
路径约定:文中的
${CLAUDE_SKILL_DIR}指本 SKILL.md 所在的目录。宿主没有替换这个变量时(命令里原样出现${CLAUDE_SKILL_DIR}),把它换成这个目录的绝对路径再运行;../<名字>/指同级的另一个 skill 目录。
把一篇文章排成可粘贴的公众号图文。正文一字不改;改不改写、译不译,在排版之前决定。
参数:$ARGUMENTS
0. 先确定排哪篇文章
| 情况 | 做法 |
|---|---|
给了 .md 文章,或说"排版 / 原文" | 直接排它 |
| 给的是链接、文件、粘贴的正文或视频 | 先用 article-fetch / video-transcript 取原文 |
| 说"总结 / 提炼 / 改写后发公众号" | 先用 article-rewrite 写 content.json(加 wechat.title、wechat.digest),再用它的 export.mjs 导出 rewrite.md,排 rewrite.md |
| 原文是外文,读者是中文 | 先用 article-translate 出 article.zh.md,排译文 |
| 只说"发公众号",没说原文还是总结 | 默认原文排版;一篇别人的长文、结果差别又大时,问一句"原文排版还是总结后再排" |
给的是 content.json 时脚本会拒绝:公众号排版只吃文章,先导出 rewrite.md。判断规则和工作目录见 ../article2media/references/pipeline.md。
第一次使用先跑 node ${CLAUDE_SKILL_DIR}/scripts/doctor.mjs(Node 22+、Chrome)。
1. 排版
node ${CLAUDE_SKILL_DIR}/scripts/wechat.mjs <目录>/article.md --check # 只校验:解析、标题长度
node ${CLAUDE_SKILL_DIR}/scripts/wechat.mjs <目录>/article.md --theme quiet # → <目录>/quiet-wechat/
node ${CLAUDE_SKILL_DIR}/scripts/wechat.mjs <目录>/rewrite.md # 主题默认用 rewrite.md 里记录的(图表按它截的图)
node ${CLAUDE_SKILL_DIR}/scripts/wechat.mjs <目录>/article.md --title "公众号标题" --digest "摘要" --cover-title "两行\n标题"
- 主题:用户指定 > 文章 front matter 的
theme> 按../article2media/references/styles.md选(没选时是 editorial)。rewrite.md的图表是按导出时的主题截的图,换主题要先重新导出。 - 标题、摘要、封面标题的写法和限制见
references/wechat-guide.md。
2. 检查(最多 2 轮:出图 → 发现问题 → 改 content.json 或参数 → 再出图,算一轮;只跑 check.mjs 不算)
- 版面检查:✗ 全文校验(逐块不一致)、图片没加载、标题超长、封面标题放不下,都必须修。正文问题改源头(article.md / content.json),不改 HTML。
- 亲眼看:打开
cover-2.35x1.png、cover-1x1.png;用浏览器或截图看一遍article.html的手机宽度效果。
3. 交付
article.html的绝对路径,告诉用户:"浏览器打开 → 点「复制到公众号」→ 在编辑器正文里粘贴";- 贴出标题、摘要,以及两张封面的路径(
wechat.md里有完整发布步骤); - 排的是哪篇(原文 / 译文 / 改写稿)、全文校验结果("44 / 44 块逐字一致")、主题和理由;
- 有图片没能下载、仍是外链的,提醒粘贴后检查。
Sponsors
Details
- Marketplace
- threerocks/article2media
- Category
- Community