# Textbook Chapter

> 按大纲切片与 UbD 锚点写一章教材正文时用它：固定四段式结构——概念讲解 → 示范例题 → 引导练习 → 独立习题。触发语如"写第三章"、"按大纲写这一章"。通常由 textbook 调度，也可单独运行，用来写一篇带完整例题的深度技术文章。不负责设计大纲，也不负责整本书的调度；只是问一个知识点、要一段解释而不是成篇教材内容时，也不要用它。需与 textbook 系列其余 skill 装在同一 skills 目录下。

- Skill: `cabbage2000-lab/textbook-chapter` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add cabbage2000-lab/textbook-chapter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cabbage2000-lab/textbook-chapter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cabbage2000-lab (https://skillmd.com/u/cabbage2000-lab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cabbage2000-lab/textbook-chapter

---


# textbook-chapter

按四段式模板写一章教材正文：概念讲解 → 示范（教）→ 引导（扶）→ 独立（放）四段，外加章引言与本章小结。章结构的权威来源是 [references/chapter-template.md](references/chapter-template.md)，文体规范是 [references/writing-style.md](references/writing-style.md)。

四段的**标题文案**、后三段的**具体教学动作**、配图类型与文体附加条款取自输入契约里 `学科档案` 指定的档案第 4 节——规格与索引见 [../textbook/references/subject-profile-spec.md](../textbook/references/subject-profile-spec.md)，开写前先读该档案第 4 节。

## 何时不触发

- 设计教材大纲（用 textbook-outline）
- 全书多章调度（用 textbook）
- 只要题目不要正文（用 textbook-exercises）

## 两种调用模式

- **被 textbook 调度**（常规）：输入 = 契约 `{章号, 章标题, 该章大纲切片, UbD五件套, 术语表, 前章小结, 学科档案, 答案排版}`（字段定义见 [../textbook/references/handoff-contract.md](../textbook/references/handoff-contract.md) 第 2 节；第 1 章的前章小结为空）。
- **独立触发**（写深度技术文章）：`答案排版` 恒为 `inline`（没有教材项目目录，答案无处可搬）；一轮问清 `{主题, 读者水平, 篇幅}`；按主题自行判定学科档案（索引见 subject-profile-spec.md 第 5 节，找不到匹配项按该文档第 7 节处理）；自拟**轻量版五件套**（只取三件）——1 条持久理解（"读者将理解：……"句式）+ 1 个核心问题 + 1–3 条学习目标（章首学生版目标的来源），连同选定的档案 id 一并向用户展示后开写（不设 gate，展示即可）；无外部术语表时自建（两节结构与列定义同契约文档第 3 节，附加结构按档案第 4 节），无前章小结则引言直接从动机切入。

## 上下文隔离纪律（不可违反）

只接收上述输入契约，**不读入其他章正文**。跨章一致性靠三个轻量载体：术语表、前章小结、UbD 五件套（契约文档第 6 节）。"顺便读一下前几章找感觉"是违规——上下文膨胀会让长教材写不完。

## 写作流程

1. **打印进度**：被调度时打印 `▶ 第 N/M 章：<章标题>`；独立触发时打印章标题。
2. **起草章骨架**：按 [references/chapter-template.md](references/chapter-template.md) 第 2 节的完整模板起草——

   - 引言：从前章小结的核心结论衔接进入，呼应五件套中的一条核心问题，先"为什么"再"学什么"；
   - `## 本章学习目标`（章首件，任何档案下标题都是这一行）：把大纲切片里"该章承载的学习目标原文"改写成学生版——第二人称、**去掉编号与 Bloom 标注**、保留可判断的动词，条数与切片给的**一样多**，不新增不合并（要点见 [references/chapter-template.md](references/chapter-template.md) 3.0 节）。独立触发时切片不存在，从自拟的持久理解推出 1–3 条；
   - 第一段（`stem` 档案为 `## N.1 概念讲解`）：按大纲切片中该章定位与承载的持久理解展开，每个概念走"动机 → 定义 → 直观解释 → 关系"链条；
   - 全程遵循 [references/writing-style.md](references/writing-style.md)：叙事散文、认知负荷控制（一段一个新概念）、配图双轨（抽象概念配示意图，纯概念章至少一图）、措辞禁忌（禁"显然/易得"跳步）、中文排版；外加档案第 4 节的文体附加条款（`stem` 档案 = writing-style.md 第 13 节数学公式规范）。
3. **生成三类题**：使用 Skill 工具调用 `textbook-exercises`（传入契约 `{章上下文, 题目计划, 术语表, 学科档案}`，其中章上下文的概念清单与学习目标从大纲切片提取，学科档案原样透传）；若 Skill 工具不可用或未注册，直接读取 [../textbook-exercises/SKILL.md](../textbook-exercises/SKILL.md) 并严格遵循其指令执行。将返回题目**按类型**放入后三段（类型 → 段的对应关系固定：示范例题 → 第二段、引导练习 → 第三段、独立习题 → 第四段；段标题文案取自档案第 4 节），保持验证状态与验证过程代码块原样，不改动已验证解答的数值。
4. **按 `答案排版` 摆放答案**（`separate` 时；`inline` 时跳过本步，一切照旧写在题干之后）：
   - 引导练习：提示 1 / 提示 2 / 完整解答三层各套一个 `<details>` 折叠，**留在章内**（写法见 chapter-template.md 3.3 节）；
   - 独立习题：章内只留题干与 Bloom 标注，把 `{参考答案或解题路径, 验证状态, 验证过程}` 三件**整体摘出**放进回报字段 `本章独立习题答案[]`，由主 skill 写入 `98-参考答案.md`——只摘答案而把验证过程留在章内即泄底，三件必须一起走；
   - 示范例题一动不动：解答与验证留在章内、不折叠——它是 worked example 先行的教学内核，藏起来等于毁掉第二段。
   - 论述类题的评价标准表与「开放题」标记留在章内（那是任务说明不是答案），参考要点随答案走。落位边界见契约文档 3.1 节。
5. **写本章小结**：按 chapter-template.md 3.5 节固定四件——核心结论（3–5 条，面向下一章作者）、与持久理解的呼应（一句话说明本章推进了哪条）、**自检**（把章首学习目标逐条原句搬下来写成 `- [ ]` 复选项，每条给"回看 N.x"与"自测：习题 N-y"两个出口，题号必须在本章真实存在）、下一章预告（1 句）。
6. **落盘与自查**：写入 `NN-<章标题>.md`（NN 为两位章号）；按 chapter-template.md 第 5 节章内自查清单逐项自查（第 3 条的题号对账与第 7 条的答案落位尤其要动手搜一遍），不过的当场修正后再交付。

## 输出

回报契约 `{章文件路径, 新增术语[], 新增符号[], Bloom标注回写[], 本章独立习题答案[]}`：

- **新增术语**：本章首次引入的概念，按术语表「## 术语」节格式（`| 术语（中文） | 英文 | 定义/约定 | 首次出现章节 |`）写好词条——调用方负责追加进术语表.md，独立触发时直接更新自建术语表；
- **新增符号**：本章首次约定的符号，按「## 符号约定」节格式（`| 符号 | 读法 | 含义与约定 | 首次出现章节 |`）写好词条。**凡在本章正文或题目里首次出现、且读者可能不知道怎么念或代表什么的记号都要登记**（$A^{\mathsf T}$、$\langle x,y\rangle$、$\varepsilon_d$……），不登记它就只存在于本章上下文里，读者在第 7 章重逢时无处可查；输入的术语表里已有同义符号时沿用旧符号、不新造，此数组只放真正的新增。本学科不使用形式符号时为空数组；
- **Bloom标注回写**：本章每道题的 `{题目编号, 类型, Bloom层级}`，供主 skill 阶段 5 复核实际梯度；
- **本章独立习题答案**：`答案排版=separate` 时本章每道独立习题的 `{题目编号, 参考答案或解题路径, 验证状态, 验证过程}`，调用方负责追加进 `98-参考答案.md`；`inline` 时此数组为空（答案已写在章内）。条目数必须等于章内独立习题数，题目编号逐字对应；
- 撰写中若发现大纲切片的题目计划有明显缺口（如某学习目标无题覆盖），在回报中附建议，由调用方/作者决定，不擅自加题。

## 真实性约束

- 概念讲解中的事实性内容基于大纲切片与已确认的教材设计，不虚构学科结论；拿不准的表述从保守（"通常""在本书讨论的范围内"），或在回报中注明请作者确认；
- 例题验证责任在 textbook-exercises，本 skill **不得改动已验证解答的数值**；如需改写题目文字表述，改后必须请 textbook-exercises 重新验证。