| name | cyxj-transcript |
| description | 把视频/录音的逐字稿整理成结构化文章草稿。去口语化、加小标题分段、 数据用表格整理,原始逐字稿保留在文末备查,产出 Obsidian Markdown, 可直接接 cyxj-wechat-pub(公众号)或 cyxj-blog-pub(博客)排版。 触发词:转稿、逐字稿整理、把这个稿子整理成文章、逐字稿转文章、口播稿成文。
|
| version | 1.0.0 |
cyxj-transcript — 逐字稿转文章
把第一手逐字稿(视频口播、录音转写、直播逐字)整理成能读的文章草稿。
这是上游:产出干净的文章 Markdown,下游再交给排版 skill。
何时用
- 用户给一段逐字稿/口播稿,说「整理成文章」「转个稿」
- 素材通常在
$CYXJ_VAULT_BASE/待发布/(未设置 CYXJ_VAULT_BASE 时按 ~/obsidian/灵感库 兜底,并向用户确认),找不到就问用户路径
不适用:已经是成文文章(直接走排版 skill);纯做选题/大纲(走选题 skill)。
转稿规则(硬约束,来自内容创作 CLAUDE.md「转稿规则」;规则已完整内联,无需读原文件)
- 逐字稿是第一手素材,优先级高于大纲和录制手册——以实际说出来的内容为准。
- 去口语化:删掉视频专属表达——「我们来看一下」「对吧」「这个」「然后呢」「接下来」「那么」等口头禅、语气词、重复啰嗦。
- 加结构:用小标题分段;数据/对比/参数用表格整理,不要堆在正文里。
- 保留原稿:原始逐字稿原样放到文末「## 原始逐字稿(备查)」段落,不删。
- 不抖机灵:按「事实→机制→洞察」三段推进,数字给精度,不做段子手式抒情(用户写作偏好)。
- 避开「不是…而是…」对照式句式(用户明确不喜欢)。
改写示例(尺度参考)
Before(口播原文):
我们来看一下这个数据啊,就是说 Claude 它这个月的下载量呢,是涨了差不多三倍,对吧,这个增速其实是很吓人的,然后呢它的付费用户也在涨。
After(成文):
Claude 本月下载量增长约 3 倍,付费用户同步上涨。这个增速很吓人。
去掉「我们来看一下」「就是说」「对吧」「然后呢」等口水,但「这个增速很吓人」这类有态度的金句原样保留。
工作流
- 拿到逐字稿:Read 路径,或用 obsidian CLI 在
$CYXJ_VAULT_BASE/待发布/ 搜(CLI 不存在则用 Grep/Glob 直接搜文件)。
- 通读定主线:先判断这篇在讲什么、核心论点是什么、有哪些可成段的部分。
- 起草:
- 拟一个说人话的标题(讲中心思想,不堆符号)
- 按主题切小标题,去口语化重写每段
- 把散落的数字/步骤/对比抽成表格
- 保留作者原话里有信息量的金句,删无信息量的口水
- 附原稿:文末加
## 原始逐字稿(备查) + 原文。
- 存稿:默认写回
$CYXJ_VAULT_BASE/待发布/<标题>.md(Obsidian),动手前确认文件名和落点。
- 交接:告诉用户「草稿好了,要发公众号就
/cyxj-wechat-pub,发博客就 /cyxj-blog-pub」。
产出结构(模板)
# <说人话的标题>
<导语:一两句说清这篇讲什么、为什么值得看>
## <小标题 1>
<去口语化的正文>
| <表头> | <表头> |
|--------|--------|
| ... | ... |
## <小标题 2>
...
---
## 原始逐字稿(备查)
<原文逐字稿,原样保留>
错误分支
- 输入是 SRT 文件 → 提示改用 cyxj-subfix 的
--export-md 先转成纯文本再来。
- 逐字稿超过约 1 万字 → 分段处理再合并,不要一次吞。
- 目标文件已存在 → 停下向用户确认是否覆盖。
收尾
- 不臆造逐字稿里没有的事实/数字。原稿没说的不补。
- 拿不准的事实,提示用户「这条建议发稿前用 fact-checker 核一下」。
- 只产出草稿,不做排版、不发布——那是下游 skill 的事:发公众号走
cyxj-wechat-pub,发博客走 cyxj-blog-pub。产出草稿后用一句话提示用户这两个去向。