前言¶
读完一本方法论或行业书，笔记往往停在文档里：下次写方案、带项目或做复盘时，还是要翻目录、搜关键词，很难把书里的框架稳定地「挂」在 Agent 工作流上。手工写 SKILL.md 又费时，还要自己拆章节、定命名和模板。
下面介绍 SkillHub 社区 Skill「书匠——炼书成器」（坐标 @user_02d72e1b/book-to-skill-pro）：上传一本书，由系统自动读格式、摸结构、精读核心章节，生成带命名、描述与模板的 skill，经你确认后落到本地技能目录，供后续对话直接调用。
这是什么¶
一句话定位：面向中文图书的 book-to-skill——把一本书变成以后能直接调用的能力，自动提取方法论、思维模型与可复用技能，生成跨项目可用的 skill。
- 名称：书匠——炼书成器
- 版本：1.0.0（资料来源：SkillHub 页面）
- 分类：knowledge-management
- 来源：community，发布者
user_02d72e1b - 官方入口：SkillHub 技能页 / API 地址
- 标签说明：
requires_api_key=false（基础用法不强制 API Key；微信读书加速为可选）
针对中文场景，资料中写明已考虑扫描版、复杂排版、译本术语、道术差异与同名词歧义等本土化问题。输出遵循通用 SKILL.md 格式，不直接复制原文，提炼结果需用户确认。
核心功能¶
官方描述的系统会自动完成以下步骤（用户无需自行处理 OCR、编码或格式细节）：
- 判断书籍格式，选择最省力的读取方式（支持 PDF / TXT / EPUB / MOBI / DOCX / MD）。
- 摸目录结构，定位核心方法论章节并精读提取。
- 生成命名、描述与模板，做质量自检后交给用户确认。
- 保存到用户级技能目录（见下文路径约定）。
进阶用法（在对话中加一句即可，均为可选）：
| 需求 | 说法示例 |
|---|---|
| 拆成多个 skill | 加一句「拆成多个」 |
| 在旧版 skill 上增量更新 | 加一句「增量更新」 |
| 指定语录/心法类模板 | 加一句「用语录型模板」 |
| 微信读书目录与划线加速 | 自行提供 WEREAD_API_KEY（不强制） |
开源声明（官方）：本 skill 开源，不写入任何个人密钥；路径一律使用 ~/.workbuddy/... 用户级约定，不依赖作者机器上的绝对路径。
安装与启用¶
资料中的「快速开始」强调：用户只需做一件事——把书发给该 skill。安装统计在 SkillHub 页面上可能随时间变化；启用方式以你在所用 Agent 产品中挂载 SkillHub / Workbuddy 技能为准。
生成结果的落盘位置（完整示例中的输出）：
~/.workbuddy/skills/<skill-slug>/SKILL.md
例如官方完整示例生成的技能目录为：
~/.workbuddy/skills/mastery-craft/SKILL.md
可选环境变量（仅微信读书加速场景）：
# 由最终用户在运行时自行提供，skill 不会写入个人密钥
export WEREAD_API_KEY="你的微信读书 API Key"
当前抓取资料未给出 Cursor、Codex CLI、Claude Code 各自的专用安装命令差异；若你从 SkillHub 安装，请以 SkillHub 页面与所用客户端的 skill 加载说明为准。
一句话激活（官方）：把这本书做成 skill。
典型用法¶
最小流程¶
- 在已启用该 skill 的对话中，上传一本书（任意支持格式）。
- 等待系统自动处理；在确认环节检查提炼出的方法论与模板是否符合你的预期。
- 确认保存后，在后续项目中通过 skill 名称调用，而不是每次重新贴书摘。
官方完整示例（可对照结构）¶
输入：夏晋宇《大师是怎样炼成的》docx 电子版（约 5.3MB，商业培训方法论类）。
输出：mastery-craft skill，路径 ~/.workbuddy/skills/mastery-craft/SKILL.md。
资料摘录的核心提炼方向包括（用于理解输出粒度，非原文）：
- 制造大师模型（四阶段 + 三基础）
- 三大教学法：痛点教学 → 实效教学 → 行动教学
- 贯穿全程的建模技术
- 大师基因：五关选拔、专精深精神、钉子精神、听得懂/学得会/用得上
- 实效教练三板斧：问题=课题 / 群策群力 / 演讲秘诀
- 大师境界：两个一/四个一工程、胸怀行业三境界
经过上面的步骤，一本书中的框架会被收敛成可重复触发的 skill 描述与模板，而不是一次性的聊天记录。
适用场景与注意¶
适合谁
- 经常读中文方法论、培训或行业书，希望把「书中的框架」变成 Agent 可复用技能的人。
- 需要一次生成、多项目调用，并愿意在确认环节把关提炼质量的用户。
限制与合规（官方注意事项）
- 仅用于上传自己拥有或有权使用的书或文档。
- 不直接复制原文；提炼内容须经用户确认。
- 敏感内容请用户自行过滤。
使用边界
- 依赖自动目录分析与章节精读，极难 OCR 或结构混乱的扫描件效果因书而异，确认环节不可省略。
- 微信读书加速为可选能力，不提供
WEREAD_API_KEY时仍可按「发书」主流程使用。
结尾¶
「书匠——炼书成器」把「读完了但用不上」收敛成一条可维护的 skill 链路：发书 → 自动提取与自检 → 你确认 → 写入 ~/.workbuddy/skills/。若你要把中文书里的方法论固化进 Agent 工作流，可从 SkillHub 查看详情并安装：
- https://www.skillhub.cn/skills/user_02d72e1b/book-to-skill-pro
- https://api.skillhub.cn/user_02d72e1b/book-to-skill-pro
