菜单
把已核验的定稿长文重新选角度，改编成可直接录制的口播内容包：选题卡、三个开场、可直接念的逐字稿、拍摄节奏、素材清单和录前核对，绑定母稿路径与内容指纹并通过脚本校验。用于“把这篇文章改成口播稿”“从长文提炼口播选题”“做成 2–3 分钟口播视频”“一次素材多次分发”时。母稿是事实与判断的唯一真源，不自行增加事实；写长文或修改母稿转 ray-writer，拼贴 B-roll 转 ray-broll；不自动发布。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/imraywang/rayskills --skill ray-kb命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
在用户本地新建、检查或渐进适配一个面向长期知识与内容生产的 Obsidian 知识库，复用 Ray 的资料、知识、候选选题、写作任务、调研、文章与口播母稿、发布反馈和知识回流分层。用于“帮我搭一个 Obsidian 知识库”“给 ray-writer 准备本地知识库”“把现有 vault 接入内容生产管线”“检查知识库结构是否完整”时；也在 ray-writer 找不到兼容知识库时使用。只补缺失结构，不覆盖、移动或删除用户已有笔记，不强制安装插件、同步服务或 Git。
把灵感、剪藏审核卡、调研包或已有草稿装配成有事实、有情绪、有网感和传播力的中文长文，接入本地 Obsidian 知识库的成稿、发布与复盘流程；也把外文/他人文章做成带授权署名的译介稿。用于“把这个 idea 写成文章”“写一篇公众号或 X 长文”“检查或重写这篇文章”“翻译/转载这篇文章”时。找不到兼容知识库先转交 ray-obsidian；定稿改口播稿转交 ray-kb；不虚构用户经历，不自动发布，也不使用 WeWrite。
把已经完成的中文长文和 5:2 封面可靠写入登录中的 X Articles 后台，保存为可继续编辑的草稿，检查自动保存与预览，并把草稿地址回写到文章所在的本地知识库。用于“把这篇文章放进 X 后台”“保存为 X Article 草稿”“接上 X 长文发布管线”“推送到 X”或检查、续写已有 X Article 草稿时；这些说法在本 Skill 中都只代表草稿交付；“推送到 X”这类模糊说法先做完本地交付包，再用一句话确认是否写入草稿箱。使用当前宿主可用的浏览器或电脑控制能力，不绑定特定 Agent；本 Skill 不点击 Publish，不得用普通 Post 接口冒充 Article，也不得重复创建同题草稿。
| name | ray-kb |
| description | 把已核验的定稿长文重新选角度，改编成可直接录制的口播内容包：选题卡、三个开场、可直接念的逐字稿、拍摄节奏、素材清单和录前核对，绑定母稿路径与内容指纹并通过脚本校验。用于“把这篇文章改成口播稿”“从长文提炼口播选题”“做成 2–3 分钟口播视频”“一次素材多次分发”时。母稿是事实与判断的唯一真源，不自行增加事实；写长文或修改母稿转 ray-writer，拼贴 B-roll 转 ray-broll；不自动发布。 |
把已经核验的图文母稿改编成可直接录制的口播内容包。改编不是缩写：不要试图把长文每一段都塞进口播；从母稿中只选一个最适合视频的判断，重新安排问题、证据、节奏和结尾动作。
source_draft 与 source_sha256，不能自行增加事实、经历或效果数字；母稿变化后先重新核对，再改口播。ray-writer。改编中发现母稿事实有问题时停下来交回，不在口播稿里就地修事实。只接收 kind: draft、kind: article 或已经发布的完整正文。收到 content-pack、调研或审核卡时，沿 frontmatter 的 draft 链接找到母稿；找不到就停止并说明缺口，不把任务说明当文章。
知识库根目录不写死：优先使用用户明确路径，再向上查找 .ray-obsidian.json 或兼容目录结构。找不到兼容知识库、用户只要一次性口播稿时，可在当前工作区交付内容包，并说明这次没有进入知识回流；需要长期管线时先转交 ray-obsidian。
读取母稿、成稿包和事实清单，确认：
从母稿提取最多三个候选，每个候选写清：目标观众、一个中心判断、开场冲突、最强证据、能拍出来的画面，以及删掉后会失去什么。
选择标准按顺序执行：
用户未指定时长时，默认做 2–3 分钟、真人出镜加录屏或截图的混合口播。60–90 秒只保留一个反转和一个动作；5 分钟以上的教程必须把演示步骤与口播解释分层。
采用这条推进线：
判断或冲突 → 观众熟悉的挫败 → 事实或真实演示 → 再判断 → 一个动作
写作时遵守：
从长文改出的衍生稿与母稿一起放在 <vault>/10-创作/30-文章草稿/，文件名增加 -口播稿；以口播起稿、没有图文母稿的内容才放 <vault>/10-创作/20-口播草稿/，它自己就是母稿。衍生稿不是第二份母稿，frontmatter 至少包含：
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
正文固定包含：
## 选题卡：观众、原有认知、中心判断、证据、主目标和唯一动作。## 三个开场：反直觉、变化结果和具体场景各一个，明确最终采用项。## 逐字稿：只放能直接念的文字，不混入括号提示、表格或镜头说明。## 拍摄节奏：时间、口播关键词、画面、字幕重点和素材状态。## 素材清单：已有、待录、待做、可删除四种状态。## 图片长文接口：只记录视觉命题、建议页数和母稿来源，默认状态为 not-started。## 来源与录前核对：原始链接、易变信息和录前检查项。本轮不把图片长文做成完整生产流程，只保留三个稳定输入：
后续建立独立视觉能力时，从这三个输入开始，不重新从长文猜判断，也不复制第三方公众号的可识别排版。
完成后运行：
python3 scripts/oral_script_check.py <口播稿.md> --source <母稿.md>
检查失败就修改并重跑。脚本通过只证明结构、来源指纹和估算时长成立，仍要人工确认只有一个中心判断、画面能证明口播、结尾只有一个动作，并完整朗读一次；无法真实朗读时，必须明确时长只是字数估算，不能冒充录制时长已经实测。
需要做画面时，把口播稿路径、中心判断、拍摄节奏和素材清单交给 ray-broll；它只补适合的视觉隐喻或讲解片，不反向修改事实和口播判断。真人出镜与录屏由拍摄计划承担。
向用户交付母稿路径、口播内容包、估算时长和录前核对项，并明确是否完成真实朗读；简要说明选了哪个角度、放弃了哪些候选。不把内部检查过程写成长报告。