mcpField
B
book-to-skill

book-to-skill

github.com/huntsyeaAgent 工作流3197 次安装39 周前更新
代码仓库

关于 book-to-skill

book-to-skill 将书籍内容转化为可执行的 Claude Code 技能,提取框架、原则、技巧、反模式和作者风格,而非撰写摘要。支持完整转换、仅分析提取,以及依据已有分析生成技能。

主要功能

  1. 01提取框架与原则
  2. 02整理分步技巧
  3. 03识别反模式与作者风格
  4. 04支持仅分析或完整生成
  5. 05提示转换非 TXT 格式

适用场景

  1. 01将 TXT 书籍转为可复用技能
  2. 02生成技能前审阅提取内容
  3. 03依据已有分析生成技能文件

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/huntsyea/thinking-skills --skill book-to-skill

安装后在 Claude Code 中输入/book-to-skill确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
extraction-patterns.md
reference-file-templates.md
skill-patterns.md
workflows/
analyze-book.md
convert-book.md
convert-formats.md
generate-skill.md

详细介绍

图书转技能工具

将书面知识转化为可执行的 Claude Code 技能。

理念

我将书籍中凝练的专业知识——框架、原则和技巧——提取出来,转化为可反复运用的格式,从而将书籍转化为可执行的技能。

我提取结构,而非摘要。 技能不是读书报告,而是一套工具包,包含:

  • 命名框架(适用方式明确的思维模型)
  • 可执行原则(指导决策的规则)
  • 技巧(分步骤的方法)
  • 反模式(应避免的做法及原因)
  • 作者风格校准(作者的思考与表达方式)

我保留作者的严谨表述。 框架通常有特定名称和结构,背后自有原因。“5 Whys”不能简单替换成“多问几次为什么”。我会准确记录其表述。

我针对调用场景进行优化。 生成的技能应当能立即派上用场。调用 /author-method 时,用户应获得可执行的指导,而非哲学观点。

我根据需要安排内容深度。 内容简单的书籍对应简单的技能。包含 10+ 个框架的复杂书籍,则对应带有参考文件的路由技能。

支持的格式

主要格式: .txt 文件可直接使用此技能处理。

需要转换: epub、pdf、mobi、docx

分析其他格式的书籍前,请先将其转换为 .txt:

# EPUB → TXT
ebook-convert book.epub book.txt

# PDF → TXT
pdftotext book.pdf book.txt

完整说明和依赖项请参阅 workflows/convert-formats.md。

如何开始

有以下三种方式:

1. 完整转换(默认)

触发条件: 用户提供 .txt 书籍文件 操作: 转到 workflows/convert-book.md 输出: 包含所有文件的完整技能

2. 仅分析

触发条件: 用户说“分析”或“只提取”,或希望在生成前先进行审核 操作: 转到 workflows/analyze-book.md 输出: 结构化提取报告(不生成技能)

3. 根据先前的分析生成

触发条件: 用户已有分析笔记,或之前运行过仅分析流程 操作: 转到 workflows/generate-skill.md 输出: 根据提供的分析生成技能文件

路由逻辑

IF user provides non-.txt file (epub, pdf, mobi, docx):
  → Point to workflows/convert-formats.md first

IF user provides .txt book file path:
  IF "analyze only" or "just analyze" in request:
    → workflows/analyze-book.md
  ELSE:
    → workflows/convert-book.md

IF user mentions "generate" or "create skill" with analysis notes:
  → workflows/generate-skill.md

IF unclear:
  Ask: "Do you want to:
  1. Convert a book to a skill (provide .txt path)
  2. Analyze a book without generating (provide .txt path)
  3. Generate a skill from existing analysis"

提取类别请参阅 references/extraction-patterns.md。 输出结构模式请参阅 references/skill-patterns.md。

要询问的问题

对以下每项使用 AskUserQuestion 工具:

  1. 用途(分析前):

    • 问题:“这项技能应该帮助你做什么?”
    • 选项:模仿作者写作 | 应用作者的框架 | 运用作者的思维模型思考 | 按照作者的方法构建 | 以上全部
  2. 技能名称(分析后):

    • 问题:“这项技能应该叫什么名字?”
    • 建议使用 {author-lastname}-{core-concept} 格式
    • 示例:cialdini-influence、meadows-systems、kahneman-decisions
  3. 范围(提取后):

    • 展示提取内容摘要
    • 问题:“技能中应包含哪些内容?”
    • 选项:所有提取内容 | 仅特定框架 | 由我指定
  4. 参考资料深度:

    • 问题:“参考资料应当有多全面?”
    • 选项:仅基础内容(关键框架)| 全面(所有框架和原则)| 穷尽(所有提取内容)

评论

支持 Markdown