Menu
阅读进度跟踪技能。当用户说「读到第 X 页」「在读」「读完了」「给这本书打 5 分」时使用。调用 bookshelf progress 更新进度。
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 元」「在京东买的」「补录购买信息」时使用。调用 bookshelf purchase 写入购买记录。
藏书统计技能。当用户问「我家有多少书」「今年买书花了多少」「阅读 streak」时使用。调用 bookshelf stats。
| name | reading-tracker |
| description | 阅读进度跟踪技能。当用户说「读到第 X 页」「在读」「读完了」「给这本书打 5 分」时使用。调用 bookshelf progress 更新进度。 |
bookshelf health
| 字段 | 必填 | 说明 |
|---|---|---|
| book_id | 是 | 书籍 ID；用户只说书名时需先 find |
| 页码 / 状态 / 评分 | 至少一项 | 决定更新什么 |
book_id 获取流程：
bookshelf find --keyword "..."，消歧后取 ID可选 --member-id；未指定时使用系统默认成员（首个成员或自动创建的「默认用户」）。
渠道鉴权（Agent 走后端时）：调用
/progress端点时，后端读取 HTTP 头X-Channel/X-External-User-Id：
- 无渠道头 → 回退到默认成员（一期可信局域网兜底）
- 有渠道头但未绑定 → 403
- 有渠道头且绑定，但与 body
member_id不一致 → 403CLI 本身不带渠道头，由 Agent/适配层在请求时注入。
bookshelf progress --book-id 12 --page 120
系统自动计算百分比（若书有总页数）。
bookshelf progress --book-id 12 --status reading
bookshelf progress --book-id 12 --status finished --rating 5
bookshelf progress --book-id 12 --percent 45
| status | 含义 |
|---|---|
unread | 未读 |
reading | 在读 |
finished | 已读完 |
abandoned | 弃读（不再继续） |
dropped | 放弃（中途放弃） |
《{title}》阅读进度已更新至第 {current_page} 页（约 {percent}%）。
读完时：
《{title}》已标记为读完！{rating 分时：你的评分：{rating} 星}
{
"ok": true,
"data": {
"book_id": 12,
"status": "reading",
"current_page": 120,
"percent": 48.0,
"message": "《活着》阅读进度已更新至第 120 页"
}
}
| 情况 | 处理 |
|---|---|
| 找不到书（find 无结果） | 问是否要先入库 |
| book_id 不存在 | 提示重新查询 |
| 页码 > 总页数 | 仍记录，但可提醒用户确认 |
| 用户未指明哪本书 | 追问书名或 ID |
| API 403 | 渠道身份未绑定/与 member_id 不一致，提示先 bind 或核对成员 |