craft-your-textbooklisted

# 亲手造属于你自己的教材（Craft Your Textbook） ## 这是什么 造书 = 为学习者制备一份**教材**。有两种形态（触发后必选，见下"第一步：定路线"）： - **pure-blueprint**：给 AI 苏格拉底老师读的教学蓝本（pedagogical spec），结构化、含元指令 - **human-readable**：给人读的流畅教材，AI 拿到也能直接教 三方分工决定所有下游规则： | 角色 | 做什么 | 看到什么 | |---|---|---| | **用户（学习者）** | 跟 AI 老师对话学习 | 只看到对话（blueprint）或读教材+对话（human-readable） | | **AI 老师** | 读书，用引导式提问教学 | 读完整本书作为输入 | | **书（造物）** | 教学素材 | 是 AI 老师的输入，或人读的教材 | **最常见的根本错误**：把书写成"给读者感受的文学作品"——开篇钩子写给谁看？"你"指谁？写每一块前先问："AI 老师/人读到这块会怎么用它？" 书对 AI 老师的四个功能：①**内容锚定**（防跑题/幻觉）②**知识结构**（推理主线）③**弹药库**（案例随取随用）④**提问路线图**（引导学生抵达知识点的问题方向）。 ## 何时用 - 用户要把教材/领域知识做成 AI 能教的书或人读的教材 - 用户说"造一本书""做一本教材""按这套方法写 XX" - 需要从 PDF 教材加工出结构化教学素材 **第一步：定路线**（触发后必须问，不替用户默认）： > "这本书是喂给 AI 苏格拉底老师教学用的教学蓝本（推荐——AI 教学精度最高），还是一本给人读的流畅教材（AI 也能直接拿它教，但教学约束更少）？" 决策启发式： 1. 用户原话含"我自��读/出版/给别人看/当书出/通读/给真人教师/我想先通读" → human-readable 2. 书要喂给已成型的苏格拉底 AI 软件（Socratopia 等） → pure-blueprint 3. 用户不确定 → 推荐 pure-blueprint 并等拍板 路线差异和细节见 `references/two-routes.md`。 ## 全流程导航（6 阶段） 先出设计，再写正文；先写一章金标准审到满意，再并行铺开。平均每本书 5-7 轮审校。 | 阶段 | 名称 | 做什么 | 产出 | |---|---|---|---| | **Phase 1** | 源材料准备 | PDF→MD（MinerU API）+ 复制脚本进项目 + 装依赖 | `sources-md/`、`scripts/` | | **Phase 2** | 源探查 | 所有有源书必走：摸源结构、角色标签、简码表、权威层级 | `源材料索引.md` 第一层 | | **Phase 3** | 教学设计 | **核心阶段**：五步设计（见下）+ 三个用户确认关卡 | META/OUTLINE/style-spec/源材料索引 | | **Phase 4** | 金标准验证 | 选一章按设计的语法写 → 五层审计（含 L5 教学测试）→ 通过后回填 style-spec | 金标准章 md | | **Phase 5** | 全量写作+收网 | 5.1 sub-agent 并行铺章 → 5.2 附录汇编 → 5.3 跨章审计 → 5.4 合并 BOOK.md（human-readable 注入 loader 指令） |