Menu
藏书统计技能。当用户问「我家有多少书」「今年买书花了多少」「阅读 streak」时使用。调用 bookshelf stats。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| 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 与家庭服务器 |
家庭藏书入库技能。当用户发送书封照片、ISBN、或说「买了本书/入库/加书」时使用。调用 bookshelf CLI 完成识别、元数据补全与落库。
家庭藏书查询技能。当用户问「有没有 XX 书」「我家关于历史的书」「这本书详情」时使用。调用 bookshelf find / show 检索书架。
家庭书架初始化技能。当用户说「第一次使用」「初始化书架」「怎么配置」「连接不上」「setup」时使用。引导完成 API 连通、Google Books Key、Agent 对接与成员渠道绑定。
读书笔记技能。当用户说「记一段摘录」「写点感想」「给这本书做个笔记」时使用。调用 bookshelf note 写入 reading_notes。
购书记录技能。当用户说「这本花了 X 元」「在京东买的」「补录购买信息」时使用。调用 bookshelf purchase 写入购买记录。
阅读进度跟踪技能。当用户说「读到第 X 页」「在读」「读完了」「给这本书打 5 分」时使用。调用 bookshelf progress 更新进度。