textbook

# textbook 写教材的主 skill（orchestrator）：驱动五阶段流程，管理 `.progress.json` 状态实现中断可续，在阶段间传递交接契约，最终交付一本有主线、有梯度、可评估的多章节 Markdown 教材。契约、落盘布局、状态机的权威定义见 [references/handoff-contract.md](references/handoff-contract.md)（下称"契约文档"）。 学科差异（题型集、验证手段、认知动词、章内段义）不在本 skill 里分支，收拢在**学科档案**中：阶段 1 判定一次，落盘为 `.progress.json` 的 `subject_profile`，逐章原样透传。规格与索引见 [references/subject-profile-spec.md](references/subject-profile-spec.md)。 ## 何时不触发 - 单篇教程/图文教程（用 tutorial-writer） - 只写一章或一篇深度文章（用 textbook-chapter） - 只要例题/习题（用 textbook-exercises） - 只做大纲不写正文（直接用 textbook-outline） ## 工作流总览 | 阶段 | 名称 | 执行者 | 产出 | Gate? | | ------ | ------ | -------- | ------ | ------- | | 1 | 教学定位确认 | textbook-outline | 学科/读者起点/深度/篇幅 → 00-教材设计.md | 否（一轮提问） | | 2 | UbD 预期结果设计 | textbook-outline | UbD 五件套 | **是（核心 gate）** | | 3 | 评估与章节设计 | textbook-outline | 章节树+例题计划+梯度报告+表现性任务 | 是（次要 gate） | | 4 | 章节正文编写 | textbook-chapter（逐章） | NN-章.md × N + 术语表增量 | 否 | | 5 | 审核定稿 | 本 skill | 自检报告 + 00-前言.md + 99-表现性任务.md + 交付摘要 | 否 | gate 之外的阶段只打印一行进度（格式见契约文档第 5 节），不打断作者。 ## 启动与重入（每次触发的第一件事） 1. **确定教材项目��录**：用户指定则用之；未指定则询问一次（默认 `./<教材名>/`）。 2. **找 `.progress.json`**： - 不存在 → 全新项目：确认教材名 → 建目录 → 初始化 `.progress.json`（schema 见契约文档第 4 节，`current_stage=1`，gates 全 false，`answer_layout="separate"`，`subject_profile` 待阶段 1 判定后补写）→ 从阶段 1 开始； - 存在 → 按契约文档第 4 节**重入规则表**定位续点，打印续写行：阶段 4 用 `▶ 续写：<教材名>，从第 N 章继续`，其余阶段用 `▶ 续写：<教材名>，从阶段 N 继续`；同时读出 `subject_profile` 与 `answer_layout` 供后续透传，**字段缺失**时按存量语义兜底并在续写行后各补一句说明，不阻塞：`subject_profile` 缺失（v0.3.x 及更早）按 `st...