메뉴
家庭藏书入库技能。当用户发送书封照片、ISBN、或说「买了本书/入库/加书」时使用。调用 bookshelf CLI 完成识别、元数据补全与落库。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
家庭藏书查询技能。当用户问「有没有 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