菜单
藏书统计技能。当用户问「我家有多少书」「今年买书花了多少」「阅读 streak」时使用。调用 bookshelf stats。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
家庭藏书入库技能。当用户发送书封照片、ISBN、或说「买了本书/入库/加书」时使用。调用 bookshelf CLI 完成识别、元数据补全与落库。
家庭藏书查询技能。当用户问「有没有 XX 书」「我家关于历史的书」「这本书详情」时使用。调用 bookshelf find / show 检索书架。
家庭书架初始化技能。当用户说「第一次使用」「初始化书架」「怎么配置」「连接不上」「setup」时使用。引导完成 API 连通、Google Books Key、Agent 对接与成员渠道绑定。
读书笔记技能。当用户说「记一段摘录」「写点感想」「给这本书做个笔记」时使用。调用 bookshelf note 写入 reading_notes。
购书记录技能。当用户说「这本花了 X 元」「在京东买的」「补录购买信息」时使用。调用 bookshelf purchase 写入购买记录。
阅读进度跟踪技能。当用户说「读到第 X 页」「在读」「读完了」「给这本书打 5 分」时使用。调用 bookshelf progress 更新进度。
| name | shelf-report |
| description | 藏书统计技能。当用户问「我家有多少书」「今年买书花了多少」「阅读 streak」时使用。调用 bookshelf stats。 |
bookshelf health
bookshelf stats
一期范围说明：一期
stats为基础版，不接受任何参数。设计方案中提到的按年（--year）、按分类细分（--by）、按渠道花费细分（--spending）等命令为二期示意，一期未实现。当前返回的是全库聚合的total_spent（仅 CNY）与by_category全量分类。
返回字段包括：
total_books：藏书总数by_status：各阅读状态数量（unread/reading/finished/abandoned/dropped）by_category：分类统计total_spent / purchase_count：购书花费reading_logs_pages_total：阅读日志累计页数members：各成员在读/读完数量与 streak用自然语言概括 2～4 个关键数字，避免直接 dump 整段 JSON。
示例：「目前藏书 128 本，在读 5 本；购书共花费 ¥3,240。本月阅读日志累计 420 页。」
| 情况 | 处理 |
|---|---|
| API 离线 | 提示检查 bookshelf health 与家庭服务器 |