这是什么
rayskills 是一套给 Claude Code、Codex 等 AI Agent 使用的 builder 工具箱，由作者 imraywang 从真实业务中沉淀而来。它不是一堆“应该怎么想”的提示词，而是把真实工作中反复出现、容易犯错的流程，收敛成可以直接执行、可以验证、可以恢复的 Skill。
仓库当前包含 8 个 Skill，以 /ray 作为主路由，覆盖本地知识库、长文写作、口播稿、封面设计、公众号排版、X Articles 草稿、解说视频制作等环节。
适合谁
这个工具箱适合以下人群：
- 一个人或小团队同时处理基建、内容、咨询、产品和运营。
- 想把真实实践沉淀成可复用、可验证流程的 builder。
- 使用 Claude Code、Codex 等 Agent 完成真实业务，而不只是问答。
- 需要 Agent 既能主动做完，又能在发布、删除和生产修改前守住边界。
它不适合：只需要一个领域的超深度专用工具、纯陪聊或无需验证的一次性问答、希望 Agent 无条件自动发布或绕过确认的用户。
能做什么
rayskills 提供 8 个 Skill，每个都有明确的职责：
- /ray：主路由，读取当前处境，选择下一步；终点明确时编排正式管线。
- /ray-obsidian：新建、检查或适配本地 Obsidian 内容知识库，安全建立资料、知识、候选选题、写作任务、母稿、发布反馈与回流骨架。
- /ray-writer：把灵感、剪藏、调研或草稿写成有态度的中文长文（公众号 / X 长文），也支持带授权署名的译介模式。
- /ray-kb：把灵感或长文写成可直接开录的口播稿，或审读口播稿，学习作者的真实表达。
- /ray-cover：为定稿文章生成公众号、普通 X、X Article 封面；为视频生成 9:16 / 3:4 竖封面。
- /ray-wechat：把定稿长文排成手机友好的公众号富文本，确认后写入或更新公众号草稿箱并回读核对。
- /ray-x-article：把长文和 5:2 封面写进已登录的 X Articles 后台存为草稿，核对预览并回写知识库。
- /ray-explainer：把文章或剪藏做成 1.5–3 分钟竖屏解说视频，支持手绘套路或多种解说语法，可复刻音色配音、逐字卡点，并带数字人主持人。
这套 Skill 的核心价值在于“防住真实损害”：不覆盖用户已有笔记、不把别人的文章洗成原创、不重复建草稿、不把接口成功码误判成完成、不在画面里编造具体金额和名称等。
使用前准备
使用 rayskills 前，你需要：
- 安装 Claude Code 或 Codex 等 AI Agent 环境（推荐 Claude Code 或 Codex）。
- 准备一个本地目录或已有的 Obsidian 知识库（可选，但推荐）。
- 如需生成封面，需要可用的图像生成服务（如 Codex CLI 调 Image 2）。
- 如需写入公众号或 X Articles，需要对应的账号登录状态。
安装方法
安装全部 Skill，在终端执行以下命令：
npx -y skills add imraywang/rayskills -g --all国内访问 GitHub 慢时，可以从 Gitee 镜像拿代码（与 GitHub 同步更新）：
git clone https://gitee.com/imraywang/rayskills.git安装后可以从 /ray 开始，也可以直接调用具体 Skill。第一次使用建议先阅读仓库中的《新手入门》文档。
使用示例
以下是一些典型的使用方式：
/ray 我有个客户想上 AI 客服，不知道该先做什么
/ray 把这个 idea 走完整条内容管线，做到 X Articles 草稿，不要发布
/ray-obsidian 在这个本地目录搭一套可以接写作管线的知识库
/ray-writer 把这条剪藏发展成一篇公众号长文
/ray-kb 我有一个现场观察，直接做成快速口播
/ray-cover 给这篇定稿文章做公众号和 X Article 封面
/ray-wechat 把定稿排版并更新到已有公众号草稿，先预览再写入
/ray-x-article 把文章和 5:2 封面保存到 X 后台，不要发布
/ray-explainer 把这篇剪藏做成 2 分钟竖屏解说视频，用我的声音例如，当你有一篇英文文章想翻译发公众号时，/ray-writer 的译介模式会先检查授权与署名，未获许可就停在本地译文；拿到许可后再进入平台草稿。当你有一个 idea 想写成文章并制作封面、放入公众号和 X 草稿箱时，/ray 会编排 /ray-writer → /ray-cover → /ray-wechat → /ray-x-article，全程停在草稿，不自动发布。
风险与注意事项
- 不自动发布：所有 Skill 都遵守确认边界，不会自动发布或删除内容，涉及高影响动作时会要求用户确认。
- 授权与署名：译介模式要求先获得原作者授权，未授权不进入平台草稿，避免洗稿风险。
- 数据安全：
/ray-obsidian会先预演，确保不覆盖、移动或批量改写用户已有笔记。 - 版本升级：从旧版本升级时，重新执行
skills add不会删除远端已不存在的旧 skill，旧目录可能残留并抢占触发，建议先清理再更新（仓库提供了清理命令）。 - 外部依赖：封面生成依赖图像生成服务，公众号和 X Articles 写入依赖对应平台登录状态，没有这些条件时会停在本地预览或交付包，不会冒充已完成。
- 许可协议：仓库内容遵循 CC BY-NC 4.0（非商业使用），内置的 Punk 风格库按 MIT 协议保留原版权。