菜单
在用户本地新建、检查或渐进适配一个面向长期知识与内容生产的 Obsidian 知识库，复用 Ray 的资料、知识、候选选题、写作任务、调研、文章与口播母稿、发布反馈和知识回流分层。用于“帮我搭一个 Obsidian 知识库”“给 ray-writer 准备本地知识库”“把现有 vault 接入内容生产管线”“检查知识库结构是否完整”时；也在 ray-writer 找不到兼容知识库时使用。只补缺失结构，不覆盖、移动或删除用户已有笔记，不强制安装插件、同步服务或 Git。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/imraywang/rayskills --skill ray-obsidian命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
把灵感、剪藏审核卡、调研包或已有草稿装配成有事实、有情绪、有网感和传播力的中文长文，接入本地 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，也不得重复创建同题草稿。
把口播文稿、观点句或一个完整选题做成编辑隐喻拼贴风格的视频（黑白半调剪贴 + 平坦色场 + 从空场逐件组装的定格动画）。两种模式：单句 5 秒 B-roll（单条或批量），以及 beat map 驱动的 45–60 秒完整讲解片（含旁白 TTS、内容感知变速、字幕与拼装）。用户说“拼贴 b-roll”“纸拼贴视频”“vox 那种风格的视频”“半调拼贴动画”“给这句口播配画面”“把这个选题做成拼贴讲解视频”时使用；也承接 ray-kb / ray-writer / ray-cover 产出后的视频化下游需求。不用于：需要精确图层与时间线控制（转 HyperFrames）、只要提示词不要成片、真人口播或产品实拍广告。
| name | ray-obsidian |
| description | 在用户本地新建、检查或渐进适配一个面向长期知识与内容生产的 Obsidian 知识库，复用 Ray 的资料、知识、候选选题、写作任务、调研、文章与口播母稿、发布反馈和知识回流分层。用于“帮我搭一个 Obsidian 知识库”“给 ray-writer 准备本地知识库”“把现有 vault 接入内容生产管线”“检查知识库结构是否完整”时；也在 ray-writer 找不到兼容知识库时使用。只补缺失结构，不覆盖、移动或删除用户已有笔记，不强制安装插件、同步服务或 Git。 |
把内容生产的地基装进用户自己的本地目录。先确定知识库根目录，再审计、初始化和复核；已有库只做增量补齐。
rays-brain，也不假设知识库位于 iCloud、用户主目录或当前项目。.obsidian/，不强制插件、同步服务、Git 或特定云盘。Obsidian 只是编辑器，普通 Markdown 工具同样能使用这套结构。按以下顺序定位：
.ray-obsidian.json。10-创作/、20-知识/、30-资料/、50-系统/ 的兼容知识库。路径确定后先报告绝对路径。不要把一个普通项目目录误当知识库，也不要因为目录名含 brain、notes 或 vault 就直接写入。
使用 Skill 加载时报告的根目录运行：
python3 <skill-base>/scripts/vault_setup.py check --vault <知识库目录>
检查结果为 ready 时直接交付；为 incomplete 或 missing 时，阅读 vault-schema.md，向用户简要说明将新增哪些目录和模板。已知的 ray-content-v1 会标记为可升级，按增量初始化补齐现行结构；未知版本仍然停止。
对已有 Obsidian 库，额外阅读 migration.md。只做兼容层增量初始化，不整理旧笔记。
先预演：
python3 <skill-base>/scripts/vault_setup.py init --vault <知识库目录> --name <知识库名称> --dry-run
确认目标没有跑偏后执行：
python3 <skill-base>/scripts/vault_setup.py init --vault <知识库目录> --name <知识库名称>
脚本只会：
assets/vault-template/ 复制缺失的说明、流程和模板。.ray-obsidian.json 供其他 Ray Skill 发现结构版本。preserved。出现同名文件时以用户文件为准。已知的 ray-content-v1 只升级 manifest、补齐缺失结构并保留全部旧目录和文件；若现有 manifest 无法解析或声明了未知结构版本，停止并报告，不覆盖修复。
初始化后重新执行 check，并实际读取：
HOME.md00-入口/10-工作台/知识工作台.md00-入口/10-工作台/创作工作台.md50-系统/30-模板/内容成稿包.md50-系统/20-流程/个人知识库工作流.md完成状态必须是 ready，且脚本报告没有覆盖文件。用户只要求检查时不得借机初始化。
向用户交付知识库绝对路径，并说明三个最小入口：
30-资料/，自己的即时想法进入 10-创作/10-灵感/inbox.md。10-创作/10-灵感/20-候选选题/；确认本次角度后，才在 10-创作/20-写作任务/ 建立成稿包。10-创作/30-文章草稿/；直接以口播起稿的母稿进入 10-创作/20-口播草稿/；确认发布后才进入 40-发布/，并在 40-发布/00-内容反馈/ 复盘。用户接着要求写文章时，把知识库根目录、材料路径和目标平台交给 ray-writer。不要复制整套知识库到 Skill 目录，也不要把用户笔记吸收成 Skill 样本。
ready。