# Textbook Outline

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-cabbage2000-lab-textbook-writer-skills-textbook-outline`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cabbage2000-lab](https://agentstack.voostack.com/s/cabbage2000-lab)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cabbage2000-lab](https://github.com/cabbage2000-lab)
- **Source:** https://github.com/cabbage2000-lab/textbook-writer-skills/tree/main/skills/textbook-outline

## Install

```sh
agentstack add skill-cabbage2000-lab-textbook-writer-skills-textbook-outline
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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](../textbook/references/handoff-contract.md)，下文简称"契约文档"。本 skill 的进度行 `▶ 阶段 N/3` 是子 skill 内层标尺（契约文档第 5 节：N/M 中 M 为当前 skill 自身的阶段总数）；被调度时全局的 `▶ 阶段 N/5` 行由主 skill 打印，两级并存。

## 阶段 1/3：教学定位确认

打印进度：`▶ 阶段 1/3：教学定位确认`

用 AskUserQuestion **一轮**收集四项（对应契约 `{学科, 读者认知起点, 教材深度, 篇幅规模}`）：

1. **学科**：具体到分支（如"线性代数"而非"数学"）。用户触发时若已说明，此项不再问。
2. **读者认知起点**：零基础 / 有先修（注明先修什么）
3. **教材深度**：入门 / 进阶
4. **篇幅规模**：6–8 章 / 8–12 章 / 12 章以上

若当前环境没有 AskUserQuestion 工具，降级为编号提问并等待文本回复：

```text
请回答以下问题（回复格式如 "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/ubd-framework.md) 设计五件套，学习目标动词查 [references/bloom-levels.md](references/bloom-levels.md) 第 2 节：

1. **大概念**：3–7 个，每个是"主张"不是名词；
2. **持久理解**：一律"学生将理解：……"句式，是洞见不是知识点复述；
3. **核心问题**：2–5 个开放性问题，能贯穿多章；
4. **迁移目标**：情境必须是教材没直接教过的；
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. **章节树**：每章 `{章号, 章标题, 一句话定位, 承载的持久理解编号[]}`，章数符合阶段 1 的篇幅规模。
   **对齐检查（双向，硬性）**：某章承载不了任何持久理解 → 砍掉或改造该章；某条持久理解没有任何章承载 → 补章，或向作者明示放弃该条。检查结果随章节树一并呈现。
2. **例题习题计划**：每章三类题的 `{主题, Bloom层级}` 列表，数量参考四段式配额（示范例题 1–3 / 引导练习 1–3 / 独立习题 3–8，见 [../textbook-chapter/references/chapter-template.md](../textbook-chapter/references/chapter-template.md)）；层级分布参考 bloom-levels.md 第 7 节的经验默认。
3. **梯度报告**：按 bloom-levels.md 第 5–6 节生成"层级×章节矩阵 + 合计 + 占比 + 检查结果"，执行三条检查规则。**有告警必须连同"建议在第 N 章补 X 层级题目"的可操作建议一起呈现**，不许只报问题不给出路。
4. **表现性任务**：1–3 个综合性任务，每个注明对应哪条迁移目标（每条迁移目标至少被一个任务覆盖，否则回到五件套与作者商定取舍）。

完整呈现四项后停下：

`⏸ 等待确认：章节树与梯度规划（回复"确认"完成大纲设计，或直接提出修改）`

Gate 规则与阶段 2 相同：修改后重新完整呈现，确认前绝不放行。确认后写入 `00-教材设计.md` 的「## 三、章节树与梯度规划（已确认）」与「## 四、表现性任务」。

## 产出与交接

- **落盘物**：完整的 `00-教材设计.md`，固定二级标题结构见契约文档第 3 节；
- **回报上游**（被调度时）：契约 `{章节树[], 例题习题计划[], 表现性任务[], 梯度报告}` + 两个 gate 均已确认的显式声明；
- 独立触发时，最后向作者说明：可用 textbook 从此设计文档继续逐章写作。

## 真实性约束

五件套和章节树是设计产物，无需运行验证；但若作者在阶段 1 提供了学科材料（讲义、笔记、课程标准），设计必须与材料一致，不虚构材料中不存在的学科内容；材料未覆盖处按学科公认体系设计。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cabbage2000-lab](https://github.com/cabbage2000-lab)
- **Source:** [cabbage2000-lab/textbook-writer-skills](https://github.com/cabbage2000-lab/textbook-writer-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cabbage2000-lab-textbook-writer-skills-textbook-outline
- Seller: https://agentstack.voostack.com/s/cabbage2000-lab
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.