菜单
读书笔记技能。当用户说「记一段摘录」「写点感想」「给这本书做个笔记」时使用。调用 bookshelf note 写入 reading_notes。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
家庭藏书入库技能。当用户发送书封照片、ISBN、或说「买了本书/入库/加书」时使用。调用 bookshelf CLI 完成识别、元数据补全与落库。
家庭藏书查询技能。当用户问「有没有 XX 书」「我家关于历史的书」「这本书详情」时使用。调用 bookshelf find / show 检索书架。
家庭书架初始化技能。当用户说「第一次使用」「初始化书架」「怎么配置」「连接不上」「setup」时使用。引导完成 API 连通、Google Books Key、Agent 对接与成员渠道绑定。
购书记录技能。当用户说「这本花了 X 元」「在京东买的」「补录购买信息」时使用。调用 bookshelf purchase 写入购买记录。
阅读进度跟踪技能。当用户说「读到第 X 页」「在读」「读完了」「给这本书打 5 分」时使用。调用 bookshelf progress 更新进度。
藏书统计技能。当用户问「我家有多少书」「今年买书花了多少」「阅读 streak」时使用。调用 bookshelf stats。
| name | note-taker |
| description | 读书笔记技能。当用户说「记一段摘录」「写点感想」「给这本书做个笔记」时使用。调用 bookshelf note 写入 reading_notes。 |
bookshelf health
| 字段 | 必填 | 说明 |
|---|---|---|
| book_id | 是 | 书籍 ID；用户只说书名时需先 find |
| content | 是 | 笔记正文（Markdown） |
| note_type | 否 | excerpt / review / thought，默认摘录 |
| page / chapter | 否 | 页码或章节 |
bookshelf find --keyword "..." 获取 book_idbookshelf note --book-id <ID> --content "..." [--type excerpt|review|thought] [--page N] [--chapter "第一章"]
| 情况 | 处理 |
|---|---|
| 找不到书 | 提示先入库或提供更准确书名 |
| 多本同名 | 列出候选让用户选择 |
| API 403 | 渠道身份未绑定/与 member_id 不一致，提示先 bind 或核对成员（/notes 端点接入渠道鉴权，行为同 reading-tracker） |