Menu
家庭藏书入库技能。当用户发送书封照片、ISBN、或说「买了本书/入库/加书」时使用。调用 bookshelf CLI 完成识别、元数据补全与落库。
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
家庭藏书查询技能。当用户问「有没有 XX 书」「我家关于历史的书」「这本书详情」时使用。调用 bookshelf find / show 检索书架。
家庭书架初始化技能。当用户说「第一次使用」「初始化书架」「怎么配置」「连接不上」「setup」时使用。引导完成 API 连通、Google Books Key、Agent 对接与成员渠道绑定。
读书笔记技能。当用户说「记一段摘录」「写点感想」「给这本书做个笔记」时使用。调用 bookshelf note 写入 reading_notes。
购书记录技能。当用户说「这本花了 X 元」「在京东买的」「补录购买信息」时使用。调用 bookshelf purchase 写入购买记录。
阅读进度跟踪技能。当用户说「读到第 X 页」「在读」「读完了」「给这本书打 5 分」时使用。调用 bookshelf progress 更新进度。
藏书统计技能。当用户问「我家有多少书」「今年买书花了多少」「阅读 streak」时使用。调用 bookshelf stats。
| name | book-intake |
| description | 家庭藏书入库技能。当用户发送书封照片、ISBN、或说「买了本书/入库/加书」时使用。调用 bookshelf CLI 完成识别、元数据补全与落库。 |
用户意图是把一本书加入家庭书架，典型输入：
9787506365437）bookshelf healthBOOKSHELF_API_URL 默认 http://127.0.0.1:8000| 字段 | 是否必填 | 说明 |
|---|---|---|
| ISBN / 图片 / 书名 | 三选一 | 至少一种识别线索 |
| 作者 | 推荐 | 仅书名时用于消歧 |
| 价格 / 渠道 | 可选 | 入库同时记购买 |
| 存放位置 | 可选 | 如「客厅书架 A」 |
缺少关键信息时追问一句，不要猜测入库：
# 可选：先识别 ISBN 给用户确认
bookshelf recognize --image /path/to/cover.jpg
# 入库（图片会触发条码识别 + 元数据补全）
bookshelf add --image /path/to/cover.jpg
bookshelf add --isbn 9787506365437
后端会校验 ISBN-10/13 校验位：手工传入错误校验位返回 400/422；条码识别结果无效则回退到书名匹配。
bookshelf add --title "活着" --author "余华"
bookshelf add --isbn 9787506365437 --price 38 --channel 当当
系统自动按 ISBN 前缀路由：
978-7 中文书：国图 NLC → Google Books → Open Library → 搜索兜底任意 provider 异常会被隔离，不影响后续回退链；元数据返回的 ISBN 仍走相同的校验位规则。
成功时向用户确认：
已入库《{title}》，作者 {authors}，ISBN {isbn13}。
元数据来源：{matched_source}。
书架 ID：{book.id}
若 already_exists: true：
《{title}》已在书架中（ID {book.id}）。需要我记购买或更新位置吗？
识别到书名但元数据不全时：
已入库《{title}》，部分信息未能自动补全，你可以补充作者或 ISBN。
| 情况 | 处理 |
|---|---|
recognize 未找到条码 | 请用户补 ISBN，或描述封面文字后 --title --author 入库 |
| API 400 / 422 | 转述错误，提示补 ISBN/书名/更清晰照片；ISBN 校验位错误请用户核对 ISBN |
| API 403 | 渠道身份未绑定/与 member_id 不一致，提示先 bind 或核对成员 |
| API 503 | 后端或识别服务不可用，稍后重试 |
| 重复入库 | 告知已存在，询问是否记购买/加副本 |
add