跳到内容
当前位置:首页>高中教材>已有讲义怎么用 Codex 写教材?4 种用法

已有讲义怎么用 Codex 写教材?4 种用法

  • 2026-11-13 21:26:29
已有讲义怎么用 Codex 写教材?4 种用法

有用户提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
基本 文件 流程 错误 SQL 调试
  1. 请求信息 : 2026-11-23 07:53:52 HTTP/1.1 GET : http://c.sjds.net/a/480020.html
  2. 运行时间 : 0.076838s [ 吞吐率:13.01req/s ] 内存消耗:4,330.42kb 文件加载:140
  3. 缓存信息 : 0 reads,0 writes
  4. 会话信息 : SESSION_ID=ffc39e9f7331a8573c7c7b4525a1312d
  1. /www/wwwroot/c.sjds.net/public/index.php ( 0.79 KB )
  2. /www/wwwroot/c.sjds.net/vendor/autoload.php ( 0.17 KB )
  3. /www/wwwroot/c.sjds.net/vendor/composer/autoload_real.php ( 2.49 KB )
  4. /www/wwwroot/c.sjds.net/vendor/composer/platform_check.php ( 0.90 KB )
  5. /www/wwwroot/c.sjds.net/vendor/composer/ClassLoader.php ( 14.03 KB )
  6. /www/wwwroot/c.sjds.net/vendor/composer/autoload_static.php ( 4.90 KB )
  7. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/helper.php ( 8.34 KB )
  8. /www/wwwroot/c.sjds.net/vendor/topthink/think-validate/src/helper.php ( 2.19 KB )
  9. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/helper.php ( 1.47 KB )
  10. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/stubs/load_stubs.php ( 0.16 KB )
  11. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Exception.php ( 1.69 KB )
  12. /www/wwwroot/c.sjds.net/vendor/topthink/think-container/src/Facade.php ( 2.71 KB )
  13. /www/wwwroot/c.sjds.net/vendor/symfony/deprecation-contracts/function.php ( 0.99 KB )
  14. /www/wwwroot/c.sjds.net/vendor/symfony/polyfill-mbstring/bootstrap.php ( 8.26 KB )
  15. /www/wwwroot/c.sjds.net/vendor/symfony/polyfill-mbstring/bootstrap80.php ( 9.78 KB )
  16. /www/wwwroot/c.sjds.net/vendor/symfony/var-dumper/Resources/functions/dump.php ( 1.49 KB )
  17. /www/wwwroot/c.sjds.net/vendor/topthink/think-dumper/src/helper.php ( 0.18 KB )
  18. /www/wwwroot/c.sjds.net/vendor/symfony/var-dumper/VarDumper.php ( 4.30 KB )
  19. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/App.php ( 15.30 KB )
  20. /www/wwwroot/c.sjds.net/vendor/topthink/think-container/src/Container.php ( 15.76 KB )
  21. /www/wwwroot/c.sjds.net/vendor/psr/container/src/ContainerInterface.php ( 1.02 KB )
  22. /www/wwwroot/c.sjds.net/app/provider.php ( 0.19 KB )
  23. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Http.php ( 6.04 KB )
  24. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/helper/Str.php ( 7.29 KB )
  25. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Env.php ( 4.68 KB )
  26. /www/wwwroot/c.sjds.net/app/common.php ( 0.03 KB )
  27. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/helper.php ( 18.78 KB )
  28. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Config.php ( 5.54 KB )
  29. /www/wwwroot/c.sjds.net/config/app.php ( 0.95 KB )
  30. /www/wwwroot/c.sjds.net/config/cache.php ( 0.78 KB )
  31. /www/wwwroot/c.sjds.net/config/console.php ( 0.23 KB )
  32. /www/wwwroot/c.sjds.net/config/cookie.php ( 0.56 KB )
  33. /www/wwwroot/c.sjds.net/config/database.php ( 2.48 KB )
  34. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/facade/Env.php ( 1.67 KB )
  35. /www/wwwroot/c.sjds.net/config/filesystem.php ( 0.61 KB )
  36. /www/wwwroot/c.sjds.net/config/lang.php ( 0.91 KB )
  37. /www/wwwroot/c.sjds.net/config/log.php ( 1.35 KB )
  38. /www/wwwroot/c.sjds.net/config/middleware.php ( 0.19 KB )
  39. /www/wwwroot/c.sjds.net/config/route.php ( 1.89 KB )
  40. /www/wwwroot/c.sjds.net/config/session.php ( 0.57 KB )
  41. /www/wwwroot/c.sjds.net/config/trace.php ( 0.34 KB )
  42. /www/wwwroot/c.sjds.net/config/view.php ( 0.82 KB )
  43. /www/wwwroot/c.sjds.net/app/event.php ( 0.25 KB )
  44. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Event.php ( 7.67 KB )
  45. /www/wwwroot/c.sjds.net/app/service.php ( 0.13 KB )
  46. /www/wwwroot/c.sjds.net/app/AppService.php ( 0.26 KB )
  47. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Service.php ( 1.64 KB )
  48. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Lang.php ( 7.35 KB )
  49. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/lang/zh-cn.php ( 13.70 KB )
  50. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/initializer/Error.php ( 3.31 KB )
  51. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/initializer/RegisterService.php ( 1.33 KB )
  52. /www/wwwroot/c.sjds.net/vendor/services.php ( 0.14 KB )
  53. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/service/PaginatorService.php ( 1.52 KB )
  54. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/service/ValidateService.php ( 0.99 KB )
  55. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/service/ModelService.php ( 2.04 KB )
  56. /www/wwwroot/c.sjds.net/vendor/topthink/think-trace/src/Service.php ( 0.77 KB )
  57. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Middleware.php ( 6.72 KB )
  58. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/initializer/BootService.php ( 0.77 KB )
  59. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/Paginator.php ( 11.86 KB )
  60. /www/wwwroot/c.sjds.net/vendor/topthink/think-validate/src/Validate.php ( 63.20 KB )
  61. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/Model.php ( 23.55 KB )
  62. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/Attribute.php ( 21.05 KB )
  63. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/AutoWriteData.php ( 4.21 KB )
  64. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/Conversion.php ( 6.44 KB )
  65. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/DbConnect.php ( 5.16 KB )
  66. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/ModelEvent.php ( 2.33 KB )
  67. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/RelationShip.php ( 28.29 KB )
  68. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/contract/Arrayable.php ( 0.09 KB )
  69. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/contract/Jsonable.php ( 0.13 KB )
  70. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/contract/Modelable.php ( 0.09 KB )
  71. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Db.php ( 2.88 KB )
  72. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/DbManager.php ( 8.52 KB )
  73. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Log.php ( 6.28 KB )
  74. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Manager.php ( 3.92 KB )
  75. /www/wwwroot/c.sjds.net/vendor/psr/log/src/LoggerTrait.php ( 2.69 KB )
  76. /www/wwwroot/c.sjds.net/vendor/psr/log/src/LoggerInterface.php ( 2.71 KB )
  77. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Cache.php ( 4.92 KB )
  78. /www/wwwroot/c.sjds.net/vendor/psr/simple-cache/src/CacheInterface.php ( 4.71 KB )
  79. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/helper/Arr.php ( 16.63 KB )
  80. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/cache/driver/File.php ( 7.84 KB )
  81. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/cache/Driver.php ( 9.03 KB )
  82. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/contract/CacheHandlerInterface.php ( 1.99 KB )
  83. /www/wwwroot/c.sjds.net/app/Request.php ( 0.09 KB )
  84. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Request.php ( 55.78 KB )
  85. /www/wwwroot/c.sjds.net/app/middleware.php ( 0.25 KB )
  86. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Pipeline.php ( 2.61 KB )
  87. /www/wwwroot/c.sjds.net/vendor/topthink/think-trace/src/TraceDebug.php ( 3.40 KB )
  88. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/middleware/SessionInit.php ( 1.94 KB )
  89. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Session.php ( 1.80 KB )
  90. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/session/driver/File.php ( 6.27 KB )
  91. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/contract/SessionHandlerInterface.php ( 0.87 KB )
  92. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/session/Store.php ( 7.12 KB )
  93. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Route.php ( 23.73 KB )
  94. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/RuleName.php ( 5.75 KB )
  95. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/Domain.php ( 2.53 KB )
  96. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/RuleGroup.php ( 22.43 KB )
  97. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/Rule.php ( 26.95 KB )
  98. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/RuleItem.php ( 9.78 KB )
  99. /www/wwwroot/c.sjds.net/route/app.php ( 1.72 KB )
  100. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/facade/Route.php ( 4.70 KB )
  101. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/dispatch/Controller.php ( 4.74 KB )
  102. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/Dispatch.php ( 10.44 KB )
  103. /www/wwwroot/c.sjds.net/app/controller/Index.php ( 4.81 KB )
  104. /www/wwwroot/c.sjds.net/app/BaseController.php ( 2.05 KB )
  105. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/facade/Db.php ( 0.93 KB )
  106. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/connector/Mysql.php ( 5.44 KB )
  107. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/PDOConnection.php ( 52.47 KB )
  108. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/Connection.php ( 8.39 KB )
  109. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/ConnectionInterface.php ( 4.57 KB )
  110. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/builder/Mysql.php ( 16.58 KB )
  111. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/Builder.php ( 24.06 KB )
  112. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/BaseBuilder.php ( 27.50 KB )
  113. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/Query.php ( 15.71 KB )
  114. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/BaseQuery.php ( 45.13 KB )
  115. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/TimeFieldQuery.php ( 7.43 KB )
  116. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/AggregateQuery.php ( 3.26 KB )
  117. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/ModelRelationQuery.php ( 20.07 KB )
  118. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/ParamsBind.php ( 3.66 KB )
  119. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/ResultOperation.php ( 7.01 KB )
  120. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/WhereQuery.php ( 19.37 KB )
  121. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/JoinAndViewQuery.php ( 7.11 KB )
  122. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/TableFieldInfo.php ( 2.63 KB )
  123. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/Transaction.php ( 2.77 KB )
  124. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/log/driver/File.php ( 5.96 KB )
  125. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/contract/LogHandlerInterface.php ( 0.86 KB )
  126. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/log/Channel.php ( 3.89 KB )
  127. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/event/LogRecord.php ( 1.02 KB )
  128. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/Collection.php ( 16.47 KB )
  129. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/facade/View.php ( 1.70 KB )
  130. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/View.php ( 4.39 KB )
  131. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Response.php ( 8.81 KB )
  132. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/response/View.php ( 3.29 KB )
  133. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Cookie.php ( 6.06 KB )
  134. /www/wwwroot/c.sjds.net/vendor/topthink/think-view/src/Think.php ( 8.38 KB )
  135. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/contract/TemplateHandlerInterface.php ( 1.60 KB )
  136. /www/wwwroot/c.sjds.net/vendor/topthink/think-template/src/Template.php ( 46.61 KB )
  137. /www/wwwroot/c.sjds.net/vendor/topthink/think-template/src/template/driver/File.php ( 2.41 KB )
  138. /www/wwwroot/c.sjds.net/vendor/topthink/think-template/src/template/contract/DriverInterface.php ( 0.86 KB )
  139. /www/wwwroot/c.sjds.net/runtime/temp/52e0794259aeabc01163982c3f0015ae.php ( 8.05 KB )
  140. /www/wwwroot/c.sjds.net/vendor/topthink/think-trace/src/Html.php ( 4.42 KB )
  1. CONNECT:[ UseTime:0.000740s ] mysql:host=172.18.0.4;port=3306;dbname=c_sjds;charset=utf8mb4
  2. SHOW FULL COLUMNS FROM `fenlei` [ RunTime:0.000976s ]
  3. SELECT * FROM `fenlei` WHERE `fid` = 0 [ RunTime:0.000501s ]
  4. SELECT * FROM `fenlei` WHERE `fid` = 63 [ RunTime:0.000341s ]
  5. SHOW FULL COLUMNS FROM `set` [ RunTime:0.000467s ]
  6. SELECT * FROM `set` [ RunTime:0.000281s ]
  7. SHOW FULL COLUMNS FROM `article` [ RunTime:0.000580s ]
  8. SELECT * FROM `article` WHERE `id` = 480020 LIMIT 1 [ RunTime:0.000423s ]
  9. UPDATE `article` SET `lasttime` = 1795391633 WHERE `id` = 480020 [ RunTime:0.001472s ]
  10. SELECT * FROM `fenlei` WHERE `id` = 66 LIMIT 1 [ RunTime:0.000319s ]
  11. SELECT * FROM `article` WHERE `id` < 480020 ORDER BY `id` DESC LIMIT 1 [ RunTime:0.000412s ]
  12. SELECT * FROM `article` WHERE `id` > 480020 ORDER BY `id` ASC LIMIT 1 [ RunTime:0.000364s ]
  13. SELECT * FROM `article` WHERE `id` < 480020 ORDER BY `id` DESC LIMIT 10 [ RunTime:0.000538s ]
  14. SELECT * FROM `article` WHERE `id` < 480020 ORDER BY `id` DESC LIMIT 10,10 [ RunTime:0.000563s ]
  15. SELECT * FROM `article` WHERE `id` < 480020 ORDER BY `id` DESC LIMIT 20,10 [ RunTime:0.000561s ]
0.086217s