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

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

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

你：我有个客户想上 AI 客服，不知道现在能不能做
  → /ray-consult 诊断段做就绪度评估
  → 红黄绿评级 + 变绿条件
  → 条件清楚后继续在方案段出分期蓝图

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

你：把这篇定稿继续做成一条口播视频
  → /ray-writer 重新选择一个视频判断
  → 生成逐字稿、拍摄节奏、素材清单和录前核对
  → 需要拼贴画面时再交给 /ray-broll

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

    RAY --> INFRA["🛠 基建<br/>vps（开荒 · 巡检）"]
    RAY --> KNOWLEDGE["🗂 本地知识库<br/>obsidian"]
    RAY --> CONTENT["✍️ 内容 / IP<br/>writer（长文 · thread · 口播） · cover · wechat<br/>x-article · metrics · benchmark · report · broll"]
    RAY --> CONSULT["🔍 咨询<br/>consult（诊断 → 方案）"]
    RAY --> PRODUCT["📦 产品<br/>launch"]
    RAY --> COLLAB["🤝 协作<br/>multimodel"]

    OBSIDIAN["ray-obsidian<br/>资料 · 知识 · 成稿包"] --> WRITER["ray-writer<br/>长文 · thread · 口播"]
    WRITER --> COVER["ray-cover<br/>视觉隐喻 · 平台封面"]
    WRITER --> BROLL["ray-broll<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 长文生产管线。

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

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

v2 做过一轮成熟度精简：删除了 ray-tweet、ray-idea、ray-cleanup、ray-weekly，把 ray-diagnose + ray-proposal 合并为 ray-consult、ray-vpsinit + ray-nodecheck 合并为 ray-vps、ray-thread 并入 ray-writer 的 thread 骨架模式。方法论没有丢——合并项的完整流程和 eval 场景都随合并保留。v1 对照实测报告按当时的成员名单记录，作为历史证据保留，不随精简改写。v1 老用户升级请看 从 v1 升级。

最能体现 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-writer 把这篇定稿改成一条 2 到 3 分钟的口播视频稿
/ray-cover 给这篇定稿文章做公众号和 X Article 封面
/ray-wechat 把定稿排版并更新到已有公众号草稿，先预览再写入
/ray-x-article 把文章和 5:2 封面保存到 X 后台，不要发布
/ray-multimodel 让 Grok 和 Claude 独立给方案，由你验收
/ray-vps root@1.2.3.4

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

装过 v1（21 个 skill）的用户注意：重新执行 skills add 只会新增和刷新现存的 14 个成员，不会删除远端已经不存在的旧 skill。9 个旧目录会以过期副本留在本地，其中 ray-diagnose、ray-thread 等会和新的 ray-consult、ray-writer 抢触发，建议先清理再更新：

for s in ray-tweet ray-idea ray-cleanup ray-weekly ray-thread ray-diagnose ray-proposal ray-vpsinit ray-nodecheck; do npx -y skills remove "$s" -g; done && npx -y skills add imraywang/rayskills -g --all

旧成员去向对照：

运行 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 包为唯一真源，不维护一套容易漂移的豆包副本。

ray-multimodel 内置的 Grok 隔离搜索组件来自 sudoHG/codex-grok-search，按 MIT 协议保留原版权与许可；其余 rayskills 内容仍遵循仓库根目录的 CC BY-NC 4.0。

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