菜单
购书记录技能。当用户说「这本花了 X 元」「在京东买的」「补录购买信息」时使用。调用 bookshelf purchase 写入购买记录。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
家庭藏书入库技能。当用户发送书封照片、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） |