textbook-chapter
按四段式模板写一章教材正文：概念讲解 → 示范（教）→ 引导（扶）→ 独立（放）四段，外加章引言与本章小结。章结构的权威来源是 references/chapter-template.md，文体规范是 references/writing-style.md。
四段的标题文案、后三段的具体教学动作、配图类型与文体附加条款取自输入契约里 学科档案 指定的档案第 4 节——规格与索引见 ../textbook/references/subject-profile-spec.md，开写前先读该档案第 4 节。
何时不触发
- 设计教材大纲（用 textbook-outline）
- 全书多章调度（用 textbook）
- 只要题目不要正文（用 textbook-exercises）
两种调用模式
- 被 textbook 调度（常规）：输入 = 契约
{章号, 章标题, 该章大纲切片, UbD五件套, 术语表, 前章小结, 学科档案, 答案排版}（字段定义见 ../textbook/references/handoff-contract.md 第 2 节；第 1 章的前章小结为空）。
- 独立触发（写深度技术文章）：
答案排版 恒为 inline（没有教材项目目录，答案无处可搬）；一轮问清 {主题, 读者水平, 篇幅}；按主题自行判定学科档案（索引见 subject-profile-spec.md 第 5 节，找不到匹配项按该文档第 7 节处理）；自拟轻量版五件套（只取三件）——1 条持久理解（"读者将理解：……"句式）+ 1 个核心问题 + 1–3 条学习目标（章首学生版目标的来源），连同选定的档案 id 一并向用户展示后开写（不设 gate，展示即可）；无外部术语表时自建（两节结构与列定义同契约文档第 3 节，附加结构按档案第 4 节），无前章小结则引言直接从动机切入。
上下文隔离纪律（不可违反）
只接收上述输入契约，不读入其他章正文。跨章一致性靠三个轻量载体：术语表、前章小结、UbD 五件套（契约文档第 6 节）。"顺便读一下前几章找感觉"是违规——上下文膨胀会让长教材写不完。
写作流程
打印进度：被调度时打印 ▶ 第 N/M 章：<章标题>；独立触发时打印章标题。
起草章骨架：按 references/chapter-template.md 第 2 节的完整模板起草——
- 引言：从前章小结的核心结论衔接进入，呼应五件套中的一条核心问题，先"为什么"再"学什么"；
## 本章学习目标（章首件，任何档案下标题都是这一行）：把大纲切片里"该章承载的学习目标原文"改写成学生版——第二人称、去掉编号与 Bloom 标注、保留可判断的动词，条数与切片给的一样多，不新增不合并（要点见 references/chapter-template.md 3.0 节）。独立触发时切片不存在，从自拟的持久理解推出 1–3 条；- 第一段（
stem 档案为 ## N.1 概念讲解）：按大纲切片中该章定位与承载的持久理解展开，每个概念走"动机 → 定义 → 直观解释 → 关系"链条；
- 全程遵循 references/writing-style.md：叙事散文、认知负荷控制（一段一个新概念）、配图双轨（抽象概念配示意图，纯概念章至少一图）、措辞禁忌（禁"显然/易得"跳步）、中文排版；外加档案第 4 节的文体附加条款（
stem 档案 = writing-style.md 第 13 节数学公式规范）。
生成三类题：使用 Skill 工具调用 textbook-exercises（传入契约 {章上下文, 题目计划, 术语表, 学科档案}，其中章上下文的概念清单与学习目标从大纲切片提取，学科档案原样透传）；若 Skill 工具不可用或未注册，直接读取 ../textbook-exercises/SKILL.md 并严格遵循其指令执行。将返回题目按类型放入后三段（类型 → 段的对应关系固定：示范例题 → 第二段、引导练习 → 第三段、独立习题 → 第四段；段标题文案取自档案第 4 节），保持验证状态与验证过程代码块原样，不改动已验证解答的数值。
按 答案排版 摆放答案（separate 时；inline 时跳过本步，一切照旧写在题干之后）：
- 引导练习：提示 1 / 提示 2 / 完整解答三层各套一个
<details> 折叠，留在章内（写法见 chapter-template.md 3.3 节）；
- 独立习题：章内只留题干与 Bloom 标注，把
{参考答案或解题路径, 验证状态, 验证过程} 三件整体摘出放进回报字段 本章独立习题答案[]，由主 skill 写入 98-参考答案.md——只摘答案而把验证过程留在章内即泄底，三件必须一起走；
- 示范例题一动不动：解答与验证留在章内、不折叠——它是 worked example 先行的教学内核，藏起来等于毁掉第二段。
- 论述类题的评价标准表与「开放题」标记留在章内（那是任务说明不是答案），参考要点随答案走。落位边界见契约文档 3.1 节。
写本章小结：按 chapter-template.md 3.5 节固定四件——核心结论（3–5 条，面向下一章作者）、与持久理解的呼应（一句话说明本章推进了哪条）、自检（把章首学习目标逐条原句搬下来写成 - [ ] 复选项，每条给"回看 N.x"与"自测：习题 N-y"两个出口，题号必须在本章真实存在）、下一章预告（1 句）。
落盘与自查：写入 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 重新验证。
1---2name: textbook-chapter3description: 按大纲切片与 UbD 锚点写一章教材正文时用它：固定四段式结构——概念讲解 → 示范例题 → 引导练习 → 独立习题。触发语如"写第三章"、"按大纲写这一章"。通常由 textbook 调度，也可单独运行，用来写一篇带完整例题的深度技术文章。不负责设计大纲，也不负责整本书的调度；只是问一个知识点、要一段解释而不是成篇教材内容时，也不要用它。需与 textbook 系列其余 skill 装在同一 skills 目录下。4---56# textbook-chapter78按四段式模板写一章教材正文：概念讲解 → 示范（教）→ 引导（扶）→ 独立（放）四段，外加章引言与本章小结。章结构的权威来源是 [references/chapter-template.md](references/chapter-template.md)，文体规范是 [references/writing-style.md](references/writing-style.md)。910四段的**标题文案**、后三段的**具体教学动作**、配图类型与文体附加条款取自输入契约里 `学科档案` 指定的档案第 4 节——规格与索引见 [../textbook/references/subject-profile-spec.md](../textbook/references/subject-profile-spec.md)，开写前先读该档案第 4 节。1112## 何时不触发1314- 设计教材大纲（用 textbook-outline）15- 全书多章调度（用 textbook）16- 只要题目不要正文（用 textbook-exercises）1718## 两种调用模式1920- **被 textbook 调度**（常规）：输入 = 契约 `{章号, 章标题, 该章大纲切片, UbD五件套, 术语表, 前章小结, 学科档案, 答案排版}`（字段定义见 [../textbook/references/handoff-contract.md](../textbook/references/handoff-contract.md) 第 2 节；第 1 章的前章小结为空）。21- **独立触发**（写深度技术文章）：`答案排版` 恒为 `inline`（没有教材项目目录，答案无处可搬）；一轮问清 `{主题, 读者水平, 篇幅}`；按主题自行判定学科档案（索引见 subject-profile-spec.md 第 5 节，找不到匹配项按该文档第 7 节处理）；自拟**轻量版五件套**（只取三件）——1 条持久理解（"读者将理解：……"句式）+ 1 个核心问题 + 1–3 条学习目标（章首学生版目标的来源），连同选定的档案 id 一并向用户展示后开写（不设 gate，展示即可）；无外部术语表时自建（两节结构与列定义同契约文档第 3 节，附加结构按档案第 4 节），无前章小结则引言直接从动机切入。2223## 上下文隔离纪律（不可违反）2425只接收上述输入契约，**不读入其他章正文**。跨章一致性靠三个轻量载体：术语表、前章小结、UbD 五件套（契约文档第 6 节）。"顺便读一下前几章找感觉"是违规——上下文膨胀会让长教材写不完。2627## 写作流程28291. **打印进度**：被调度时打印 `▶ 第 N/M 章：<章标题>`；独立触发时打印章标题。302. **起草章骨架**：按 [references/chapter-template.md](references/chapter-template.md) 第 2 节的完整模板起草——3132 - 引言：从前章小结的核心结论衔接进入，呼应五件套中的一条核心问题，先"为什么"再"学什么"；33 - `## 本章学习目标`（章首件，任何档案下标题都是这一行）：把大纲切片里"该章承载的学习目标原文"改写成学生版——第二人称、**去掉编号与 Bloom 标注**、保留可判断的动词，条数与切片给的**一样多**，不新增不合并（要点见 [references/chapter-template.md](references/chapter-template.md) 3.0 节）。独立触发时切片不存在，从自拟的持久理解推出 1–3 条；34 - 第一段（`stem` 档案为 `## N.1 概念讲解`）：按大纲切片中该章定位与承载的持久理解展开，每个概念走"动机 → 定义 → 直观解释 → 关系"链条；35 - 全程遵循 [references/writing-style.md](references/writing-style.md)：叙事散文、认知负荷控制（一段一个新概念）、配图双轨（抽象概念配示意图，纯概念章至少一图）、措辞禁忌（禁"显然/易得"跳步）、中文排版；外加档案第 4 节的文体附加条款（`stem` 档案 = writing-style.md 第 13 节数学公式规范）。363. **生成三类题**：使用 Skill 工具调用 `textbook-exercises`（传入契约 `{章上下文, 题目计划, 术语表, 学科档案}`，其中章上下文的概念清单与学习目标从大纲切片提取，学科档案原样透传）；若 Skill 工具不可用或未注册，直接读取 [../textbook-exercises/SKILL.md](../textbook-exercises/SKILL.md) 并严格遵循其指令执行。将返回题目**按类型**放入后三段（类型 → 段的对应关系固定：示范例题 → 第二段、引导练习 → 第三段、独立习题 → 第四段；段标题文案取自档案第 4 节），保持验证状态与验证过程代码块原样，不改动已验证解答的数值。374. **按 `答案排版` 摆放答案**（`separate` 时；`inline` 时跳过本步，一切照旧写在题干之后）：38 - 引导练习：提示 1 / 提示 2 / 完整解答三层各套一个 `<details>` 折叠，**留在章内**（写法见 chapter-template.md 3.3 节）；39 - 独立习题：章内只留题干与 Bloom 标注，把 `{参考答案或解题路径, 验证状态, 验证过程}` 三件**整体摘出**放进回报字段 `本章独立习题答案[]`，由主 skill 写入 `98-参考答案.md`——只摘答案而把验证过程留在章内即泄底，三件必须一起走；40 - 示范例题一动不动：解答与验证留在章内、不折叠——它是 worked example 先行的教学内核，藏起来等于毁掉第二段。41 - 论述类题的评价标准表与「开放题」标记留在章内（那是任务说明不是答案），参考要点随答案走。落位边界见契约文档 3.1 节。425. **写本章小结**：按 chapter-template.md 3.5 节固定四件——核心结论（3–5 条，面向下一章作者）、与持久理解的呼应（一句话说明本章推进了哪条）、**自检**（把章首学习目标逐条原句搬下来写成 `- [ ]` 复选项，每条给"回看 N.x"与"自测：习题 N-y"两个出口，题号必须在本章真实存在）、下一章预告（1 句）。436. **落盘与自查**：写入 `NN-<章标题>.md`（NN 为两位章号）；按 chapter-template.md 第 5 节章内自查清单逐项自查（第 3 条的题号对账与第 7 条的答案落位尤其要动手搜一遍），不过的当场修正后再交付。4445## 输出4647回报契约 `{章文件路径, 新增术语[], 新增符号[], Bloom标注回写[], 本章独立习题答案[]}`：4849- **新增术语**：本章首次引入的概念，按术语表「## 术语」节格式（`| 术语（中文） | 英文 | 定义/约定 | 首次出现章节 |`）写好词条——调用方负责追加进术语表.md，独立触发时直接更新自建术语表；50- **新增符号**：本章首次约定的符号，按「## 符号约定」节格式（`| 符号 | 读法 | 含义与约定 | 首次出现章节 |`）写好词条。**凡在本章正文或题目里首次出现、且读者可能不知道怎么念或代表什么的记号都要登记**（$A^{\mathsf T}$、$\langle x,y\rangle$、$\varepsilon_d$……），不登记它就只存在于本章上下文里，读者在第 7 章重逢时无处可查；输入的术语表里已有同义符号时沿用旧符号、不新造，此数组只放真正的新增。本学科不使用形式符号时为空数组；51- **Bloom标注回写**：本章每道题的 `{题目编号, 类型, Bloom层级}`，供主 skill 阶段 5 复核实际梯度；52- **本章独立习题答案**：`答案排版=separate` 时本章每道独立习题的 `{题目编号, 参考答案或解题路径, 验证状态, 验证过程}`，调用方负责追加进 `98-参考答案.md`；`inline` 时此数组为空（答案已写在章内）。条目数必须等于章内独立习题数，题目编号逐字对应；53- 撰写中若发现大纲切片的题目计划有明显缺口（如某学习目标无题覆盖），在回报中附建议，由调用方/作者决定，不擅自加题。5455## 真实性约束5657- 概念讲解中的事实性内容基于大纲切片与已确认的教材设计，不虚构学科结论；拿不准的表述从保守（"通常""在本书讨论的范围内"），或在回报中注明请作者确认；58- 例题验证责任在 textbook-exercises，本 skill **不得改动已验证解答的数值**；如需改写题目文字表述，改后必须请 textbook-exercises 重新验证。
cabbage2000-lab