前言¶

读完一本方法论类书籍，常见做法是写摘要或读书笔记。这类产出适合人类回顾，却很难在写代码、做方案时直接被 Agent 调用：缺少明确的触发条件、可执行步骤和边界说明，模型要么想不起来用，要么误用。

下面介绍 SkillHub 上的社区 Skill「拆书成技能」（坐标 @user_1a7e2e57/cangjie-distill）。它把整本书按固定流水线拆成一组原子化的 SKILL.md，并附带索引与压力测试用例，目标是把「书里的框架与原则」变成「真实任务里可调用的技能」，而不是书摘或读后感。

这是什么¶

一句话定位：基于 RIA-TV++ 流水线的元 Skill（包内也称 book2skill / cangjie-skill），把用户提供的书籍文本蒸馏为 books/<book-slug>/ 下的一组可执行 skills。

维护与来源：SkillHub 社区发布，发布者 user_1a7e2e57，分类 knowledge-management，当前版本 1.0.0，标签 requires_api_key=false（无需 API Key）。包内 homepage 指向 kangarooking/cangjie-skill。

边界（来自官方 SKILL.md）：

• 做：方法论、决策框架、清单、原则、概念体系的蒸馏。
• 不做：书摘、读后感、作者人设角色扮演（文档建议此类需求使用 nuwa-skill）。

核心功能¶

RIA-TV++ 四阶段流水线¶

Skill 内置完整 SOP，执行顺序固定，细节分布在 methodology/ 与 extractors/ 中。总览如下：

阶段 1 会并行启动五类提取器：框架、原则、案例、反例、术语，分别对应 extractors/ 下的 prompt 文件。

三重验证与质量红线¶

阶段 1.5 对每个候选单元做 V1 跨域、V2 预测力、V3 独特性检验；未通过项写入 rejected/ 并注明原因。

阶段 2 按 RIA++ 填充每个 skill：Reading / Interpretation / 书中应用案例 / Future Trigger（写入 description）/ Execution 步骤 / Boundary。官方要求原文引用每段不超过 150 字，且每个 skill 必须带诱饵类测试（不应被调用的场景）。

与 darwin-skill 的衔接¶

产出的 test-prompts.json 遵循 darwin-skill 格式（should_trigger、should_not_trigger、edge_case 等）。阶段 4 要求在本地跑测，未通过则回炉阶段 2，全部通过后可交给 darwin-skill 做后续进化。

运行时依赖¶

包内 allowed-tools 声明为：Read、Write、Bash、Glob、Grep、Agent。阶段 1 需要 Agent 工具并行 spawn sub-agent；环境不支持时，需自行按同样分工拆步执行。

安装与启用¶

安装 SkillHub CLI¶

若尚未安装 CLI，可先检查版本：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 官方安装文档执行（完整安装示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

说明见 SkillHub 安装与优先源配置。

安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。

skillhub install @user_1a7e2e57/cangjie-distill --dir <你的 skills 目录>

常用路径示例（来自官方安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

SkillHub 页面也支持将下面提示词交给 AI，让其按安装文档完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_1a7e2e57/cangjie-distill`。

安装后若 Agent 未加载新技能，按你所用客户端说明重启或刷新 skills 目录。

说明：包内 SKILL.md frontmatter 含 disable: true 字段；若客户端按该字段默认禁用技能，需在设置中显式启用后再调用。

典型用法¶

何时触发¶

官方 description 与正文约定，在用户表达「拆书」「蒸馏一本书」「把 XX 书做成 skill」等意图时使用，例如：

• 「帮我拆《穷查理宝典》」
• 「把毛选蒸馏成 skill」
• distill this book into skills: <path>

开始前必须确认的信息¶

1. 书的文本来源：PDF、EPUB、TXT 路径或可访问的纯文本；无文本时应向用户索取，不得凭记忆拆书。
2. 书名、作者、出版年：用于目录命名与审计。
3. 是否首次试点：建议先拆 1 本验证流程，再批量。

输出目录结构¶

执行完成后，书籍产物落在类似如下结构中（路径与文件名来自官方模板）：

books/<book-slug>/
├── BOOK_OVERVIEW.md
├── INDEX.md
├── candidates/
├── rejected/
├── <skill-slug-1>/
│   ├── SKILL.md
│   └── test-prompts.json
└── <skill-slug-2>/
    └── ...

阶段 0 产出 BOOK_OVERVIEW.md 后，应先向用户确认「骨架是否理解正确」，再进入并行提取。

测试用例格式示例¶

每个子 skill 的 test-prompts.json 需包含应调用、不应调用（诱饵）与边界场景。模板结构如下（字段含义见包内 templates/test-prompts.json）：

{
  "skill": "{{skill-slug}}",
  "version": "0.1.0",
  "source_book": "{{BOOK_TITLE}} — {{AUTHOR}}",
  "darwin_compatible": true,
  "test_cases": [
    {
      "id": "should-trigger-01",
      "type": "should_trigger",
      "prompt": "{{用户的典型话语}}",
      "expected_behavior": "应激活本 skill 并执行期望动作",
      "notes": ""
    },
    {
      "id": "should-not-trigger-01",
      "type": "should_not_trigger",
      "prompt": "{{诱饵场景}}",
      "expected_behavior": "不应激活本 skill",
      "notes": "诱饵容错为 0"
    }
  ],
  "minimum_pass_rate": 0.8
}

适用场景与注意¶

适合谁

• 想把领域方法论书（管理、决策、学习方法等）沉淀为团队可复用的 Agent Skills 的开发者。
• 已在使用 Cursor、Claude Code、Codex 等支持 SKILL.md 的客户端，并愿意走完多阶段流水线的人。

限制与注意

• 工作量大：整书理解、五路并行提取、验证、构造、链接、压力测试，适合重要书目而非随手翻读。
• 依赖书籍原文质量与可获取性；扫描版 PDF 需先保证 Agent 能稳定读取文本。
• 需要支持 Agent 工具的环境，否则阶段 1 的并行 sub-agent 需人工拆分。
• 与 nuwa-skill（蒸馏人）、darwin-skill（进化 skill）分工不同，选型时按官方边界区分。

SkillHub 页面数据（2026-10-21 抓取）：评分 100000，下载 6446，安装 0；以 SkillHub 技能页 实时数据为准。

结尾¶

「拆书成技能」把读书笔记与 Agent 可执行技能之间的缺口，用 RIA-TV++ 流水线、三重验证和 darwin 兼容测试补齐。若你的目标是让一本书的方法论在真实任务里被稳定触发，而不是留在笔记里，可以从单本试点开始，按官方 SOP 产出 books/<book-slug>/ 目录。

• SkillHub 技能页：https://www.skillhub.cn/skills/user_1a7e2e57/cangjie-distill
• API 坐标页：https://api.skillhub.cn/user_1a7e2e57/cangjie-distill
• 安装说明：https://skillhub.cn/install/skillhub.md