前言¶
写一整本多章节教材时,常见的做法是让模型从第一章一路写到最后一章。问题不在写得慢,而在写崩:各章的教学目标、评估方式和内容深度对不上,前面定的目标后面没人呼应,写到一半中断后更是没法接着写,只能从头再来。
教材写作流水线针对的就是这个场景。下面介绍它的定位、能力、安装方式和典型用法。
这是什么¶
教材写作流水线是一套基于通用 SKILL.md 格式的 Agent Skill,由社区发布者 user_6733bad6 维护,版本 0.7.0,分类为 content-creation,来源标记为 community。它把整本教材的写作拆成五个阶段,按 UbD(理解为逆向设计)的顺序调度:先确定目标和评估,再组织内容,而不是从内容往前堆。
它解决的问题是:整本教材的目标对齐、写作过程中的中断恢复,以及写作与习题生成的分工。
核心功能¶
- 五阶段调度。整个写作过程按 UbD 逆向设计分成五个阶段推进,阶段之间的顺序由 Skill 控制,不靠人在对话里反复提醒。
- 阶段 2、阶段 3 双 gate 作者确认。这两个阶段设了确认门槛,需要作者确认后才进入下一阶段,避免目标和评估方案没定就往下写内容。
.progress.json落盘与续写。进度写入.progress.json,中断后可以从落盘的进度继续,不用从头开始。- 基于已有素材开工。支持基于已有的 Word 文档、讲义素材规划整本教材,也支持修订项目中只改指定章节。
- 与三个子 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)。这三种情况用主流程属于杀鸡用牛刀,环节也对不上。
需要注意的坑:
- 四个 Skill 必须同目录,少一个主流程会在调度到对应环节时断掉。
- 阶段 2、3 的确认是人工 gate,作者不确认就不会往下走,不能指望全程无人值守跑完。
.progress.json是续写的唯一依据,删掉它就等于丢掉进度,需要从头再来。- 该 Skill 与具体的模型平台无绑定,按通用 SKILL.md 格式加载,具体加载方式取决于你使用的 Agent 环境。
结尾¶
教材写作流水线的价值在于把「写一整本教材」这件容易失控的事变成可调度、可中断、可续写的流程:阶段顺序有 UbD 兜底,关键节点有作者确认,进度有文件留存。如果工作内容是成体系的教材或讲义写作,值得装一套试跑;只写单篇或单章的话,用对应的子 Skill 就够了。
官方地址:https://api.skillhub.cn/user_6733bad6/textbook