Menu
购书记录技能。当用户说「这本花了 X 元」「在京东买的」「补录购买信息」时使用。调用 bookshelf purchase 写入购买记录。
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 完成识别、元数据补全与落库。
家庭藏书查询技能。当用户问「有没有 XX 书」「我家关于历史的书」「这本书详情」时使用。调用 bookshelf find / show 检索书架。
家庭书架初始化技能。当用户说「第一次使用」「初始化书架」「怎么配置」「连接不上」「setup」时使用。引导完成 API 连通、Google Books Key、Agent 对接与成员渠道绑定。
读书笔记技能。当用户说「记一段摘录」「写点感想」「给这本书做个笔记」时使用。调用 bookshelf note 写入 reading_notes。
阅读进度跟踪技能。当用户说「读到第 X 页」「在读」「读完了」「给这本书打 5 分」时使用。调用 bookshelf progress 更新进度。
藏书统计技能。当用户问「我家有多少书」「今年买书花了多少」「阅读 streak」时使用。调用 bookshelf stats。
| name | purchase-logger |
| description | 购书记录技能。当用户说「这本花了 X 元」「在京东买的」「补录购买信息」时使用。调用 bookshelf purchase 写入购买记录。 |
--price 则无需重复（intake 会自动记购买）bookshelf health
| 字段 | 必填 | 说明 |
|---|---|---|
| book_id | 是 | 通过 find 或用户提供的 ID |
| price | 是 | 购买价格（元） |
| original_price | 可选 | 定价/原价（用于折扣/打折统计） |
| channel | 推荐 | 当当 / 京东 / 孔夫子 / 线下书店 等 |
| order_no | 可选 | 订单号 |
| purchase_date | 可选 | 默认今天，格式 YYYY-MM-DD |
bookshelf find --keyword "活着"
bookshelf purchase --book-id 12 --price 38 --channel 当当
bookshelf purchase --book-id 12 --price 38 --original-price 45 --channel 当当 # 记录原价 45 元
bookshelf purchase --book-id 12 --price 45 --channel 京东 --order-no JD20260101001
bookshelf purchase --book-id 12 --price 30 --date 2026-01-15 --notes 二手九成新
| 场景 | 用哪个 |
|---|---|
| 新书第一次入库 + 购买信息 | bookshelf add ... --price --channel（book-intake） |
| 书已在架，补录/追加购买 | bookshelf purchase（本技能） |
| 重复入库提示已存在 | 用 purchase 补购买，不要重复 add |
已为《{title}》记录购买：¥{price}（{channel}）。
有订单号时附上：
订单号：{order_no}
{
"ok": true,
"data": {
"id": 5,
"book_id": 12,
"price": 38.0,
"original_price": 45.0,
"channel": "当当",
"message": "已为《活着》记录购买：¥38.0（当当）"
}
}
| 情况 | 处理 |
|---|---|
| 找不到书 | 先 find 或引导 book-intake |
| 缺少价格 | 追问「多少钱买的？」 |
| 价格 ≤ 0 | CLI/API 会拒绝，提示重新输入 |
| 用户说「免费/赠送」 | 可用 --price 0.01 并 --notes 赠送 或仅 notes（需 price>0，最低 0.01） |