视频转文章 Skill
将 YouTube 视频的字幕/转录文本提取出来,根据目标平台的调性改写成文章,输出为 Markdown 文件。
使用方式
/video-to-article <YouTube链接> [平台名]
平台名可选:公众号(默认)、博客、推特、即刻
也可以一次生成多平台版本:
/video-to-article <YouTube链接> 公众号+博客
输出位置
默认输出为当前目录下的 Markdown 文件,文件名格式:[平台]-文章标题.md
如果你使用 Notion,可以自行配置 Notion MCP 并修改步骤 6 将输出写入 Notion 数据库。
执行流程
步骤 1:提取转录文本
运行脚本获取视频字幕:
python3 ~/.claude/skills/video-to-article/scripts/fetch_transcript.py "<YouTube链接>" --format json
脚本会:
- 提取 video ID
- 用 youtube-transcript-api 抓字幕(优先中文,fallback 英文)
- 用 yt-dlp 获取视频元信息(标题、频道、时长等)
- 输出 JSON 格式(含 segments + metadata)
如果脚本失败(无字幕的视频),用 yt-dlp 尝试下载自动字幕:
yt-dlp --write-auto-sub --sub-lang "zh-Hans,en" --skip-download --sub-format vtt -o "/tmp/yt-sub" "<YouTube链接>"
依赖安装:
pip install youtube-transcript-api yt-dlp
步骤 2:分析内容
从转录文本中提取:
- 核心主题和关键观点
- 内容结构(是教程?评测?分享?讨论?)
- 关键数据和事实
- 精彩引用
步骤 3:补充信息(可选)
如果视频涉及特定产品/技术/事件,用 WebSearch 补充:
- 官方信息和数据
- 背景知识
- 最新进展
搜索量控制:1-2 次即可,不要过度搜索。
步骤 4:翻译(如需)
如果视频语言不是中文:
- 先理解全文含义
- 用地道中文重新表达,不要翻译腔
- 专业术语保留英文或附注英文原文
- 人名、地名、产品名保留英文
步骤 5:按平台调性改写
根据目标平台风格改写文章。核心原则:这是改写/重新创作,不是翻译或搬运。要用自己的视角重新组织内容。
公众号(默认)
- 字数:1000-3000 字
- 风格:深度解读,有个人观点和视角
- 结构:
- 开头切入(一两句话说清楚这个视频讲了什么,为什么值得看)
- 核心内容展开(按主题重新组织,不是按视频时间线)
- 个人点评和延伸思考
- 原视频链接
- 语感:
- 短句为主,节奏快
- 用"我"的视角:我觉得、我注意到、我的理解是
- 说人话,不要学术腔
- 可以加入自己的经验和思考
- 禁止:
- 不用"首先""其次""最后"
- 不用"不是…而是…"
- 不替读者总结意义
- 不用标题党词汇(炸裂、颠覆、吊打)
博客
- 字数:1500-5000 字
- 风格:结构化、技术向、可以更深入
- 结构:
- 标题(SEO 友好)
- 一段话摘要
- 目录/关键要点
- 正文(按主题分节,带小标题)
- 总结
- 原视频链接
- 语感:
- 可以稍微正式一些,但不要太学术
- 代码/命令/工具名用行内代码格式
- 适合加列表、表格等结构化元素
推特/X
- 字数:单条 280 字符内(约 140 中文字),或 thread 3-7 条
- 风格:精炼、有信息量、吸引互动
- 结构(Thread):
- Hook:一句话抓注意力
- 核心观点展开(每条讲一个点)
- 最后一条:总结 + 原视频链接
- 语感:
- 直接、口语化
- 每条推特独立成句,自成一体
- 中文为主,术语保留英文
即刻
- 字数:200-800 字
- 风格:轻松、像跟朋友分享
- 结构:
- 一句话推荐/引出
- 2-3 个核心要点
- 个人感想
- 原视频链接
- 语感:
- 最口语化
- 可以用"哈哈""嗯""挺好的"这种语气词
- 像在即刻动态里随手分享
步骤 6:输出文件
将文章保存为 Markdown 文件,内容结构:
[改写后的文章正文]
---
## 原视频信息
标题:[视频原标题]
频道:[频道名]
时长:[XX分XX秒]
链接:[YouTube URL]
## 平台
[目标平台名称]
如果一次生成多个平台版本,每个版本保存为独立文件。
步骤 7:告知用户
输出:
- 文件保存路径
- 文章字数
- 原视频基本信息(标题、时长、语言)
- 是否做了翻译
- 提醒用户审核内容
质量检查
输出前自检:
- 内容准确,没有杜撰视频中没有的信息
- 是改写重组,不是逐句翻译/搬运
- 有个人视角和观点
- 语感符合目标平台
- 字数在目标范围内
- 文末带原视频链接