rayskills 是一套给 Claude Code、Codex 等 AI Agent 使用的 builder 工具箱。它不是一堆“应该怎么想”的提示词，而是把真实工作中反复出现、容易犯错的流程，收敛成可以直接执行、可以验证、可以恢复的 Skill。

不用先记住 21 个名字。把处境交给 /ray：

• 下一步还不稳定时，它只选择此刻最该做的一步。
• 终点已经明确、阶段之间有正式交接时，它连续执行整条管线。
• 涉及删除、发布、生产修改等高影响动作时，仍然守住确认边界。

你：我有个客户想上 AI 客服，不知道现在能不能做
  → /ray-diagnose 做就绪度诊断
  → 红黄绿评级 + 变绿条件
  → 条件清楚后再交给 /ray-proposal 出分期方案

你：把这个 idea 写成文章，做公众号和 X 封面，再放进两个平台的草稿箱
  → /ray-writer 完成长文与质量检查
  → /ray-cover 生成各平台封面
  → /ray-wechat 确认排版并更新公众号原草稿
  → /ray-x-article 保存并验证草稿
  → 停在草稿，不自动发布

🎯 你交给它什么，它替你完成什么

🧭 一张图看懂

flowchart TD
    RAY(["/ray · 主路由与阶段编排"]):::hub

    RAY --> INFRA["🛠 基建<br/>vpsinit · nodecheck"]
    RAY --> KNOWLEDGE["🗂 本地知识库<br/>obsidian"]
    RAY --> CONTENT["✍️ 内容 / IP<br/>writer · cover · wechat · x-article<br/>thread · tweet · metrics · benchmark · report · broll"]
    RAY --> CONSULT["🔍 咨询<br/>diagnose → proposal"]
    RAY --> PRODUCT["📦 产品<br/>idea · launch"]
    RAY --> COLLAB["🤝 协作<br/>multimodel"]
    RAY --> OPS["🧹 内务<br/>weekly · cleanup"]

    OBSIDIAN["ray-obsidian<br/>资料 · 知识 · 成稿包"] --> WRITER["ray-writer<br/>事实 · 情绪 · 长文"]
    WRITER --> COVER["ray-cover<br/>视觉隐喻 · 平台封面"]
    COVER --> WECHAT["ray-wechat<br/>公众号排版 · 草稿回读"]
    COVER --> XARTICLE["ray-x-article<br/>查重 · 预览 · 草稿"]

    classDef hub fill:#b8553a,stroke:#7a3320,color:#fff,font-weight:bold;

更细的交接关系见 skill 关系图。

🏭 已跑通的长文生产管线

这条管线来自一次完整的真实生产过程，不是把三个 Skill 用箭头连起来就算完成。

管线支持中断恢复。例如浏览器暂时不能读取本地封面时，会保留同一草稿并记录 draft-needs-cover；权限恢复后只补封面，不重新建稿，也不重复写正文。

完整门控与恢复规则见 Ray 长文生产管线。

🗂 Skill 全目录（21）

/ray-post（公众号热点、选题、写作与发布）仍在独立仓库 WeWrite。ray-writer 处理证据型长文，ray-wechat 只接收定稿并负责排版与草稿验收；三者不混用。

📊 实测与验证

rayskills 把“文档写完”与“Skill 真能防错”分开检查。

新增的 ray-writer、ray-cover、ray-broll、ray-wechat、ray-x-article、ray-obsidian 已完成真实文章、错误反例、封面任务包、公众号草稿回读、X 草稿恢复与知识库安全初始化验证，但尚未计入旧版 15 项 baseline 对照统计。因此这里分别展示 21 项结构验证 和 15 项对照实测，不把两种口径混在一起。

最能体现 Skill 价值的不是文风，而是防住真实损害：

完整的 15 项带 / 不带 Skill 记分卡见 对照实测报告。

✅ 适合 / ❌ 不适合

适合：

• 一个人或小团队同时处理基建、内容、咨询、产品和运营。
• 想把真实实践沉淀成可复用、可验证流程的 builder。
• 使用 Claude Code、Codex 等 Agent 完成真实业务，而不只是问答。
• 需要 Agent 既能主动做完，又能在发布、删除和生产修改前守住边界。

不适合：

• 只需要一个领域的超深度专用工具。
• 纯陪聊、纯灵感或无需验证的一次性问答。
• 希望 Agent 无条件自动发布、自动删除或绕过确认。
• 不在这些真实工作流中的通用任务。

🚀 安装

安装全部 Skill：

npx -y skills add imraywang/rayskills -g --all

安装后可以从 /ray 开始，也可以直接调用具体 Skill：

/ray 我有个客户想上 AI 客服，不知道该先做什么
/ray 把这个 idea 走完整条内容管线，做到 X Articles 草稿，不要发布
/ray-obsidian 在这个本地目录搭一套可以接写作管线的知识库
/ray-writer 把这条剪藏发展成一篇公众号长文
/ray-cover 给这篇定稿文章做公众号和 X Article 封面
/ray-wechat 把定稿排版并更新到已有公众号草稿，先预览再写入
/ray-x-article 把文章和 5:2 封面保存到 X 后台，不要发布
/ray-multimodel 让 Grok 和 Claude 独立给方案，由你验收
/ray-vpsinit [email protected]

第一次使用建议先看 新手入门。

WorkBuddy

运行 bash tools/build.sh 后，dist/workbuddy/ 会生成每个 Skill 的独立 ZIP。进入 WorkBuddy 的技能页，选择“添加技能 → 上传技能”，直接导入所需 ZIP；包内的 SKILL.md、参考资料、脚本和模板会一起保留。

ray-writer 已在 WorkBuddy 5.2.3 完成真实导入、自动选择和调用验证；ray-obsidian 也已完成真实安装识别和独立旧库迁移验证。ray-wechat 的本地检查和草稿脚本只依赖 Python 标准库，外部排版器按宿主实际安装状态调用；没有公众号凭证或网络权限时停在本地预览，不冒充已经写入草稿。ray-report 不再绑定 Claude 的安装目录；ray-x-article 会选择当前宿主可用的浏览器或电脑控制能力，没有这类能力时会停在本地交付包。

豆包

豆包当前没有本地 SKILL.md 技能包导入入口，因此不能直接安装 rayskills。纯文字型成员可以人工转成智能体提示词，但脚本、浏览器操作、数据连接和多模型调度不会随提示词迁移；仓库仍以标准 Skill 包为唯一真源，不维护一套容易漂移的豆包副本。

🏛 架构与纪律

📚 文档

• 新手入门 — 第一次怎么用与完整目录
• Skill 关系图 — 成员之间的常见衔接
• 长文生产管线 — Writer → Cover → WeChat / X Article 的交接与恢复
• 公众号排版契约 — 移动端层级、署名策略与外部排版器边界
• 本地知识库结构 — 资料、知识、创作、发布与回流的目录职责
• 对照实测报告 — 15 项带 / 不带 Skill 逐条记分卡