Menu
家庭藏书查询技能。当用户问「有没有 XX 书」「我家关于历史的书」「这本书详情」时使用。调用 bookshelf find / show 检索书架。
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
家庭藏书入库技能。当用户发送书封照片、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 不可用 | 提示检查后端服务 |