教材写作流水线:UbD 逆向设计驱动的多章节教材写作

前言

写一整本多章节教材时,常见的做法是让模型从第一章一路写到最后一章。问题不在写得慢,而在写崩:各章的教学目标、评估方式和内容深度对不上,前面定的目标后面没人呼应,写到一半中断后更是没法接着写,只能从头再来。

教材写作流水线针对的就是这个场景。下面介绍它的定位、能力、安装方式和典型用法。

这是什么

教材写作流水线是一套基于通用 SKILL.md 格式的 Agent Skill,由社区发布者 user_6733bad6 维护,版本 0.7.0,分类为 content-creation,来源标记为 community。它把整本教材的写作拆成五个阶段,按 UbD(理解为逆向设计)的顺序调度:先确定目标和评估,再组织内容,而不是从内容往前堆。

它解决的问题是:整本教材的目标对齐、写作过程中的中断恢复,以及写作与习题生成的分工。

核心功能

  1. 五阶段调度。整个写作过程按 UbD 逆向设计分成五个阶段推进,阶段之间的顺序由 Skill 控制,不靠人在对话里反复提醒。
  2. 阶段 2、阶段 3 双 gate 作者确认。这两个阶段设了确认门槛,需要作者确认后才进入下一阶段,避免目标和评估方案没定就往下写内容。
  3. .progress.json 落盘与续写。进度写入 .progress.json,中断后可以从落盘的进度继续,不用从头开始。
  4. 基于已有素材开工。支持基于已有的 Word 文档、讲义素材规划整本教材,也支持修订项目中只改指定章节。
  5. 与三个子 Skill 分工。教材大纲、单章写作、习题生成分别由 textbook-outline、textbook-chapter、textbook-exercises 承担,本 Skill 负责把它们串成一条流水线。

安装与启用

四个 Skill 必须放在同一个 skills 目录下,缺一个流水线就跑不起来:

skills/
├── textbook/              # 本 Skill,主流程
├── textbook-outline/      # 教材大纲
├── textbook-chapter/      # 单章写作
└── textbook-exercises/    # 习题生成

放置好之后,在对话里用触发语唤起即可,例如「写教材」、「把讲义做成教材」、「修订这本教材的第三章」。该 Skill 的标签为 requires_api_key=false,不需要额外配置 API Key。

官方地址:https://api.skillhub.cn/user_6733bad6/textbook,SkillHub 页面显示评分 100000,下载 1011 次。

典型用法

新建一个项目,把素材(Word 文档或讲义)和需求一起给到 Agent,触发语用「把讲义做成教材」。Agent 会先跑阶段 1,进入阶段 2、3 时停下来等作者确认;确认后继续推进,期间进度不断写入 .progress.json。

如果是修订已有教材,直接指明章节,例如「修订这本教材的第三章」,流程只针对该章重新走一遍阶段调度,不会重写全书。

中途对话中断也不要紧,重新发起后 Skill 读取 .progress.json 接着写,不需要重新交代背景。

适用场景与注意

适合的场景:写一整本多章节教材、写含习题的成体系课程讲义、基于已有 Word 文档或讲义规划整本教材、修订项目中指定章节的改写。

不适合的场景:只写单篇教程(不需要这套流程)、只写一章(用 textbook-chapter)、只出习题(用 textbook-exercises)。这三种情况用主流程属于杀鸡用牛刀,环节也对不上。

需要注意的坑:

  1. 四个 Skill 必须同目录,少一个主流程会在调度到对应环节时断掉。
  2. 阶段 2、3 的确认是人工 gate,作者不确认就不会往下走,不能指望全程无人值守跑完。
  3. .progress.json 是续写的唯一依据,删掉它就等于丢掉进度,需要从头再来。
  4. 该 Skill 与具体的模型平台无绑定,按通用 SKILL.md 格式加载,具体加载方式取决于你使用的 Agent 环境。

结尾

教材写作流水线的价值在于把「写一整本教材」这件容易失控的事变成可调度、可中断、可续写的流程:阶段顺序有 UbD 兜底,关键节点有作者确认,进度有文件留存。如果工作内容是成体系的教材或讲义写作,值得装一套试跑;只写单篇或单章的话,用对应的子 Skill 就够了。

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

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

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

小夜