textbook-chapterlisted
Install: claude install-skill cabbage2000-lab/textbook-writer-skills
# textbook-chapter
按四段式模板写一章教材正文:概念讲解 → 示范例题 → 引导练习 → 独立习题,外加章引言与本章小结。章结构的权威来源是 [references/chapter-template.md](references/chapter-template.md),文体规范是 [references/writing-style.md](references/writing-style.md)。
## 何时不触发
- 设计教材大纲(用 textbook-outline)
- 全书多章调度(用 textbook)
- 只要题目不要正文(用 textbook-exercises)
## 两种调用模式
- **被 textbook 调度**(常规):输入 = 契约 `{章号, 章标题, 该章大纲切片, UbD五件套, 术语表, 前章小结}`(字段定义见 [../textbook/references/handoff-contract.md](../textbook/references/handoff-contract.md) 第 2 节;第 1 章的前章小结为空)。
- **独立触发**(写深度技术文章):一轮问清 `{主题, 读者水平, 篇幅}`;自拟**轻量版五件套**(只取两件)——1 条持久理解("读者将理解:……"句式)+ 1 个核心问题,向用户展示后开写(不设 gate,展示即可);无外部术语表时自建(格式同契约文档第 3 节的术语表列定义),无前章小结则引言直接从动机切入。
## 上下文隔离纪律(不可违反)
只接收上述输入契约,**不读入其他章正文**。跨章一致性靠三个轻量载体:术语表、前章小结、UbD 五件套(契约文档第 6 节)。"顺便读一下前几章找感觉"是违规——上下文膨胀会让长教材写不完。
## 写作流程
1. **打印进度**:被调度时打印 `▶ 第 N/M 章:<章标题>`;独立触发时打印章标题。
2. **起草章骨架**:按 [references/chapter-template.md](references/chapter-template.md) 第 2 节的完整模板起草——
- 引言:从前章小结的核心结论衔接进入,呼应五件套中的一条核心问题,先"为什么"再"学什么";
- `## N.1 概念讲解`:按大纲切片中该章定位与承载的持久理解展开,每个概念走"动机 → 定义 → 直观解释 → 关系"链条;
- 全程遵循 [references/writing-style.md](references/writing-style.md):叙事散文、认知负荷控制(一段一个新概念)、配图双轨(抽象概念用 mermaid/SVG,纯概念章至少一图)、措辞禁忌(禁"显然/易得"跳步)、中文排版。
3. **生成三类题**:使用 Skill 工具调用 `textbook-exercises`(传入契约 `{章上下文, 题目计划, 术语表}`,其中章上下文的概念清单与学习目标从大纲切片提取);若 Skill 工具不可用或未注册,直接读取 [../textbook-exercises/SKILL.md](../textbook-exercises/SKILL.md) 并严格遵循其指令执行。将返回题目按类型放入 `## N.2 示范例题`、`## N.3 引导练习`、`## N.4 独立习题`,保持验证状态与复算代码块原样,不改动已验证解答的数值。
4. **写本章小结**:按