# Cyxj Transcript

> 把视频/录音的逐字稿整理成结构化文章草稿。去口语化、加小标题分段、 数据用表格整理，原始逐字稿保留在文末备查，产出 Obsidian Markdown， 可直接接 cyxj-wechat-pub（公众号）或 cyxj-blog-pub（博客）排版。 触发词：转稿、逐字稿整理、把这个稿子整理成文章、逐字稿转文章、口播稿成文。

- Skill: `chenyuxiaojin/cyxj-transcript` (Agent Skill)
- Install (CLI): `npx skillmds@latest add chenyuxiaojin/cyxj-transcript`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chenyuxiaojin/cyxj-transcript/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: chenyuxiaojin (https://skillmd.com/u/chenyuxiaojin)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chenyuxiaojin/cyxj-transcript

---


# cyxj-transcript — 逐字稿转文章

把第一手逐字稿（视频口播、录音转写、直播逐字）整理成能读的文章草稿。
这是上游：产出干净的文章 Markdown，下游再交给排版 skill。

## 何时用

- 用户给一段逐字稿/口播稿，说「整理成文章」「转个稿」
- 素材通常在 `$CYXJ_VAULT_BASE/待发布/`（未设置 `CYXJ_VAULT_BASE` 时按 `~/obsidian/灵感库` 兜底，并向用户确认），找不到就问用户路径

**不适用**：已经是成文文章（直接走排版 skill）；纯做选题/大纲（走选题 skill）。

## 转稿规则（硬约束，来自内容创作 CLAUDE.md「转稿规则」；规则已完整内联，无需读原文件）

1. **逐字稿是第一手素材，优先级高于大纲和录制手册**——以实际说出来的内容为准。
2. **去口语化**：删掉视频专属表达——「我们来看一下」「对吧」「这个」「然后呢」「接下来」「那么」等口头禅、语气词、重复啰嗦。
3. **加结构**：用小标题分段；**数据/对比/参数用表格整理**，不要堆在正文里。
4. **保留原稿**：原始逐字稿**原样放到文末**「## 原始逐字稿（备查）」段落，不删。
5. **不抖机灵**：按「事实→机制→洞察」三段推进，数字给精度，不做段子手式抒情（用户写作偏好）。
6. **避开「不是…而是…」对照式句式**（用户明确不喜欢）。

## 改写示例（尺度参考）

**Before（口播原文）**：
> 我们来看一下这个数据啊，就是说 Claude 它这个月的下载量呢，是涨了差不多三倍，对吧，这个增速其实是很吓人的，然后呢它的付费用户也在涨。

**After（成文）**：
> Claude 本月下载量增长约 3 倍，付费用户同步上涨。这个增速很吓人。

去掉「我们来看一下」「就是说」「对吧」「然后呢」等口水，但「这个增速很吓人」这类有态度的金句原样保留。

## 工作流

1. **拿到逐字稿**：Read 路径，或用 obsidian CLI 在 `$CYXJ_VAULT_BASE/待发布/` 搜（CLI 不存在则用 Grep/Glob 直接搜文件）。
2. **通读定主线**：先判断这篇在讲什么、核心论点是什么、有哪些可成段的部分。
3. **起草**：
   - 拟一个说人话的标题（讲中心思想，不堆符号）
   - 按主题切小标题，去口语化重写每段
   - 把散落的数字/步骤/对比抽成表格
   - 保留作者原话里有信息量的金句，删无信息量的口水
4. **附原稿**：文末加 `## 原始逐字稿（备查）` + 原文。
5. **存稿**：默认写回 `$CYXJ_VAULT_BASE/待发布/<标题>.md`（Obsidian），动手前确认文件名和落点。
6. **交接**：告诉用户「草稿好了，要发公众号就 `/cyxj-wechat-pub`，发博客就 `/cyxj-blog-pub`」。

## 产出结构（模板）

```markdown
# <说人话的标题>

<导语：一两句说清这篇讲什么、为什么值得看>

## <小标题 1>
<去口语化的正文>

| <表头> | <表头> |
|--------|--------|
| ...    | ...    |

## <小标题 2>
...

---

## 原始逐字稿（备查）

<原文逐字稿，原样保留>
```

## 错误分支

- 输入是 SRT 文件 → 提示改用 cyxj-subfix 的 `--export-md` 先转成纯文本再来。
- 逐字稿超过约 1 万字 → 分段处理再合并，不要一次吞。
- 目标文件已存在 → 停下向用户确认是否覆盖。

## 收尾

- 不臆造逐字稿里没有的事实/数字。原稿没说的不补。
- 拿不准的事实，提示用户「这条建议发稿前用 fact-checker 核一下」。
- 只产出草稿，**不做排版、不发布**——那是下游 skill 的事：发公众号走 `cyxj-wechat-pub`，发博客走 `cyxj-blog-pub`。产出草稿后用一句话提示用户这两个去向。