用途：把微信读书的原子接口编排成读书顾问工作流，输出对用户有消费价值的结果。四类工作流：advisor 基于已读做个性化进阶推荐；path 为某方向规划从入门到前沿的阶梯书单；alchemy 把零散划线与想法提炼成读书笔记总结；review 做季度或年度阅读复盘并生成可发布文章。
主要能力：交叉书架（/shelf/sync）与笔记（/user/notebooks）两个数据源，结合进度（/book/getprogress）与统计（/readdata/detail）；按 readUpdateTime 倒序判断最近 30 天真实兴趣；推荐前用 /store/search 验证是否上架，上架附 weread://reading?bId={bookId} 链接，未上架给出合法替代路径。
使用方式：先 export WEREAD_API_KEY=<你的apikey>；调用走 POST https://i.weread.qq.com/api/agent/gateway，body 需带 skill_version，取值以 ~/.claude/skills/weread/SKILL.md 顶部 frontmatter 的 version 为准。使用前先读 SKILL.md、对应 workflow 文件与 shared/knowledge-map.md。子命令按用户说法路由，如「推荐书」走 advisor，「系统学习 X」走 path，「整理我的笔记」走 alchemy，「年度复盘」走 review；「我现在在读哪本」为轻量直答。
限制：依赖 API Key 与接口可用性；接口报错重试一次后停止，返回 upgrade_info 需先升级；/store/search 结果结构为 results[] 而非 books[]；笔记或书架为空时推荐准度下降；时间戳、时长、进度需按规范转换展示，bookId 不裸露。具体价格与平台支持暂未提供。