已有讲义怎么用 Codex 写教材?4 种用法
- 2026-11-13 21:26:29
有用户提issues, 已经有 Word 文档,能不能基于它写教材?正文又追问了两件事:能不能修改现有内容,能不能从材料里出练习。
这恰好是旧版做不到的事。项目的 README 在“不做”一栏明确写着:“把你已有的讲义素材整理成一门课”。那时可以从教学目标出发规划一本新教材,已有讲义却没有稳定进入逐章写作的路径。

我把这条边界改了。v0.7.0 接收作者提供的讲义、笔记或章稿:可以据此规划整本书,也可以只写一章、修一章,或者单独出题。我在 Issue 下回复了这几种用法,并关闭了它。
这里的 skill 是给 AI 助手看的工作手册,规定写作和核验的步骤。Codex、Claude Code 和 WorkBuddy 都能使用这套教材写作 skill。
我先给材料登记位置,再让它进入章节
用户问的是“能不能用现成材料”。我最先要解决的是:写到第 3 章时,AI 究竟该读讲义的哪一段?如果每章都接收整套材料,作者回头很难查清某个说法从哪里来。
新版会先在 00-教材设计.md 记录素材路径、文件校验值和适用章节。校验值用于发现原文件是否变过。章节安排确认后,每章只接收分给这一章的片段;写完还会留下素材使用记录。
Word .docx 也接进来了。我给项目加了一个提取脚本,读取正文段落和表格文字。P1 指第 1 段,T1R1C1 指第 1 张表第 1 行第 1 列。看到教材里某个数字,你可以沿着位置标记回原文件核对。
已有讲义也不会直接变成章节目录。整本教材仍有两次停点:教学目标等设计要作者确认,章节安排也要作者确认。讲义里原有的顺序如果和教学目标冲突,应该把差异摆出来让作者决定。
我故意在测试讲义里留了一道错题
Issue 还问能不能依据材料出练习。这里有个坑:讲义里的旧答案也可能错。
我在测试讲义里放了两个矩阵:A=[[1,2],[3,4]],B=[[2,0],[1,2]]。旧答案把乘积写成 [[4,4],[10,9]],右下角多了 1。我重新算了一遍:3×0+4×2=8,正确结果是 [[4,4],[10,8]]。
所以新版本不会把“材料里写了答案”当作“答案已经验证”。从讲义出题,仍要逐题复算或按学科要求核对来源;修改旧题时,原来的验证也要重做。修订已有章节,还要同步替换那一章的参考答案,免得正文改了、答案留着旧版。
现在可以按这四种情况开口
我把 README 中的示例压成一张表。路径只是示例,换成当前工作目录下真实可访问的文件即可;还没安装这套 skill,可以先按文末 README 装好再新开会话。
./讲义/线性代数课程.docx 写一本《线性代数入门》,读者零基础,约 8 章。先给我看教学目标和章节安排,确认后再逐章写。” | ||
./讲义/第三讲.docx 写一章矩阵乘法,面向零基础读者。保留‘行乘列’的解释,补齐例题、练习和章末自检。” | ||
./教材/线性代数入门/ 中修订第 3 章,依据 ./讲义/第三讲.docx 核对概念和例题,保留原有教学视角,重新验证改动过的题目。” | ||
./资料/需求弹性.md 给入门学生出示范例题、引导练习和独立习题。标出材料依据,逐题核对答案。” |
我建议先拿一页材料试“单章”或“只出题”:看它能不能指出原文位置,旧答案有没有重新核过。版本记录里,素材出题、单章修订和 Word 出题的 Codex 行为用例已通过;整本教材的素材传递还没有完成全链路验收。
Word 输入也有边界。提取脚本只读 .docx 正文和表格文字;扫描页、图片、批注、脚注、文本框及旧版 .doc,需要先提供文本或 OCR 结果。正式引用仍要回到原文件看一眼。
这条 Issue 让我把旧版明确写下的“不做”改成了可用的入口。你可以从表里的单章请求开始,但章节取舍、讲义里的争议怎么讲,最后仍由懂这门课的作者定。
参考来源
https://github.com/cabbage2000-lab/textbook-writer-skills