메뉴
在用户本地新建、检查或渐进适配一个面向长期知识与内容生产的 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。