菜单
家庭藏书查询技能。当用户问「有没有 XX 书」「我家关于历史的书」「这本书详情」时使用。调用 bookshelf find / show 检索书架。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
家庭藏书入库技能。当用户发送书封照片、ISBN、或说「买了本书/入库/加书」时使用。调用 bookshelf CLI 完成识别、元数据补全与落库。
家庭书架初始化技能。当用户说「第一次使用」「初始化书架」「怎么配置」「连接不上」「setup」时使用。引导完成 API 连通、Google Books Key、Agent 对接与成员渠道绑定。
读书笔记技能。当用户说「记一段摘录」「写点感想」「给这本书做个笔记」时使用。调用 bookshelf note 写入 reading_notes。
购书记录技能。当用户说「这本花了 X 元」「在京东买的」「补录购买信息」时使用。调用 bookshelf purchase 写入购买记录。
阅读进度跟踪技能。当用户说「读到第 X 页」「在读」「读完了」「给这本书打 5 分」时使用。调用 bookshelf progress 更新进度。
藏书统计技能。当用户问「我家有多少书」「今年买书花了多少」「阅读 streak」时使用。调用 bookshelf stats。
| name | book-query |
| description | 家庭藏书查询技能。当用户问「有没有 XX 书」「我家关于历史的书」「这本书详情」时使用。调用 bookshelf find / show 检索书架。 |
bookshelf health
| 用户提供 | 使用命令 |
|---|---|
| 书名关键词 | find --keyword |
| 作者 | find --author |
| ISBN | find --isbn |
| 书籍 ID | show --id |
可同时组合 keyword + author 缩小范围。
一期范围说明：
find仅支持--keyword/--author/--isbn三个过滤参数；不支持按阅读状态、副本位置、分类等过滤（--status/--shelf/--category等为设计方案中的二期示意命令）。
若用户描述模糊（「那本红封面的」），先追问书名/作者/ISBN，不要瞎猜。
bookshelf find --keyword "三体"
bookshelf find --keyword "历史"
bookshelf find --author "刘慈欣"
bookshelf find --isbn 9787506365437
bookshelf show --id 12
find 返回 total > 1 时，列出前 5 条让用户选：
找到 3 本，请确认是哪一本：
1. [12] 《三体》— 刘慈欣
2. [15] 《三体·黑暗森林》— 刘慈欣
...
用户选定后再 show --id {id}。
找到 1 本：
有的！《{title}》（ID {id}），{authors}。ISBN：{isbn13}。
找到多本：
找到 {total} 本相关藏书：[简要列表]。要看哪一本的详情？
未找到：
书架上还没有「{keyword}」相关的书。需要我帮你入库吗？
查看详情：
《{title}》
作者：{authors}
出版社：{publisher} · {publish_date}
ISBN：{isbn13}
分类：{category}
CLI 默认 --json，关注字段：
{
"ok": true,
"data": {
"items": [...],
"total": 3
}
}
或单本 show 的 data 对象。
| 情况 | 处理 |
|---|---|
| total = 0 | 明确告知没有，可引导 book-intake |
| 404 show | ID 不存在，建议重新 find |
| API 不可用 | 提示检查后端服务 |