菜单
把已经定稿的中文长文排成适合手机浏览的微信公众号富文本，生成可复制预览，在用户确认后创建或更新公众号草稿，并回读核对标题、封面、正文、空段落、署名和中文编码。用于“给公众号重新排版”“把这篇推到微信公众号草稿箱”“更新已有微信草稿”“公众号排版太单调或有多余空行”“恢复失败的草稿更新”时。优先更新文章 frontmatter 记录的原草稿，不制造同题重复草稿；未经明确授权只做到预览，不发布文章。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
把口播文稿、观点句或一个完整选题做成编辑隐喻拼贴风格的视频（黑白半调剪贴 + 平坦色场 + 从空场逐件组装的定格动画）。两种模式：单句 5 秒 B-roll（单条或批量），以及 beat map 驱动的 45–60 秒完整讲解片（含旁白 TTS、内容感知变速、字幕与拼装）。用户说“拼贴 b-roll”“纸拼贴视频”“vox 那种风格的视频”“半调拼贴动画”“给这句口播配画面”“把这个选题做成拼贴讲解视频”时使用；也承接 ray-writer / ray-cover 产出后的视频化下游需求。不用于：需要精确图层与时间线控制（转 HyperFrames）、只要提示词不要成片、真人口播或产品实拍广告。
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。
生成长文 / 深度报告 / 数据型内容,三格式协同产出——交互式 HTML(magazine 杂志排版,含 Tab/Quiz/Chart.js/Timeline 组件)、A4 PDF(headless Chrome 渲染)、公众号 markdown(长句叙事)。采用精修的编辑设计语言(衬线中文标题、锈红点缀、纸张颗粒、drop cap、装饰分隔、等宽数字),读起来像真正的杂志文章而非 SaaS dashboard。当用户要做长篇分析、白皮书、深度报告、多段数据型长文,或说「做一个报告」「深度分析」「长文章」「报告版」「PDF 报告」「html version」「pdf report」,或丢来一份提纲期待成品时使用;格式没点名也默认走 HTML,再 offer PDF+公众号。不用于短文、dashboard、UI 组件、或公众号自动发布流程(那用 wewrite)。触发 /ray-report
| name | ray-wechat |
| description | 把已经定稿的中文长文排成适合手机浏览的微信公众号富文本，生成可复制预览，在用户确认后创建或更新公众号草稿，并回读核对标题、封面、正文、空段落、署名和中文编码。用于“给公众号重新排版”“把这篇推到微信公众号草稿箱”“更新已有微信草稿”“公众号排版太单调或有多余空行”“恢复失败的草稿更新”时。优先更新文章 frontmatter 记录的原草稿，不制造同题重复草稿；未经明确授权只做到预览，不发布文章。 |
把公众号交付拆成两个门：先确认本地排版，再修改线上草稿。排版完成不等于草稿已保存；接口返回成功也不等于中文、封面和正文正确。
ray-writer 检查的定稿。知识库中的 content-pack 是写作任务说明，不是正文；事实、判断或文章结构仍在变化时先退回写作阶段。ray-cover。公众号封面与 X Article 封面分别使用，不拉伸代替。wechat_draft_media_id 时只更新原草稿；没有 ID 才允许创建，并必须显式使用创建确认参数。读取文章 Markdown、排版 HTML、公众号封面和 frontmatter。至少确认：
titlewechat_draft_media_id（若存在）wechat_draft_cover 或本地公众号封面wechat_draft_theme先核对源文件角色。kind: content-pack、kind: idea 或 kind: research 必须停止，沿 frontmatter 中的 draft 链接找到正文；不要因为文件名写着“成稿包”就把任务说明当成最终文章。
文章没有兼容知识库时仍可在当前工作区交付，但不要自行创建固定名称的 vault。需要长期回流时先转交 ray-obsidian。
先读 layout-contract.md。根据文章类型选择一个主题；用户仍在探索时只给最契合的一套推荐和一个备选，确认后再排。
若本机已经安装用户指定的第三方排版 Skill，完整读取并按其规则运行。gzh-design 可以作为外部排版器使用，但不得把它的 AGPL 组件代码复制进本仓库。没有外部排版器时，按 layout contract 生成独立的内联样式 HTML。
排版必须做到：
<section> 开始。<p>。生成带复制按钮的本地预览。实际以手机宽度打开，检查首屏、目录、章节、长英文、结尾和横向溢出。用户确认风格之前不进入下一步。
运行：
python3 scripts/prepare_article.py \
--article <文章.md> \
--html <公众号正文.html> \
--signature absent \
--out <交付清单.json>
--signature 使用 absent、present 或 inherit。任何 ERROR 都要修复并重跑；不要绕过原文遗漏、空段落、章节数量、英文拆词或署名检查。
先读 wechat-api.md 和 recovery-runbook.md。凭证优先从 WECHAT_APPID、WECHAT_SECRET 读取，也可以使用已有的 ~/.wewrite/config.yaml。不要把密钥拼进可见命令。
更新已有草稿：
python3 scripts/wechat_draft.py update \
--article <文章.md> \
--html <公众号正文.html> \
--config ~/.wewrite/config.yaml \
--theme <主题标识> \
--signature absent \
--record \
--confirm
没有草稿 ID 且用户明确同意创建时：
python3 scripts/wechat_draft.py create \
--article <文章.md> \
--html <公众号正文.html> \
--cover <公众号封面.png> \
--digest "文章摘要" \
--config ~/.wewrite/config.yaml \
--theme <主题标识> \
--signature absent \
--record \
--confirm
update 必须先读取原草稿，保留作者、封面和评论设置；文章 frontmatter 的正确标题优先于后台旧标题。create 必须有封面和摘要。两个动作都必须在写入后再次读取草稿并验收，只有验收通过才允许 --record 回写本地状态。
以下条件同时满足才算完成：
wechat_draft_status: draft。遇到网络、白名单、凭证、编码或回读不一致时，不宣称成功。按恢复手册修复同一草稿并重新验收。
向用户说明更新的是原草稿还是新草稿，以及标题、封面、正文完整性、空段落、署名和编码的最终状态。不要展示密钥、token、接口响应全文或内部脚本细节。