spacezephyr/read-buddy

Read Buddy

read-buddy.skill

「你想读懂的下一份信息，何必先被格式困住」

公众号 / 小红书 / B站 / 知乎：空格的键盘 ｜ [email protected]

Read Buddy 是一套给内容创作者、研究者、产品人和知识工作者用的信息读取 Skill 集合。

它帮你把网页、RSS、YouTube、播客、X/Twitter、飞书文档、图片 OCR、微信读书、个人阅读记录和热点信号，转成可读、可检索、可总结、可继续写作的结构化内容。

基于开放的 Agent Skills 协议，可在 Claude Code、Codex、Cursor、OpenClaw、Hermes Agent、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等兼容 runtime 中运行。

不是让 AI 凭空总结一段它没读过的材料。

是先把来源内容拿回来，再让 Agent 帮你完成：

• 读网页、转 Markdown、保留元数据
• 读 YouTube 字幕、播客更新和长内容
• 读 RSS 和 AI 热点，形成每日信息面
• 读飞书文档、图片/PDF OCR、个人历史数据
• 读微信读书划线、书架和阅读数据，生成导出、分析和回顾
• 读 X/Twitter 内容和博主风格，但明确反爬与同意边界
• 把长内容消化成摘要、选题、长文或短帖

看效果 · 安装 · 它能读什么 · 使用方式 · 工作原理 · 诚实边界

效果示例

用户      ❯ 把这篇网页转成 Markdown

助手      ❯ 已读取 URL，完成正文提取。

            输出包含：
            - 标题、作者、发布时间
            - 正文 Markdown
            - 原文链接
            - 图片引用

            已过滤导航、广告、页脚等噪声。

再看 YouTube：

用户      ❯ 帮我提取这个 YouTube 视频字幕并总结

助手      ❯ 已提取字幕，优先语言：中文 / 英文。

            主要观点：
            1. AI Agent 的价值不在替代按钮，而在连接上下文
            2. 工作流稳定性比单次模型能力更重要
            3. 好的工具应该留下可复用的中间产物

            可继续生成：短帖、长文、金句、选题卡。

再看热点采集：

用户      ❯ 看看最近 3 天 AI 圈有什么新东西

助手      ❯ 已聚合 RSS / Product Hunt / Hacker News / 官方博客 / X 公开信息。

            今日值得关注：
            - 新模型发布：适合写快讯
            - AI 编程产品更新：适合做教程
            - Agent 工作流案例：适合拆方法论
            - 开源项目上榜：适合做选题池

Read Buddy 的目标不是囤信息。
它负责把信息变成下一步可以用的材料。

安装

Read Buddy 基于开放的 Agent Skills 协议，可在任何 skills-compatible 的 AI agent runtime 中运行。

方式一：一行命令（推荐，跨 runtime）

打开你正在用的 agent（Claude Code、Codex、Cursor、OpenClaw、Hermes、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等），告诉它：

帮我安装这个 skill：https://github.com/SpaceZephyr/read-buddy

或者用通用 CLI 安装器（vercel-labs/skills，支持多 runtime）：

npx skills add SpaceZephyr/read-buddy

它会自动识别你当前的 runtime 并把 skill 放到正确目录。需要指定时可加 runtime 参数，例如 -a codex / -a claude-code / -a cursor。

方式二：手动安装

克隆仓库后，把需要的 skill 目录复制到你的 runtime skills 目录：

git clone https://github.com/SpaceZephyr/read-buddy.git

仓库结构：

read-content-digest/
read-feishu-doc/
read-ocr/
read-personal-data-harvester/
read-podcast-script-generator/
read-podcast-workflow/
read-rss-aggregator/
read-topic-collector/
read-url-markdown/
read-weread-analyzer/
read-weread-coach/
read-weread-export/
read-web-article-translator/
read-web-scraper/
read-x-blogger-analyzer/
read-x-markdown/
read-xiaoyuzhou-article/
read-youtube-feed/
read-youtube-transcript/

每个子目录都是一个独立 Skill。

命名规范

Read Buddy 内所有 Skill 都统一使用 read-* 命名，目录名与 SKILL.md 里的 name 保持一致。

• read-：表示这是 SpaceZephyr 体系下的信息读取与消化类 Skill。
• 中间词：说明来源或对象，例如 youtube、x、rss、web、feishu。
• 后缀词：说明动作或输出，例如 markdown、transcript、digest、aggregator、translator。

例如：read-url-markdown 把网页转成 Markdown，read-youtube-transcript 提取 YouTube 字幕，read-content-digest 消化长内容。

方式三：作为参考资料使用

即使你的 runtime 不支持 Agent Skills 自动加载，也可以直接打开对应目录里的 SKILL.md，把内容粘贴进对话。
它本质是一份 markdown + YAML frontmatter + 可运行脚本或工作流说明。

使用

装好后，可以直接告诉 agent：

把这个网页保存成 Markdown

提取这个 YouTube 视频的中文字幕

把这个小宇宙单集转成文章

把这篇播客摘要改成口播脚本

最近 3 天 RSS 有什么更新

分析这个 X 博主的内容风格

把这篇英文网页翻译成中文 Markdown

读取这个飞书文档

导出我的微信读书划线

分析我的微信读书，生成阅读画像

把这张图里的文字 OCR 出来

开始今日 AI 热点采集

它能读什么

使用方式

你可以用自然语言直接触发，也可以点名调用单个 Skill。

工作原理

Read Buddy 不是一个单一爬虫，而是一组信息读取和消化 Skill。

它把阅读任务拆成四层：

常见分支：

• 网页读取：优先用轻量抓取，遇到登录态或 JS 渲染页面时使用 Chrome CDP。
• 视频播客：先获取更新或字幕，再交给 read-content-digest 做观点提炼；小宇宙单集可走 read-xiaoyuzhou-article 下载音频并转写。
• 口播创作：播客摘要或结构化笔记可交给 read-podcast-script-generator 改成视频口播稿。
• 热点采集：先收集多源链接，再按来源、主题和选题价值整理。
• X 内容：能手动就手动，自动抓取需要用户知情并接受反爬风险。
• 微信读书：依赖官方 weread-skills 提供的 API Gateway 和用户自己的 WEREAD_API_KEY。
• 个人数据：只处理用户自己的数据，默认本地保存，不上传。

适合谁

• 自媒体作者：读网页、读视频、读热点，沉淀选题和素材
• 研究者：聚合 RSS、论文、官方博客和访谈内容
• 产品经理：追踪竞品动态、用户讨论、行业新闻
• 播客听众：把 YouTube / 小宇宙播客转文字稿、摘要、文章和口播脚本
• 知识管理用户：把网页、飞书、个人历史数据转成本地知识库
• 内容运营：分析 X 博主、热点来源和内容风格

风控与安全性说明

Read Buddy 的定位是公开内容读取、个人数据整理和知识消化，不是账号自动化或大规模爬虫工具。

• 只读优先：默认只读取公开内容、用户提供的链接、用户本机文件或用户自己的平台数据。
• 不做账号动作：不执行发帖、点赞、评论、关注、私信、批量互动等写操作。
• 凭据不入库：飞书 app secret、Cookie、API Key、.env、浏览器登录态和个人数据库都不应提交到仓库。
• 微信读书数据：只处理用户授权后的个人书架、划线、想法和阅读数据，报告发布前应脱敏。
• X 风险提示：read-x-markdown 使用非官方接口，必须先获得用户同意，并告知可能失效或触发平台限制。
• 个人数据本地化：read-personal-data-harvester 默认只在用户设备上采集和保存，不上传到第三方。
• 小宇宙转写：read-xiaoyuzhou-article 需要 ffmpeg 和 GROQ_API_KEY，音频下载与转录应仅用于你有权处理的内容。
• 低频采样：RSS、网页、YouTube、X 等来源应低频、按需读取，避免给平台造成压力。
• 分享前脱敏：报告和 Markdown 发布前移除 Cookie、token、邮箱、手机号、私密链接和未公开账号信息。

诚实边界

每个信息读取工具都应该说明自己做不到什么。

• 不是实时全网监控：RSS、搜索、YouTube 和网页结果都受来源更新和接口限制影响。
• 抓取不保证成功：登录、验证码、Cloudflare、JS 渲染、反爬和地区限制都可能失败。
• OCR 会出错：低清图片、复杂表格、手写体和多语言混排需要人工复核。
• 自动摘要和口播脚本不等于原文：read-content-digest / read-podcast-script-generator 会压缩、重组和改写观点，关键事实仍应回看原始文稿。
• X 自动抓取成功率低：推荐用户手动复制内容再分析。
• 个人数据采集需要授权：微信读书和其他个人平台只能处理用户自己的数据，不能替代平台导出或合规审查。

一个不告诉你边界在哪的阅读工具，不值得信任。

参考

Read Buddy 汇集并整理了多个信息获取、内容读取、转写、翻译、摘要和个人数据采集 Skill。其中播客链路整合了 SpaceZephyr/onepod-Skill 的 YouTube / 小宇宙处理能力，微信读书链路整合了 SpaceZephyr/space-weread 的导出、分析和回顾能力。

其中部分 Skill 依赖 Chrome CDP、Feishu Open API、YouTube transcript、OCR API、RSS feed、Playwright 或本地脚本，具体依赖以各目录的 SKILL.md 和 scripts/ 为准。

许可证

MIT