文章 / 视频 → 小红书卡片、杂志长图、公众号排版、口播视频、原文排版、翻译、白板与漫画:10 个独立能力 + 推荐组合

version
2.3.1
GitHub stars
433

Install

/plugin install article2media@article2media

Run it inside Claude Code after adding the marketplace with /plugin marketplace add threerocks/article2media.

Contents

Discovered from source

Skills 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. 流程

  1. 完整读一遍文章,读 references/mode-comic.md,写 <目录>/comic.json(认知因果拍点 + 固定角色)。
  2. node ${CLAUDE_SKILL_DIR}/scripts/comic.mjs check <目录>/comic.json,修完提示。
  3. node ${CLAUDE_SKILL_DIR}/scripts/comic.mjs make <目录>/comic.json:出图(约 1–1.5 分钟一格,3 格并行)+ 排版。只改文字时用 comic.mjs render(分格已缓存)。
  4. 讲概念、机制的内容,按 ../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 时)

  1. 按 figures.md 的 illustration 一节写:cover.illustration.prompt(封面),再挑 1–2 个故事性强、缺数据的节,把其中一张图换成 {"type": "illustration", "prompt": "…"}。
  2. 生成:node ${CLAUDE_SKILL_DIR}/scripts/illustrate.mjs <目录>/content.json。脚本按 content.json 的主题选画风;之后换主题要画风一致,就加 --theme 新主题 再生成一次。
  3. 生成失败(没有出图能力、免费层没有图像额度等)时,把报错原话告诉用户,然后去掉插画字段照常继续。不要交付带"插画待生成"占位框的图。
  4. 打开生成的图看一眼:有没有画出文字、主体是否清楚、和主题搭不搭。不满意就改 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.txtbatch.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 交给对应的能力。

流程

  1. 环境检查(本会话第一次):node ${CLAUDE_SKILL_DIR}/engine/scripts/doctor.mjs。失败时把修复建议转告用户,然后停下。local-fonts 一行显示没装本地字体、而用户网络不稳定(出图报"字体没有加载")时,建议他运行一次 node ${CLAUDE_SKILL_DIR}/scripts/fonts.mjs(约 65 MB,可加 --mirror <主机>):这是下载,要用户同意再跑;之后出图不再联网加载字体。
  2. 定组合:不需要先跟用户确认,除非 pipeline.md 第 2 节说要问。
  3. 依次调用能力:按 pipeline.md 第 3 节调用每个 skill,照它的 SKILL.md 做完、检查通过(✗ 全部修完),再进入下一步。所有能力用同一个工作目录。
  4. 一份改写稿多处用:一稿多发时只改写一次;同一篇已有 content.json 时不要重写,只补新版式需要的字段。
  5. 交付:把每个能力的交付项合在一起说,按产物分组:
    • 每个产物的绝对路径;
    • 走了哪条组合(例如"原文 → 改写 → 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
  1. init:--spec 按用户说的定(cards[:比例] 总结卡片、long 总结长图、wechat 公众号原文排版、wechat-rewrite 公众号总结、full 原文长图、full-cards 原文卡片、video、whiteboard、comic;没说就是 long)。已抓过的链接自动跳过(--refetch 重抓),视频链接记为"待转写",不会让整批失败。用户说了自己打算几点发,才写 --schedule "xhs=周二 20:00";不要替用户编发布时间。
  2. 循环:运行 next → 照它说的做这一步(改写用 article-rewrite,出图用对应能力,检查的 ✗ 修完)→ 再运行 next。一次只做一条内容,做完一条再做下一条;主题没固定时每篇各自按 styles.md 选。
  3. 停下来问用户,不要自己决定:next 末尾列出的"等用户确认"的条目——抓取失败(换链接、粘贴正文,或 skip)、正文偏短或疑似付费墙(看一眼 article.md,确认内容完整才 confirm,否则请用户粘贴正文)。其余条目照常做完,最后一起问,不要让一条坏链接卡住整批。
  4. 收尾: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.md
    
    平台:xhs 小红书、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. 流程

  1. node ${CLAUDE_SKILL_DIR}/scripts/video.mjs doctor 看本机能力(配音、对齐、插画、ffmpeg),按 references/video-guide.md 第 1 节决定要不要问用户(通常不用问)。
  2. 完整读一遍文章,再读 references/video-guide.md,写 <目录>/video/video.json:定调(受众、核心、开场策略)→ 封面 → 每镜口播和画面 → 选音色、选主题(按 ../article2media/references/styles.md)。首句 ≤ 19 字、5 秒内说完;解说最忌急,说不完就删字,不加快语速。用户手里有原视频或音乐文件时,可以在镜头里放片段(clip)、垫背景音乐(music)、换转场(transition),见指南 2.7;都只用本地文件,不下载、不生成。
  3. video.mjs check 修完提示,再 video.mjs make(配音、可选插画、渲染、混音、审片一步完成;配音按句缓存,改口播只重配改动的句子)。
  4. 按指南第 4 节审片:看 contact-sheet.jpg 和检查项,改 video.json 重渲,最多 2 轮。
  5. 按指南第 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. 流程

  1. node ${CLAUDE_SKILL_DIR}/scripts/whiteboard.mjs <目录>/article.md:生成来源清单 whiteboard-source.json(每段一个编号和哈希)。
  2. 完整读一遍文章,读 references/mode-whiteboard.md,写 <目录>/whiteboard.json(论证账本:每段原文必须进入某一步,或写明省略理由)。
  3. whiteboard.mjs <目录>/whiteboard.json --check 通过后,whiteboard.mjs <目录>/whiteboard.json 渲染 → <目录>/whiteboard/whiteboard.png。
  4. 讲概念、机制的内容,按 ../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 不算)

  1. 版面检查:✗(图内溢出、文字截断、元素重叠、图片加载失败)必须修——缩短图内文字、减少项目,或换一种图;⚠「末行只剩一个字」给那句话增减两三个字;⚠「页面过高」删减内容或拆成两页。
  2. 亲眼看图:用 Read 打开每张 PNG,看图能不能一眼看懂、图和图注是不是一回事、有没有哪节太空或太挤。
  3. 只改 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. 核对

  1. 完整读一遍 article.md,对照 transcript/segments.md 的上下文核对人名、作品名、术语。识别明显不对的,用 --prompt / --terms 重跑;拿不准的不要猜,交付时列出来。
  2. 逐字稿只补标点、分段,不改字。不要手工"润色"它——要整理成文章,是改写(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 不算)

  1. 版面检查:✗ 全文校验(逐块不一致)、图片没加载、标题超长、封面标题放不下,都必须修。正文问题改源头(article.md / content.json),不改 HTML。
  2. 亲眼看:打开 cover-2.35x1.png、cover-1x1.png;用浏览器或截图看一遍 article.html 的手机宽度效果。

3. 交付

  • article.html 的绝对路径,告诉用户:"浏览器打开 → 点「复制到公众号」→ 在编辑器正文里粘贴";
  • 贴出标题、摘要,以及两张封面的路径(wechat.md 里有完整发布步骤);
  • 排的是哪篇(原文 / 译文 / 改写稿)、全文校验结果("44 / 44 块逐字一致")、主题和理由;
  • 有图片没能下载、仍是外链的,提醒粘贴后检查。

Sponsors

Details

Marketplace
threerocks/article2media
Category
Community