# Ray Kb

> 把已核验的定稿长文重新选角度，改编成可直接录制的口播内容包：选题卡、三个开场、可直接念的逐字稿、拍摄节奏、素材清单和录前核对，绑定母稿路径与内容指纹并通过脚本校验。用于“把这篇文章改成口播稿”“从长文提炼口播选题”“做成 2–3 分钟口播视频”“一次素材多次分发”时。母稿是事实与判断的唯一真源，不自行增加事实；写长文或修改母稿转 ray-writer，拼贴 B-roll 转 ray-broll；不自动发布。

- Skill: `imraywang/ray-kb` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add imraywang/ray-kb`
- Raw SKILL.md: https://api.skillmd.com/api/skills/imraywang/ray-kb/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: imraywang (https://skillmd.com/u/imraywang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/imraywang/ray-kb

---


# Ray KB（口播再分发）

把已经核验的图文母稿改编成可直接录制的口播内容包。改编不是缩写：不要试图把长文每一段都塞进口播；从母稿中只选一个最适合视频的判断，重新安排问题、证据、节奏和结尾动作。

## 固定原则

1. 母稿是事实、判断和来源的唯一真源。衍生稿必须记录 `source_draft` 与 `source_sha256`，不能自行增加事实、经历或效果数字；母稿变化后先重新核对，再改口播。
2. 不写“亲测”“实测”或具体效果，除非母稿和事实清单能证明用户真的做过。来源作者的实践保持归属，不改写成 Ray 的第一人称。
3. 一份口播稿只承载一个中心判断，只保留一个结尾动作。
4. 母稿的写作与修改属于 `ray-writer`。改编中发现母稿事实有问题时停下来交回，不在口播稿里就地修事实。
5. 不自动发布。未经用户明确要求，不生成图片卡片成品，不调用付费视频或图片生成。

## 输入门

只接收 `kind: draft`、`kind: article` 或已经发布的完整正文。收到 `content-pack`、调研或审核卡时，沿 frontmatter 的 `draft` 链接找到母稿；找不到就停止并说明缺口，不把任务说明当文章。

知识库根目录不写死：优先使用用户明确路径，再向上查找 `.ray-obsidian.json` 或兼容目录结构。找不到兼容知识库、用户只要一次性口播稿时，可在当前工作区交付内容包，并说明这次没有进入知识回流；需要长期管线时先转交 `ray-obsidian`。

读取母稿、成稿包和事实清单，确认：

1. 哪些是已核对事实。
2. 哪些是来源作者的观点。
3. 哪些是 Ray 愿意署名承担的判断。
4. 哪些个人经历已被用户确认可以使用。
5. 哪些数字、产品状态和限制需要录制前再核对。

## 先选视频角度

从母稿提取最多三个候选，每个候选写清：目标观众、一个中心判断、开场冲突、最强证据、能拍出来的画面，以及删掉后会失去什么。

选择标准按顺序执行：

1. 脱离工具名后，判断仍然成立。
2. 现有事实足以支撑，不需要编故事。
3. 前 8–10 秒能出现变化、矛盾或反直觉判断。
4. 中段有一个能被截图、录屏或真实操作证明的重心。
5. 结尾能给一个低摩擦动作。

用户未指定时长时，默认做 2–3 分钟、真人出镜加录屏或截图的混合口播。60–90 秒只保留一个反转和一个动作；5 分钟以上的教程必须把演示步骤与口播解释分层。

## 重写为口播

采用这条推进线：

```text
判断或冲突 → 观众熟悉的挫败 → 事实或真实演示 → 再判断 → 一个动作
```

写作时遵守：

- 第一句直接给判断、变化或冲突，不从背景和自我介绍开始。
- 一段只说一个动作；一句超过约 45 个汉字时优先拆开。
- 关键判断单独成句。连续三个术语时，插入人话解释、类比或画面。
- 口播只放观众必须听懂的内容。完整链接、命令、数字口径和补充步骤放在来源与说明栏。
- 画面必须证明一句口播，不能只做装饰。每个镜头标为 A-roll、录屏、截图、字卡或后续 B-roll。
- 只保留一个结尾动作。不要同时要求点赞、关注、评论、转发、进群和买课。

## 口播语气

- 像一个做过事情、愿意给出判断的人对朋友讲话：平视观众，不装导师，不念稿。
- 技术名词要落回真实动作、结果或代价；网感来自观众熟悉的场景和口语节奏，不靠热梗、感叹号和表情。
- 情绪来自主题的真实矛盾，可以用反问、停顿、短句和局部加速；不虚构愤怒、震惊、眼泪或现场对话。
- 删除署名后，观众仍能听出这是 Ray 的判断，而不是一段通用 AI 解说。

## 输出文件

从长文改出的衍生稿与母稿一起放在 `<vault>/10-创作/30-文章草稿/`，文件名增加 `-口播稿`；以口播起稿、没有图文母稿的内容才放 `<vault>/10-创作/20-口播草稿/`，它自己就是母稿。衍生稿不是第二份母稿，frontmatter 至少包含：

```yaml
kind: oral-script
status: ready-to-record
source_draft: "[[母稿文件名]]"
source_sha256: "母稿完整文件的 sha256"
content_pack: "[[对应成稿包]]"
target_platform: "视频号 / 抖音 / B站"
target_duration_seconds: 150
video_format: "A-roll + 屏幕录制"
central_judgment: "观众看完只记住的一句话"
image_card_status: not-started
```

正文固定包含：

1. `## 选题卡`：观众、原有认知、中心判断、证据、主目标和唯一动作。
2. `## 三个开场`：反直觉、变化结果和具体场景各一个，明确最终采用项。
3. `## 逐字稿`：只放能直接念的文字，不混入括号提示、表格或镜头说明。
4. `## 拍摄节奏`：时间、口播关键词、画面、字幕重点和素材状态。
5. `## 素材清单`：已有、待录、待做、可删除四种状态。
6. `## 图片长文接口`：只记录视觉命题、建议页数和母稿来源，默认状态为 `not-started`。
7. `## 来源与录前核对`：原始链接、易变信息和录前检查项。

## 图片长文接口

本轮不把图片长文做成完整生产流程，只保留三个稳定输入：

- 一句话视觉命题。
- 6–10 页建议叙事顺序。
- 母稿路径、内容指纹与允许使用的图片来源。

后续建立独立视觉能力时，从这三个输入开始，不重新从长文猜判断，也不复制第三方公众号的可识别排版。

## 验证与交接

完成后运行：

```bash
python3 scripts/oral_script_check.py <口播稿.md> --source <母稿.md>
```

检查失败就修改并重跑。脚本通过只证明结构、来源指纹和估算时长成立，仍要人工确认只有一个中心判断、画面能证明口播、结尾只有一个动作，并完整朗读一次；无法真实朗读时，必须明确时长只是字数估算，不能冒充录制时长已经实测。

需要做画面时，把口播稿路径、中心判断、拍摄节奏和素材清单交给 `ray-broll`；它只补适合的视觉隐喻或讲解片，不反向修改事实和口播判断。真人出镜与录屏由拍摄计划承担。

## 交付要求

向用户交付母稿路径、口播内容包、估算时长和录前核对项，并明确是否完成真实朗读；简要说明选了哪个角度、放弃了哪些候选。不把内部检查过程写成长报告。