| name | textbook-outline |
| description | Use when a textbook project needs its teaching design — 教学定位、UbD 预期结果五件套（大概念/持久理解/核心问题/迁移目标/学习目标）、章节树与例题 Bloom 梯度规划 — e.g. "设计教材大纲"、"教材规划"、"课程体系设计". Usually orchestrated by textbook; can run standalone to produce 00-教材设计.md. Not for writing chapter prose or generating exercises. |
textbook-outline
以 UbD 逆向设计完成教材的阶段 1–3：教学定位 → 预期结果设计（核心 gate）→ 评估与章节设计（次要 gate），产出 00-教材设计.md。本 skill 是"先想清楚学生该带走什么，再倒推章节和例题"的落地执行者。
何时不触发
- 写章节正文（用 textbook-chapter）
- 生成例题/习题（用 textbook-exercises）
- 单篇教程的大纲（用 tutorial-writer）
两种调用模式
- 被 textbook 调度（常规）：输入为
{教材项目目录, 教材名}；产出写入该目录，两个 gate 的确认结果回报主 skill（.progress.json 由主 skill 维护，本 skill 不碰）。
- 独立触发：先用一轮提问确认教材名与落盘目录（默认
./<教材名>/），后续流程完全相同，产出 00-教材设计.md；不建 .progress.json——那是主 skill 的职责。
交接契约、落盘布局、进度打印与 gate 停点格式的权威定义见 ../textbook/references/handoff-contract.md，下文简称"契约文档"。本 skill 的进度行 ▶ 阶段 N/3 是子 skill 内层标尺（契约文档第 5 节：N/M 中 M 为当前 skill 自身的阶段总数）；被调度时全局的 ▶ 阶段 N/5 行由主 skill 打印，两级并存。
阶段 1/3：教学定位确认
打印进度：▶ 阶段 1/3：教学定位确认
用 AskUserQuestion 一轮收集四项（对应契约 {学科, 读者认知起点, 教材深度, 篇幅规模}）：
- 学科：具体到分支（如"线性代数"而非"数学"）。用户触发时若已说明，此项不再问。
- 读者认知起点：零基础 / 有先修（注明先修什么）
- 教材深度：入门 / 进阶
- 篇幅规模：6–8 章 / 8–12 章 / 12 章以上
若当前环境没有 AskUserQuestion 工具，降级为编号提问并等待文本回复：
请回答以下问题（回复格式如 "1 线性代数 2a 3a 4b"）：
1. 教材学科（请具体到分支）？
2. 读者认知起点？ a) 零基础 b) 有先修（请注明）
3. 教材深度？ a) 入门 b) 进阶
4. 篇幅规模？ a) 6–8 章 b) 8–12 章 c) 12 章以上
按语义宽松解析回复，能定位到各项即可；无法判断时只就有歧义的一项追问。
注意：若学科属于文科论述型（历史/哲学/文学等），告知作者 v1 仅支持 STEM 概念型教材，文科为 v2 范围；作者坚持则继续走流程，但例题环节会按概念辨析题降级处理。
产出写入 00-教材设计.md 的「## 一、教学定位」，然后不停顿，直接进入阶段 2。
阶段 2/3：UbD 预期结果设计（核心 gate）
打印进度：▶ 阶段 2/3：UbD 预期结果设计
严格按 references/ubd-framework.md 设计五件套，学习目标动词查 references/bloom-levels.md 第 2 节：
- 大概念：3–7 个，每个是"主张"不是名词；
- 持久理解：一律"学生将理解：……"句式，是洞见不是知识点复述；
- 核心问题：2–5 个开放性问题，能贯穿多章；
- 迁移目标：情境必须是教材没直接教过的；
- 学习目标：每条用 Bloom 动词 + 层级标注（格式：目标句 +（Bloom：应用）），可出题检验。
呈现前先过 ubd-framework.md 第 5 节的快速自查清单（六问）和第 3 节一致性检查——自查不过先修再呈现，gate 是给作者确认方向的，不是让作者替 skill 做质检的。
完整呈现五件套后停下：
⏸ 等待确认：UbD 五件套（回复"确认"进入章节设计，或直接提出修改）
Gate 规则（不可绕过）：
- 作者提出修改 → 更新后重新完整呈现五件套（每次重新呈现前同样先过第 5 节自查与一致性检查——修改可能破坏追溯关系），再次等待确认，循环直到作者明确确认；
- 明确确认的判定见契约文档第 5 节：明确表示通过且不附带修改要求（"确认/通过/OK"等）；"确认，但把 X 改一下"按修改分支处理（修改优先）；答复含糊时追问而不是自行判定为确认；
- 未确认绝不进入阶段 3；
- 确认后将五件套写入
00-教材设计.md 的「## 二、UbD 五件套（已确认）」。
阶段 3/3：评估与章节设计（次要 gate）
打印进度：▶ 阶段 3/3：评估与章节设计
依据已确认的五件套设计四项产出（对应契约 {章节树[], 例题习题计划[], 表现性任务[], 梯度报告}）：
- 章节树：每章
{章号, 章标题, 一句话定位, 承载的持久理解编号[]}，章数符合阶段 1 的篇幅规模。
对齐检查（双向，硬性）：某章承载不了任何持久理解 → 砍掉或改造该章；某条持久理解没有任何章承载 → 补章，或向作者明示放弃该条。检查结果随章节树一并呈现。
- 例题习题计划：每章三类题的
{主题, Bloom层级} 列表，数量参考四段式配额（示范例题 1–3 / 引导练习 1–3 / 独立习题 3–8，见 ../textbook-chapter/references/chapter-template.md）；层级分布参考 bloom-levels.md 第 7 节的经验默认。
- 梯度报告：按 bloom-levels.md 第 5–6 节生成"层级×章节矩阵 + 合计 + 占比 + 检查结果"，执行三条检查规则。有告警必须连同"建议在第 N 章补 X 层级题目"的可操作建议一起呈现，不许只报问题不给出路。
- 表现性任务：1–3 个综合性任务，每个注明对应哪条迁移目标（每条迁移目标至少被一个任务覆盖，否则回到五件套与作者商定取舍）。
完整呈现四项后停下：
⏸ 等待确认：章节树与梯度规划（回复"确认"完成大纲设计，或直接提出修改）
Gate 规则与阶段 2 相同：修改后重新完整呈现，确认前绝不放行。确认后写入 00-教材设计.md 的「## 三、章节树与梯度规划（已确认）」与「## 四、表现性任务」。
产出与交接
- 落盘物：完整的
00-教材设计.md，固定二级标题结构见契约文档第 3 节；
- 回报上游（被调度时）：契约
{章节树[], 例题习题计划[], 表现性任务[], 梯度报告} + 两个 gate 均已确认的显式声明；
- 独立触发时，最后向作者说明：可用 textbook 从此设计文档继续逐章写作。
真实性约束
五件套和章节树是设计产物，无需运行验证；但若作者在阶段 1 提供了学科材料（讲义、笔记、课程标准），设计必须与材料一致，不虚构材料中不存在的学科内容；材料未覆盖处按学科公认体系设计。
