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 节数学公式规范)。
3. 生成三类题:使用 Skill 工具调用textbook-exercises(传入契约{章上下文, 题目计划, 术语表, 学科档案},其中章上下文的概念清单与学习目标从大纲切片提取,学科档案原样透传);若 Skill 工具不可用或未注册,直接读取 ../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 重新验证。