菜单
阅读进度跟踪技能。当用户说「读到第 X 页」「在读」「读完了」「给这本书打 5 分」时使用。调用 bookshelf progress 更新进度。
用 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 元」「在京东买的」「补录购买信息」时使用。调用 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 或核对成员 |