微信读书出 Skill 了，我那 23 本书 366 条笔记，今天起 Agent 自己会翻
哈喽，我是飞飞。
我在微信读书上一共有 23 本书做过笔记，总共 366 条。最多的一本是《如何让你爱的人爱上你》，120 条。这些数字我自己都记不清楚，但今天下午我打开 Claude Code，敲了一句”列一下我笔记最多的 10 本书”，Agent 三秒后把这张表吐给了我。
微信读书今天上线了官方 Agent Skill。从今天起，我那 23 本书 366 条笔记可以被 Agent 直接翻。而且不止 Claude Code，OpenClaw、Codex CLI、Cursor、Gemini CLI 都能用同一份 skill。
装 skill 这一步比想象中傻瓜
截图 1 是我今天上午装的过程。Claude Code 终端里直接说一句”下载 https://cdn.weread.qq.com/skills/weread-skills.zip 安装 skill”，Agent 自己跑了 curl + unzip，把 9 个 markdown 文件解压到 ~/.claude/skills/weread-skills/。9 个文件分别是 SKILL.md、book.md、discover.md、notes.md、profile.md、readdata.md、review.md、search.md、shelf.md，对应 8 类能力 + 1 个主入口。
老实讲，这种”发一句话就能给 Agent 装东西”的体验，半年前还不可能。这要感谢 Anthropic 2025 年 12 月把 Agent Skills 规范开源。截至今年 3 月，已经有 32 个 Agent 工具支持同一份 SKILL.md 格式，包括 Claude Code、Codex CLI、Cursor、Gemini CLI、JetBrains Junie、AWS Kiro、Block Goose。一份 skill 包，全行业通吃。
我 5 月 8 号就拿到内测装上了本地版本（看文件 mtime 是 5/8-5/9 那两天的）。但今天 5 月 18 号 App 端的 API Key 入口才正式开放。
App 端的入口才是今天的真新闻
截图 2 是微信读书 App 里”我 - 设置 - 微信读书 Skill”这个新页面。最上面 6 个能力卡片：查看书架、阅读统计、导出笔记、搜索书籍、书籍简介、好书推荐。中间是”复制 Skill 安装指令”按钮。最下面是 API Key，wrk-kdhs 开头那串。
我的 API Key 创建于 2026-05-18，状态是”尚未使用”。说明 App 这边的开关今天才打开。把这串 key 存到 WEREAD_API_KEY 环境变量里，重启 Agent 就完了。没有 OAuth 流程，扫码和 callback 地址也都省了。国内大厂能把鉴权简化到这一步的少见。
试了三件 App 内 AI 问书做不到的事
微信读书自己有 AI 问书功能，但只能针对当前打开的某一本书提问。Skill 接进 Agent 之后，能干的是跨书跨账户的活。
我让 Claude Code “列一下我最近读的 10 本书”。
截图 3 是结果：今年 2 月 12 号开始读的《胜算》刘润，去年 12 月 4 号读过的《清醒思考的艺术》罗尔夫·多贝里和《清醒思考：将平凡时刻转化为非凡成果》沙恩·帕里什，再往前是去年 8 月底的《人间失格》太宰治、《教育的本质》怀特海，5 月 24 号那两本《雪球专刊·特别版》段永平投资问答，1 月 25 号许知远的《十三邀3》。每条都带 weread://reading?bId=xxx 深度链接，点一下直接在 App 里继续读。
翻完最近 10 本之后，我让它统计笔记数量。
截图 4 是 23 本书 366 条笔记的统计表，按总笔记数倒序排。《如何让你爱的人爱上你》120 条划线 + 0 想法 + 1 书签，进度 27%。《颈椎病康复指南》25 条，进度 100%。从这张表能反推我每段时间在想什么。120 条笔记的那本书是我两年前刚毕业找对象那一阵看的，25 条颈椎病那本是写公众号写到颈椎报废那个月。
看完静态数据之后，我开始玩跨书工作流，让 Agent 干了三件 App 本身做不到的事。
让它从《如何让你爱的人爱上你》的 120 条划线里挑 10 条最有共鸣的，输出成一份 800 字的随笔素材。Agent 干完之后，连选哪条用了什么标准都告诉我。
让它根据我笔记最多的 10 本书的主题推荐相似新书。它推了《亲密关系》《心理学与生活》《社会心理学》《非暴力沟通》《被讨厌的勇气》第二部。前 4 本我书架里没有，第五本我已经做过 26 条笔记。
让它做一份这周读书周报。这周累计 2 小时 46 分钟，6 天阅读，日均 27 分钟，朋友里排第 198 名，比上周日均下降 35.5%。这种纵向自对比，App 端的”今年报告”做不到，需要 Agent 拿到原始数据自己算。
工程细节里藏着真功夫
打开 SKILL.md 我才发现微信读书工程团队下了不少功夫。三个细节值得讲。
所有能力走一个 POST 端点 https://i.weread.qq.com/api/agent/gateway，用 api_name 字段路由，Bearer 鉴权。这种”一个 gateway + N 个 api_name”的设计比”N 个 REST endpoint”更适合 Agent。Agent 不用记多个 URL，只要记一个端点和一个枚举值。
SKILL.md 里反复强调”参数必须平铺到 body 顶层，不要包在 params 对象里”，还给了反例：
1 | // 错误：被后端忽略 |
这种”反例先行”的写法，本质就是在踩过坑的地方留路标。Agent 不会读人类教程，但会读 SKILL.md 里的 few-shot。
最后是深度链接。每条划线 / 章节回包里 Agent 都会自动拼出 weread://reading?bId=xxx&chapterUid=xx&rangeStart=xx&rangeEnd=xx 这种 schema。Agent 把链接当文本输出，读者点一下就能跳回 App 对应位置。这一步让”AI 翻笔记”和”我自己读”之间的衔接没有断点。
App for Agent 是个新形态
微信读书是国内第一家把自家 App 的全套数据用 SKILL.md 标准开放给 Agent 的内容平台。这件事说人话讲：从今天起，”读书”这件事的入口不再只是 App 图标，可以是任何一个 Agent 助手。
腾讯 ima 同期出了 ima skill，可以跟微信读书联动把笔记同步到 Obsidian。墨问走的是 CLI 路线，比 Skill 灵活一档，能直接拼写自定义脚本。但 Skill 的好处是装一次 32 个 Agent 都能用，这种规模效应 CLI 暂时给不了。
得到、喜马拉雅、网易蜗牛我估计今年会跟。它们的数据维度（音频时长、播放进度、订阅人数）跟微信读书很相似，技术栈也都成熟。差别只在产品负责人愿不愿意把自家 App 当 Agent 的后端。
我会持续盯着两件事
一个关于使用频次。我自己一周后会不会还在用这个 skill。如果停留在今天试用的”哇好酷”，说明 App for Agent 这件事还在新鲜期。如果一周后我每隔几天就让 Agent 翻一遍笔记，那这个形态就立住了。
另一个关于”墨问 CLI 路线 vs 微信读书 Skill 路线”哪条路更对。墨问的 CLI 给开发者更大的灵活度，代价是学习成本不低。Skill 这边刚好反过来，装一次 32 个 Agent 都能用，但能干什么完全被官方 9 个接口圈定。我下个月会写一篇对比，把两种路线在不同场景下的实际表现摸一遍。
你呢，如果你也用微信读书，最想让 Agent 帮你做的第一件事是什么？翻笔记、推书单，还是给自己做一份私人书评？评论区告诉我，下次写跨书工作流的时候顺便聊。