菜单
把已经完成的中文长文和 5:2 封面可靠写入登录中的 X Articles 后台，保存为可继续编辑的草稿，检查自动保存与预览，并把草稿地址回写到文章所在的本地知识库。用于“把这篇文章放进 X 后台”“保存为 X Article 草稿”“接上 X 长文发布管线”或检查、续写已有 X Article 草稿时。使用当前宿主可用的浏览器或电脑控制能力，不绑定特定 Agent；不得自动点击 Publish，不得用普通 Post 接口冒充 Article，也不得重复创建同题草稿。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
把口播文稿、观点句或一个完整选题做成编辑隐喻拼贴风格的视频（黑白半调剪贴 + 平坦色场 + 从空场逐件组装的定格动画）。两种模式：单句 5 秒 B-roll（单条或批量），以及 beat map 驱动的 45–60 秒完整讲解片（含旁白 TTS、内容感知变速、字幕与拼装）。用户说“拼贴 b-roll”“纸拼贴视频”“vox 那种风格的视频”“半调拼贴动画”“给这句口播配画面”“把这个选题做成拼贴讲解视频”时使用；也承接 ray-writer / ray-cover 产出后的视频化下游需求。不用于：需要精确图层与时间线控制（转 HyperFrames）、只要提示词不要成片、真人口播或产品实拍广告。
把已经定稿的中文长文排成适合手机浏览的微信公众号富文本，生成可复制预览，在用户确认后创建或更新公众号草稿，并回读核对标题、封面、正文、空段落、署名和中文编码。用于“给公众号重新排版”“把这篇推到微信公众号草稿箱”“更新已有微信草稿”“公众号排版太单调或有多余空行”“恢复失败的草稿更新”时。优先更新文章 frontmatter 记录的原草稿，不制造同题重复草稿；未经明确授权只做到预览，不发布文章。
rayskills 工具箱的主入口与路由。当用户不确定该用哪个 ray-* skill、只是丢来一个真实任务/处境，或明确要求把一篇内容从 idea、调研、写作、封面一路送到公众号或 X Articles 草稿箱时，用本 skill 读取上下文，判断最该做的一步或执行已确认的内容生产链。也用于一轮工作完成后决定下一步。触发：/ray 或 /ray 后接任何真实任务描述。用户无需记住具体 skill 名。
把灵感、剪藏审核卡、调研包、长期知识或已有草稿装配成有事实、有情绪、有网感和传播力的中文长文，并接入用户本地 Obsidian 知识库的成稿包、调研、草稿、发布与复盘流程。用于用户说“把这个 idea 写成文章”“从这条资料发展成长文”“写一篇公众号或 X 长文”“检查或重写这篇文章”“把内容生产流水化”时；找不到兼容知识库时先转交 ray-obsidian 建立或适配。不得虚构用户经历、数据、现场或情绪，不自动发布，也不使用 WeWrite。
把已经确定核心判断的文章、成稿包或长文转成公众号、普通 X 分享图与 X Articles 后台封面。提炼一个可一眼读懂的视觉隐喻，在 Ray 的编辑视觉体系中选择复古现代主义、极简隐喻、安静油墨、编辑隐喻拼贴或工具桥接方向，先生成无字底图，再用确定性排版写入准确中文标题，并输出各平台文件、提示词和清单。用于“给这篇文章做封面”“公众号和 X 都要封面”“做 5:2 Article 封面”“用 Adrian 或 Vox 那类风格”“把内容生产接上封面管线”时；不用于正文写作、自动发布或完整解说视频。
在用户本地新建、检查或渐进适配一个面向长期知识与内容生产的 Obsidian 知识库，复用 Ray 的资料、知识、灵感、成稿包、调研、草稿、发布与回流分层。用于“帮我搭一个 Obsidian 知识库”“给 ray-writer 准备本地知识库”“把现有 vault 接入内容生产管线”“检查知识库结构是否完整”时；也在 ray-writer 找不到兼容知识库时使用。只补缺失结构，不覆盖、移动或删除用户已有笔记，不强制安装插件、同步服务或 Git。
| name | ray-x-article |
| description | 把已经完成的中文长文和 5:2 封面可靠写入登录中的 X Articles 后台，保存为可继续编辑的草稿，检查自动保存与预览，并把草稿地址回写到文章所在的本地知识库。用于“把这篇文章放进 X 后台”“保存为 X Article 草稿”“接上 X 长文发布管线”或检查、续写已有 X Article 草稿时。使用当前宿主可用的浏览器或电脑控制能力，不绑定特定 Agent；不得自动点击 Publish，不得用普通 Post 接口冒充 Article，也不得重复创建同题草稿。 |
把 X Articles 当成交付后台，而不是内容源。正文始终以本地 Markdown 为准；浏览器只负责创建或更新草稿、上传封面和验证结果。
ray-writer 检查的完整文章；内容判断不稳定时先退回写作管线。ray-cover，X Article 使用 5:2 成品；16:9 的普通 X 分享图不能直接代替。xurl post，也不把只会读取网页的工具误当成可操作浏览器。Publish。读取完整正文、成稿包和封面清单。运行：
python3 scripts/prepare_article.py --article <文章.md> --cover <x-article-cover.png> --out <临时交付包.json>
脚本负责去掉 frontmatter、生成纯文本与富文本 HTML、检查标题与正文、确认长文有二级标题和重点加粗、拒绝连续空行、确认封面接近 5:2，并输出编辑器应有的块数、标题数、加粗数、首尾锚点与指纹。检查失败就退回 ray-writer 或 ray-cover 修正，不绕过。
先阅读 browser-capability.md，选择当前宿主中能控制登录态浏览器、上传本地文件并检查可见页面的能力。再阅读 x-editor-contract.md，按照已验证的可见文字定位编辑器。
先读取文章 frontmatter：
x_article_draft_url 时，直接打开该 URL，核对标题后更新原草稿。draft-needs-cover 时，只补封面并重新验证；不要重写正文或建立第二份草稿。draft、但用户提到过去失败时，以当前后台可见状态为准：先核验原草稿，封面确实缺失才补传，不能按旧叙述直接覆盖。https://x.com/compose/articles，并确认页面存在 Articles、Drafts、Published，当前账号已登录且有 Write 入口；再检查 Drafts 中是否有同名文章，有则打开原草稿，不新建。只有完成重复检查后才进入 Write。进入编辑页会立即生成空白草稿，因此后续失败时要么保留并记录地址以便恢复，要么确认它仍是纯空白后删除。遇到权限失败、断线或旧草稿恢复时读取 recovery-runbook.md。
按以下顺序执行：
Choose File 上传交付包中的 5:2 封面；出现 Edit media 后点击 Apply，再以封面实际显示和 Remove photo 出现作为上传成功信号。Add a title 填入标题，逐字核对。body_html 作为 HTML、body 作为纯文本同时写入浏览器剪贴板，在正文 textbox 全选后粘贴。这样让编辑器直接生成正常段落、标题、列表、链接和加粗，不插入空白段落。Last saved just now 或等价的已保存状态。浏览器控制能力拒绝读取本地封面时，不要继续尝试绕过权限，也不要创建新草稿。记录 draft-needs-cover 和当前 URL，请用户开启对应宿主或浏览器的本地文件访问权限；收到确认后从原 URL 续传。
填入正文后不要进入 Publish 流程。
完成以下检查：
Preview 后，标题、段落、封面和作者信息都正常。预览检查完回到编辑页，再确认封面仍在、正文格式未变、保存时间已经更新。若检查不通过，修正后重新验证；不要把问题草稿交给用户自行排查。
验证通过后运行：
python3 scripts/record_draft.py --article <文章.md> --url <草稿地址> --cover <x-article-cover.png> --content-sha256 <交付包中的指纹>
它会在文章 frontmatter 中记录：
x_article_status: draftx_article_draft_urlx_article_saved_atx_article_coverx_article_content_sha256浏览器权限等外部原因导致封面尚未上传时，先使用 --status draft-needs-cover 记录可恢复状态；补齐并验证封面后必须重新记录为 draft。
本地文章仍留在 10-创作/20-草稿/。只有用户实际发布并确认后，才复制或移动到 40-发布/10-X长文/，并把状态改为 published。
向用户提供本地文章、5:2 封面和 X 草稿链接。只说明已经保存并验证、是否存在需要人工复核的格式；明确说明没有发布。