教材写作·大纲设计:把教学定位、UbD 预期结果和章节树落成 00-教材设计.md

前言

写教材时常见的一种失控是:章节正文开写之后才发现教学定位没对齐——例题的难度梯度没有规划,每章到底要学生学会什么也没有统一描述,结果越写到后面越难回头调整。

教材写作·大纲设计(@user_6733bad6/textbook-outline)解决的是这个问题。它属于 textbook 流水线的阶段 1–3,在写章节正文之前,先把教学设计这件事单独做完。下面介绍这个 Skill 的定位、功能、安装方式和使用边界。

这是什么

一句话定位:教材项目在进入教学设计阶段时使用的 Skill,负责产出完整的教学设计文档。

基本信息如下:

名称:      教材写作·大纲设计
坐标:      @user_6733bad6/textbook-outline
版本:      0.7.0
来源:      community
分类:      education
发布者:    user_6733bad6
评分:      100000
下载:      835
安装:      0
标签:      requires_api_key=false
官方地址:  https://api.skillhub.cn/user_6733bad6/textbook-outline

它由社区发布者 user_6733bad6 维护,属于 education 分类。资料中显示的评分为 100000,下载 835 次,当前安装数为 0。不需要配置 API Key(requires_api_key=false)。

解决的问题:无论是新写一本教材,还是把已有的课程材料整理成教材,都缺少一个标准化的教学设计环节。这个 Skill 把这个环节固化成一套产出物。

核心功能

这个 Skill 的能力集中在四件事上,全部写入同一份文档。

  1. 教学定位:明确教材面向谁、要达成什么教学目标。
  2. UbD 预期结果五件套:按照 Understanding by Design 的思路整理预期结果,共五项。
  3. 章节树:规划教材的章节结构,形成目录骨架。
  4. 例题 Bloom 梯度:对例题按 Bloom 分类法做难度梯度规划,使不同认知层级的题目分布有依据。

以上四部分的产出统一写入 00-教材设计.md。

除了从零规划,它也支持基于已有材料反推设计:输入 Word 文档、讲义或课程材料,Skill 据此规划教材。

触发语包括:「设计教材大纲」、「根据讲义规划教材」、「课程体系设计」。

需要明确它的边界:这个 Skill 不负责写章节正文,也不负责生成习题。正文和习题属于 textbook 流水线后续阶段的产出。

安装与启用

安装方面有一条硬性要求:需与 textbook 系列其余 Skill 装在同一 skills 目录下,不能单独放到别的目录。

启用方式有两种:

1. 通常由 textbook 调度,作为流水线的阶段 1–3 自动执行。
2. 也可以单独运行,直接对 Skill 下达触发语。

官方地址:https://api.skillhub.cn/user_6733bad6/textbook-outline

有一点需要说明:已抓取的资料中没有给出具体的安装命令(如 npx 命令或 marketplace 添加命令),也没有 Cursor、Codex CLI、Claude Code 等工具在安装方式上的差异说明。这些内容在现有资料中无法核实,因此不在这里给出,避免误导。

典型用法

下面给出资料中记录的可复现用法。

场景一:从零设计教材大纲。直接下达触发语,例如:

设计教材大纲

Skill 会完成教学定位、UbD 预期结果五件套、章节树和例题 Bloom 梯度规划,产出 00-教材设计.md。

场景二:基于已有材料规划教材。如果有一份讲义或课程材料,用触发语:

根据讲义规划教材

Skill 从现有材料中提取教学要素,生成同样的设计文档。

场景三:做课程体系层面的设计。用触发语:

课程体系设计

这条触发语更偏宏观,用于规划一整门课程的教材结构。

三个场景的产出文件都是 00-教材设计.md,后续 textbook 系列的 Skill 会读取这份文档,在此基础上写章节正文和生成习题。

适用场景与注意

适合谁:

  • 正在编写教材、需要先完成教学设计的人。
  • 手里有 Word 文档、讲义或课程材料,想系统化整理成教材的人。
  • 使用 textbook 流水线做教材项目的人,作为阶段 1–3 的执行者。

不适用的情况:

  • 只想写章节正文:这个 Skill 不做这件事。
  • 只想批量出习题:这个 Skill 不生成习题。
  • 不需要任何教学设计,只想做排版或校对:超出了它的范围。

使用时的注意事项:

  1. 目录约束:必须与 textbook 系列其余 Skill 装在同一 skills 目录下,否则流水线后续阶段可能找不到这份设计文档。
  2. 文档衔接:00-教材设计.md 是后续阶段的输入,如果跳过这一步直接写正文,章节之间的教学逻辑容易不一致。
  3. 材料质量影响产出:基于讲义或 Word 文档规划时,材料本身的结构和完整性会影响产出的设计文档质量,材料越零散,需要补充的工作越多。

小结

教材写作·大纲设计把教材项目中最容易被跳过的教学设计环节固化成了四步:教学定位、UbD 预期结果五件套、章节树、例题 Bloom 梯度,产出一份 00-教材设计.md。它的定位是 textbook 流水线的前置阶段,不替代正文写作和习题生成。如果你的教材项目还在早期规划阶段,从这份设计文档开始会比直接动笔更稳。

官方地址:https://api.skillhub.cn/user_6733bad6/textbook-outline

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜