craft-your-textbook · 亲手打造属于你自己的教材（应试特调）

本项目是 Socratopia（破卷） 生态的衍生项目，是其"造书"环节的方法论沉淀，已固化为一个可复用的 skill。

让你具备亲手为自己造一本教材的能力——把一本教材（或一个领域的知识）加工成 AI 老师能拿去上课的教学蓝本。有教师用书时，造出来的书还能直接针对应试（见第四节）。

📦 安装

本仓库既是 Claude Code 插件市场（marketplace），也直接包含 skill 本体，三种用法任选。

方式一 · 插件市场（推荐，可一键更新）——在 Claude Code 里：

/plugin marketplace add xx-hub/craft-your-textbook
/plugin install craft-your-textbook@craft-your-textbook

更新 /plugin marketplace update craft-your-textbook；卸载 /plugin uninstall craft-your-textbook。

方式二 · clone 到 skills 目录——适合想改源码、或不用插件市场的人。先 clone 仓库，再把里面的 skills/craft-your-textbook/ 这个文件夹放进 Claude Code 的 skills 目录：

# 1. 先 clone 到任意临时位置
git clone https://github.com/xx-hub/craft-your-textbook.git

# 2a. 装成「用户级」——所有项目都能用
#    类 Unix / macOS：
cp -r craft-your-textbook/skills/craft-your-textbook ~/.claude/skills/
#    Windows（Git Bash）：
cp -r craft-your-textbook/skills/craft-your-textbook "$HOME/.claude/skills/"

# 2b. 或装成「项目级」——只在某个项目里可用
cp -r craft-your-textbook/skills/craft-your-textbook <你的项目>/.claude/skills/

装完的正确样子（用户级为例）：

~/.claude/skills/craft-your-textbook/
├── SKILL.md          # ← 必须在这一层
├── README.md
├── references/
└── scripts/

想跟随仓库更新，可以不用 cp 而用软链接（类 Unix）： ln -s "$(pwd)/craft-your-textbook/skills/craft-your-textbook" ~/.claude/skills/craft-your-textbook， 之后仓库 git pull 就自动生效。

方式三 · 下载 zip：在 GitHub 页面 Code → Download ZIP，解压后同样把 skills/craft-your-textbook/ 文件夹放进 ~/.claude/skills/（用户级）或 <项目>/.claude/skills/（项目级）。

⚠️ 最终要让 SKILL.md 位于 .../.claude/skills/craft-your-textbook/SKILL.md。本仓库里 skill 本体在 skills/craft-your-textbook/ 子目录下（插件市场结构要求），别把仓库根整个拷进去。

验证：在 Claude Code 里说"帮我造一本 XX 教材的教学蓝本"能被识别即成功。 依赖：Phase 0 的 PDF→Markdown 用 MinerU 在线 API，需自备 API Token（见第六节）；脚本需 Python 3 + requests。

一、Socratopia（破卷）是什么

Socratopia（破卷） 是一款把学习过程 chat 化的 AI 家教产品——读书破万卷的破卷，打破内卷的破卷，虚拟伙伴破卷而出相伴左右的破卷。

它的核心洞察来自一个亲历体验：人向 AI 提问时，比读教材专注得多。于是与其让学生埋头读书，不如让学生跟一位 AI 老师对话，由 AI 老师全程用苏格拉底式提问引导学生一点一点自己推理出知识的全貌——"不愤不启，不悱不发"。真人教师囿于知识广度、耐心和多人授课的局限，很难持续实践这种教学法，而 AI 可以。

这带来一个和传统电子书根本不同的三方结构：

角色 做什么 看到什么
学生（学习者） 跟 AI 老师对话学习 只看到对话，从不读书
AI 老师 读书，用引导式提问教学生 读完整本"书"作为教学输入
书（本 skill 的产物） 教学蓝本（pedagogical spec） 是 AI 老师的输入，不是给人读的终端产品

AI 老师的人设（比如活泼的三月七、严格的刻晴、温柔的甘雨）、故事背景、情感线由 Socratopia（破卷） 平台侧单独承载——本 skill 只负责造"书"，不碰教学风格。

二、核心：书是"给 AI 老师读的"

因为学生不读书、只有 AI 老师读书，所以这本"书"的每一个字都要服务于**"AI 老师会怎么用它上课"**，而不是"读者读到这里会有什么感受"。

这是最容易犯的根本错误——把蓝本当成给人读的书来写：开篇写个吸引读者的钩子（可读者根本不读）、通篇用"你"跟读者对话（可"你"到底指谁？）。

本 skill 把"教学蓝本该怎么写"这件事拆成了可执行的方法论。蓝本对 AI 老师有四个功能：

  1. 内容锚定 —— 防止 AI 老师跑题、幻觉
  2. 知识结构 —— 给出一条推理主线
  3. 弹药库 —— 具体案例、例题、词条随取随用
  4. 提问路线图 —— 用什么问题把学生引导到知识点

整本蓝本按 7 板块单元模板组织：🎬 场景 / 🧭 你将学会 / 📌 知识锚定 / 💬 苏格拉底引导方向 / 🎯 弹药库 / 🔗 与后续单元的连接 / 📐 AI 老师备课要点。其中只有 🎯 弹药库按学科定制，其余六块所有学科通用。

三、理念要点

  • 非对话体：蓝本只给"场景 + 知识点 + 提问路线图"，绝不写死"老师说……学生答……"的对话脚本——写死了 AI 老师会照抄，教学就死了。
  • 先推导后命名：概念锚点处让学生先推理，等他自己走到某个东西，再告诉他"这叫 X"。
  • 跨单元引用贯穿始终：写第 1 单元时就标注第 2/3 单元会如何用到这个知识点，AI 老师才能跨节串讲。
  • 交付前必拆脚手架：版本标记、自检清单、修订日志、"教师用书说……"这类造书过程元数据，对只读一本书的 AI 老师零价值，交付前必须拆干净。
  • 多轮迭代是常态：平均每本书 5-7 轮审校，不要期待一次成型。

四、可以直接针对应试（这也是为什么反复要教师用书）

造出来的蓝本不只是"讲懂知识"，它可以直接服务于应试——这正是我们反复强调"务必要到教师用书"的原因。

学生用书只呈现知识本身，而教师用书里藏着应试的全部密码：

  • 评价标准与教学目标 —— 明确告诉你"学完这一单元，学生要能做到什么、考到什么程度"，这就是命题的靶心。
  • 学情分析与常见错误 —— 预判了学生在哪里会栽跟头，直接转化成蓝本里的 💬 陷阱暴露问题和 📐 坑型表，让 AI 老师专挑易错点操练。
  • 考点与题型提示 —— 哪些是重点、哪些是难点、常以什么题型考查，让 AI 老师把力气花在真正得分的地方。
  • 语法/知识详解 —— 比学生用书深一层的讲解，兜住 AI 老师的"正确答案"，考场上不会讲错。

有了教师用书，AI 老师就不只是"陪你把知识学明白"，而是能带着明确的评价标准和考点意识，把你一步步引导到应试要求的水平——既保留了苏格拉底式引导"愿意学、学得深"的优势，又不脱离考试这根现实的指挥棒。这是单靠学生用书做不到的，也是师生合版被设为默认流程的根本原因。

五、适用范围

任何学科——英语、语文、数学、物理、历史、编程……都能用。7 板块骨架与学科无关；只有 🎯 弹药库需要按学科换内容（语言类放词汇/音标/语法，理科放公式/定理/例题，文史放史实/人物/时间线）。词汇、音标、生词分层策略仅语言类教材需要，其他学科直接跳过。

六、怎么用

触发

对 Claude Code 说类似这样的话即可触发：

  • "帮我造一本 XX 教材的教学蓝本"
  • "按这套造书方法做一本新书"
  • "复刻这个 skill 的写法做一本 XX"

造书模式：默认师生合版，逐级降级

触发后第一步是定模式，按优先级从上往下选，越靠上越好：

优先级 模式 源材料 何时用
① 默认 师生合版 学生用书 + 教师用书 能拿到两份就用；主动向用户要教师用书
② 次选 单一 Mode B 一份 PDF/教材 只有一份，且先确认这份是学生版还是教师版
③ 兜底 Mode A（从零造） 无 仅当用户明确说"什么素材都没有"

绝不要因为"手头暂时没找到源"就跳到从零造——先穷尽 ① ②。（师生合版的应试价值见第四节。）

全流程（Phase 0 → 9）

0   PDF → Markdown（MinerU 在线 API，需先申请 apikey）
0.5 差异报告（仅师生合版）
1   大纲先行（知识链 + 跨单元关联表）
2   先写一节金标准，跑 L5 教学测试
3   并行铺其余单元（每个 agent 必读金标准）
4   附录
5   跨单元审计
6   合并为 BOOK.md
7   终检（禁用词/乱码/板块/引用/坑型编号）
8   拆脚手架（交付前硬门）
9   交付质量门（6 项全绿才交付）

⚠️ 开工前置：申请 MinerU API Token

PDF→Markdown 默认走 MinerU 在线 API。人需要手动做的只有一步——拿到 Token（其余装依赖、复制脚本等由 skill 自动完成）：

  1. 打开 https://mineru.net 注册/登录，申请 API Token（有免费额度）
  2. 设为环境变量（切勿硬编码进脚本）：export MINERU_TOKEN="你的token"

七、目录结构

craft-your-textbook/
├── SKILL.md                        # 主入口：模式决策 + Phase 0→9 全流程导航
├── README.md                       # 本文件
├── references/                     # 按需加载的细则
│   ├── outline-and-analysis.md     # 分析源 MD + 大纲五项 + 差异报告 + 附录写法（Phase 0.5/1/4）
│   ├── unit-template.md            # 7 板块模板 + 四条设计原则 + 弹药库按学科定制 + 禁用词
│   ├── vocabulary-strategy.md      # 生词 L1-L4 分层 + 三动作（仅语言类）
│   ├── audit-and-testing.md        # 五层审计 + L5 教学测试 + 幻觉 gate
│   ├── delivery-checklist.md       # Phase 7 终检 + 拆脚手架 8 类元数据 + 6 项质量门
│   └── anti-patterns.md            # 反模式速查 + 工程陷阱
└── scripts/                        # 示例脚本模板——造书时复制进项目再按本书改
    ├── 01_pdf_to_md.py             # Phase 0：MinerU API 转 Markdown（token 走环境变量）
    ├── merge_book.py               # 合并单元 + 附录为 BOOK.md（可重跑）
    ├── strip_meta_sections.py      # Phase 8：拆脚手架（可重跑）
    └── requirements.txt            # 脚本依赖（requests）

八、延伸：教育范式，从"灌输"走向"引导"

这一节是本 skill 背后的信念。急着上手可以跳过，但它解释了"为什么值得费这个劲造书"。

如果"人本具足"这一哲学理念是真的——每个人内在本就具备通往知识的能力，教育的本分是把它引出来而非填进去——那么教育在实践中就真的该从 "indoctrinate（灌输）" 走向 "educate（引导）" 了。（educate 的拉丁词根 educere 本义正是"引出"。）

可过去为什么做不到？因为引导是昂贵的。真正的引导要求教师针对每一个个体定制课程、随时陪伴推理。一个学生每天全职学习 8 小时，就需要一位教师全职陪伴 8 小时，再加备课——这意味着教师数量要大于、甚至远大于学生数量。这样的成本，社会根本无法承担。于是世界上绝大多数教学方式，只能是灌输式的：一个老师对着几十个学生讲，把知识"倒"过去。不是不想引导，是引导不起。

AI 的出现，尤其是基于 AI 的新学习方法的出现，第一次让另一种范式成为可能。 它提供了三件过去买不起的东西：

  1. 完全定制化的私人教材 —— 为你以及你的孩子一个人量身裁剪。
  2. 完全定制化的私人教师 —— 全天候、无限精力地陪你或你的孩子。
  3. 最适合你的引导方法 —— 不只是"学得更快"，更是让你和你的孩子愿意一直学下去、再学下去的动力。

也就是说，AI + 教育，让任何一个人（无论是具备基础认知能力的孩子，还是成人）终于有机会获得一位全天候、精力无限的私人教师，而雇佣这位教师几乎不花什么钱。于是每个人都能以远超从前的速度，学习他想学的任何内容。

已经在实践中被解决的问题

问题 解法
AI 幻觉怎么办？ 把待学教材放进 AI 上下文，要求它沿教材主线教学——这正是本 skill 造"教学蓝本"的意义，极大压制了幻觉。
学习自驱力怎么来？ 把自己和 AI 老师放进一个有趣的世界观里（比如"靠学习统一世界""老师靠教学回到现实"）。世界观一有趣，学习就从负担变成动力。
教材从哪来？ 除了现成教材，LLM 训练时几乎吸收了人类的全部知识；对 LLM 再蒸馏，就能为几乎任何人做出质量不错的教材。
想学的内容 LLM 不具备怎么办？ 以特定素材为蓝本，用 LLM 定制适配新学习法的教材——甚至可以大胆做跨学科学习，这恰恰是传统教学最欠缺的。
老师会不会不愿意教我？ AI 老师永远保持耐心、永远精力充沛。
还能扩展什么？ AI 时代，超出你的想象。

本 skill 正是上表第一行的落地工具：把一份素材加工成"AI 老师能沿主线教学、不跑题、不幻觉"的教学蓝本——是"从灌输走向引导"这条路上，最基础的一块砖。

九、一句话总结

书是给 AI 苏格拉底老师的教学蓝本，学生不读书、只跟 AI 老师对话。所有规则都按"AI 老师会怎么用这一块"来设计——默认师生合版起步，先出大纲再写金标准，交付前拆干净脚手架，6 项质量门全绿才算完。

十、对造出来的书不放心？先测一测

如果你对造出来的书感到不信任，可以用 socratic-lens 项目对它做测试——把蓝本喂给它，检验 AI 老师是否真的能沿主线教学、不跑题、不幻觉，再决定要不要正式拿去上课。

socratic-lens 项目已内置由本skill制作的为 七年级上册·教研版 学生开发的英语书，开箱即测。

十一、上手 Socratopia（破卷）

想亲身体验 AI 苏格拉底老师的教学，去 www.socratopia.app 下载 Socratopia。注册时输入邀请码 SCR-FEJXMQ，即可领取：

  • 免费用户 → 立即获得 100 万 Token
  • 坐馆订阅用户 → 获得 1 书币（价值 $3.99）