一、为什么整理课程资料不能只靠“总结一下”

很多课程资料看起来很多，但真正要复习、交付、转成训练营、做知识库或做内容分发时，会暴露三个问题：资料分散、知识点重复、学习顺序不清楚。课件里有概念，直播字幕里有案例，作业要求在群公告里，补充资料又放在另一个文档里。最后学生不知道先学什么，老师也不知道哪些内容讲重了、哪些知识点漏了。

用 Codex 整理课程资料，不是让它简单把内容压缩成一篇摘要，而是让它把课程资料当成一个项目来处理：先扫描文件，再建立目录，再抽取知识点，再标记来源，再生成学习路径、复习清单、FAQ、作业和验收标准。这样整理出来的内容才可以继续维护，也能交给新人、学生或运营团队直接使用。

要说清楚边界：Codex 更适合处理已经整理到项目文件夹里的课程资料，例如 Markdown、txt、字幕文件、讲义、README、课后作业、代码示例和可读取的文档。不要把它理解成可以绕过课程平台限制、破解视频或抓取封闭内容的工具。

二、Codex 适合整理哪些课程资料

课程资料越散，越需要先做“资料地图”。不要一上来让 Codex 生成学习计划，因为它还不知道资料来源是否完整。更稳的做法是先把课程资料放进一个统一目录，然后让 Codex 列出文件清单、内容类型、知识点密度和可整理价值。

三、整理前先建立一个课程资料文件夹

如果资料还散在桌面、网盘、聊天记录和笔记软件里，Codex 很难稳定工作。先把课程资料按固定结构整理到项目目录里，后续每次新增资料，都能按同一规则处理。

推荐目录结构

course-project/ raw/ # 原始资料：课件、字幕、讲义、聊天记录导出 notes/ # 人工补充笔记、老师口径、课程定位 assignments/ # 作业、项目、测试题、评分标准 examples/ # 代码示例、案例素材、模板文件 output/ # Codex 生成的知识点地图、总结、FAQ、学习路径 AGENTS.md # 课程资料整理规则 COURSE_INDEX.md # 课程资料总索引 KNOWLEDGE_MAP.md # 知识点地图 REVIEW_CHECKLIST.md # 复习与验收清单

这个结构的好处是：原始资料不被覆盖，人工笔记和生成结果分开，后续可以让 Codex 持续更新 output 目录，而不是每次重新整理一遍。

四、第一步：让 Codex 先扫描资料，不要直接总结

课程资料整理最容易出错的地方，是还没弄清楚资料有什么，就直接让 AI 生成总结。正确方式是先让 Codex 做“资料盘点”。

Codex 提示词：课程资料扫描

请你先不要总结课程内容，也不要改写任何文件。 请扫描当前课程项目目录，重点查看 raw、notes、assignments、examples 目录，输出一份 COURSE_INDEX.md。 要求： 1. 按文件列出资料名称、资料类型、所属课程模块、主要内容、可能包含的知识点。 2. 标记哪些资料适合做知识点提取，哪些只适合做补充参考。 3. 标记明显重复、命名混乱、缺少上下文的文件。 4. 如果发现课程大纲、作业、字幕、课件之间存在缺失关系，请单独列出。 5. 只生成索引和问题清单，不要重写原始资料。

这一步的输出不是最终内容，而是让你知道资料是否完整。比如课程有第 1、2、4 节字幕，没有第 3 节；作业要求提到了一个案例，但 raw 目录里没有对应案例文件；某个术语在三个课件里反复出现，但定义不一致。这些问题越早发现，后面整理越省时间。

五、第二步：把课程内容拆成知识点地图

知识点地图不是目录。目录通常按照课程顺序排列，知识点地图要说明概念之间的关系：哪个是前置知识，哪个是核心能力，哪个是案例，哪个是练习。

Codex 提示词：生成知识点地图

请基于 COURSE_INDEX.md 和 raw、notes、assignments 目录中的资料，生成 KNOWLEDGE_MAP.md。 输出结构： 1. 一级模块：课程的大主题。 2. 二级知识点：每个模块下的核心概念、方法、工具或流程。 3. 每个知识点必须包含： - 简明定义 - 学习目标 - 前置知识 - 来源文件 - 相关案例 - 对应练习或作业 - 易错点 4. 如果某个知识点没有明确来源，请标记为“需要人工确认”，不要编造。 5. 如果多个文件对同一知识点说法不一致，请列出冲突来源。

六、第三步：按章节生成学习笔记

知识点地图解决的是整体结构，章节笔记解决的是单节课怎么学。每节课的笔记不要只写摘要，最好包含“本节目标、核心概念、关键步骤、案例、练习、复习问题”。

Codex 提示词：生成章节学习笔记

请为每一节课程生成结构化学习笔记，输出到 output/lesson-notes/ 目录。 每节课使用以下结构： # 第 X 节：课程标题 ## 本节学习目标 用 3-5 条说明学完后应该掌握什么。 ## 核心知识点 列出本节必须掌握的概念和方法，并关联 KNOWLEDGE_MAP.md 中的知识点。 ## 老师强调的重点 从字幕、讲义或笔记中提炼老师反复强调的内容，不要编造。 ## 案例与操作步骤 如果有案例或代码示例，请按步骤整理。 ## 易错点 列出新手最容易误解或遗漏的地方。 ## 课后练习 把作业、练习和自测题整理成可执行清单。 ## 来源 列出本节使用到的文件名。

如果课程是技术类、软件类或设计类，这种结构比普通摘要更有用。因为学生最终不是为了“看过”，而是为了能复现流程、完成作业、做出项目或通过考核。

七、第四步：把知识点转成复习清单和测验题

课程整理到知识点地图还不够。真正有用的课程资料，应该能继续生成复习清单、测验题、面试题、作业要求和错题库。

Codex 提示词：生成复习清单和测验题

请基于 KNOWLEDGE_MAP.md 和 output/lesson-notes/ 目录，生成 REVIEW_CHECKLIST.md。 要求： 1. 按模块生成复习清单，每个知识点用“会 / 不会 / 需要复习”三态检查。 2. 每个知识点生成 1 个基础题、1 个应用题、1 个容易出错的判断题。 3. 对实践型知识点，生成可操作的练习任务和验收标准。 4. 对需要背诵或记忆的内容，生成简短记忆卡片。 5. 标记高频知识点和低频补充知识点。 6. 不要新增课程资料中没有出现过的知识点。

八、第五步：检查课程资料是否有遗漏

课程资料整理最大的价值之一，是发现原课程本身的问题。比如大纲写了“进阶案例”，但课件没有讲；作业要求使用某个工具，但前面没有教；直播里提到下载模板，但资料包里没有文件。

Codex 提示词：检查资料遗漏

请做一次课程资料遗漏检查，不要改写内容，只输出问题报告 COURSE_GAP_REPORT.md。 检查对象： - COURSE_INDEX.md - KNOWLEDGE_MAP.md - output/lesson-notes/ - assignments/ - raw/ 请检查： 1. 课程大纲中出现但资料中没有讲清楚的知识点。 2. 作业中要求完成但课程中没有提供前置说明的任务。 3. 字幕或讲义中提到但资料包里缺失的文件、模板、链接或案例。 4. 同一知识点在不同章节重复讲解但没有递进关系的情况。 5. 知识点顺序不合理的情况，例如先要求实操，再讲基础概念。 6. 适合补充 FAQ 的高频疑问。 输出表格：问题类型 / 涉及章节 / 涉及文件 / 问题说明 / 建议补充内容 / 优先级。

这一步很关键。很多课程效果差，不是因为内容少，而是因为学习路径断了。Codex 可以帮助你把这些断点找出来，但最终是否补课、删减或重录，需要老师或课程负责人判断。

九、第六步：生成不同用户的学习路径

同一套课程，给新手、进阶用户、复习用户、项目实战用户看的顺序可能完全不同。整理课程资料时，不要只生成一种路径。

Codex 提示词：生成学习路径

请基于 KNOWLEDGE_MAP.md、REVIEW_CHECKLIST.md 和课程资料，生成 LEARNING_PATHS.md。 请输出 4 种学习路径： 1. 新手入门路径：适合零基础用户，强调前置知识和术语解释。 2. 快速上手路径：适合有基础用户，强调关键章节和实践任务。 3. 项目实战路径：围绕最终项目倒推需要学习的知识点。 4. 考前复习路径：围绕高频知识点、易错点和测验题组织。 每条路径必须包含： - 推荐学习顺序 - 每一步学习目标 - 需要查看的资料 - 需要完成的练习 - 判断是否学会的标准 - 预计学习时间 如果资料不足以支撑某条路径，请明确标记缺口。

这类路径特别适合知识付费课程、训练营、企业内训和技术文档。它能把同一套资料拆成不同入口，而不是所有用户都从第一节课硬看到底。

十、把课程整理规则写进 AGENTS.md

如果以后还要持续更新课程资料，就不要每次都复制一大段提示词。可以把稳定规则写进 AGENTS.md，让 Codex 在处理这个课程项目时自动遵守。

AGENTS.md 示例：课程资料整理规则

AGENTS.md ## 项目目标 这个项目用于整理课程资料，把原始课件、字幕、讲义、作业和案例转成可维护的知识点地图、学习路径、复习清单和课程 FAQ。 ## 目录规则 - raw/ 存放原始资料，除非用户明确要求，不要直接修改。 - notes/ 存放人工补充说明和课程负责人口径。 - assignments/ 存放作业、练习、评分标准和项目任务。 - examples/ 存放代码示例、案例素材和模板。 - output/ 存放整理后的内容。 ## 整理原则 - 每个知识点必须标记来源文件。 - 不确定的内容标记为“需要人工确认”，不要编造。 - 先做资料索引，再生成知识点地图，不要直接总结全部课程。 - 区分“核心知识点”“补充知识点”“案例”“作业”“FAQ”。 - 如果不同资料说法冲突，必须列出冲突来源。 ## 输出格式 - 课程索引：COURSE_INDEX.md - 知识点地图：KNOWLEDGE_MAP.md - 章节笔记：output/lesson-notes/ - 复习清单：REVIEW_CHECKLIST.md - 学习路径：LEARNING_PATHS.md - 遗漏报告：COURSE_GAP_REPORT.md ## 验收标准 - 重要知识点都有定义、来源、前置知识、案例和练习。 - 章节笔记可以让没有听过直播的人理解本节重点。 - 复习清单能用于自测，不只是内容摘要。 - 所有新增内容都能追溯到原始资料或人工笔记。

AGENTS.md 的重点不是写得很长，而是把“不要编造、必须标记来源、先索引再整理、输出到哪里”这些容易反复出错的规则固定下来。

十一、完整一键 Codex 指令

如果课程资料已经放进项目目录，可以直接使用下面这段完整指令。第一次执行时建议让 Codex 只生成报告，不要自动大规模改写资料。

Codex 一键执行指令

请你作为课程资料整理助手，帮我整理当前项目中的课程资料。 目标： 把 raw、notes、assignments、examples 目录中的资料整理成课程索引、知识点地图、章节学习笔记、复习清单、学习路径和遗漏报告。 工作顺序： 1. 先读取 AGENTS.md，遵守其中的课程整理规则。 2. 扫描课程资料，生成 COURSE_INDEX.md。 3. 基于索引生成 KNOWLEDGE_MAP.md。 4. 为每节课生成章节学习笔记，放到 output/lesson-notes/。 5. 生成 REVIEW_CHECKLIST.md，包括复习清单、测验题、练习任务和验收标准。 6. 生成 LEARNING_PATHS.md，包括新手入门、快速上手、项目实战、考前复习 4 种路径。 7. 生成 COURSE_GAP_REPORT.md，列出资料遗漏、顺序问题、重复知识点、缺失案例和需要人工确认的内容。 限制： - 不要修改 raw 目录中的原始资料。 - 不要编造课程中没有出现的知识点。 - 所有知识点都要标记来源文件。 - 不确定内容必须写“需要人工确认”。 - 输出内容要适合课程负责人、助教、学生和运营人员直接使用。 完成后请给我一份变更摘要，说明新增了哪些文件、发现了哪些主要问题、下一步建议人工补充什么。

十二、适合课程创作者的输出模板

整理课程资料不一定只服务学习。课程团队通常还需要把资料拆成多个可交付物，例如帮助中心、课后邮件、社群打卡、销售页、公开课脚本和课程迭代清单。

十三、常见错误：为什么整理完还是不好用

• 只生成摘要，没有生成知识点关系。摘要只能看一遍，不能支撑复习、练习和课程迭代。

• 没有标记来源。后续一旦内容错了，没人知道应该回到哪份课件或字幕检查。

• 没有区分核心知识点和补充内容。学生会把所有内容都当重点，学习压力变大。

• 没有检查作业和课程内容是否匹配。很多课程断点都出现在“作业要求会做，但课程没教”。

• 把老师口语化表达直接当成定义。直播字幕适合提炼重点，但不一定适合作为最终定义。

• 一次性让 Codex 处理全部资料。资料太多时，应先索引，再按模块处理，再合并。

• 没有人工复核。课程内容涉及专业判断，Codex 可以整理结构，但不能替代老师确认口径。

十四、人工验收清单

用 Codex 整理完课程资料后，至少用下面这份清单检查一次。不要只看文件是否生成，要看是否真的能用于学习和交付。

十五、FAQ：用 Codex 整理课程资料常见问题

1. Codex 能直接整理视频课程吗？

不能把它当成破解或直接抓取视频平台内容的工具。更稳的做法是先准备合法导出的字幕、讲义、课件、笔记和作业文件，再交给 Codex 整理。

2. PDF 课件可以整理吗？

可以，但前提是 PDF 里的文字能被正常读取。如果是扫描件或图片型 PDF，需要先转成可读取文本，再让 Codex 做知识点提取。

3. 课程资料很多，一次性处理可以吗？

不建议。先让 Codex 生成 COURSE_INDEX.md，再按模块处理。资料越多，越要分阶段，否则容易漏掉来源、混淆章节或生成过度概括的内容。

4. Codex 生成的知识点可以直接发给学生吗？

不建议直接发。至少要由课程负责人复核专业口径、术语定义、案例准确性和作业难度。Codex 适合做初稿和结构化整理，不适合替代最终教学判断。

5. 课程 FAQ 应该从哪里来？

优先来自学员真实问题、作业错误、客服记录和老师反复解释的内容。只从课件生成 FAQ 容易缺少真实疑问。

6. 课程整理结果后续怎么维护？

把规则写进 AGENTS.md，把新资料统一放到 raw 或 notes 目录，每次新增资料后让 Codex 更新 COURSE_INDEX.md、KNOWLEDGE_MAP.md 和 COURSE_GAP_REPORT.md。

十六、总结

用 Codex 整理课程资料，核心不是“让它总结课程”，而是把课程当成一个可维护的知识项目来处理。先整理资料索引，再生成知识点地图，再做章节笔记、复习清单、学习路径和遗漏报告，最后把规则沉淀到 AGENTS.md。

这样做的结果会比普通摘要更有价值：学生知道怎么学，助教知道怎么答疑，课程负责人知道哪里需要补充，运营团队也能把课程内容拆成 FAQ、卖点、社群打卡和复习材料。真正有用的课程整理，不是把资料变短，而是把资料变清楚、可追踪、可复习、可交付。

参考资料

• OpenAI Developers - Codex web：Codex 是可以读取、编辑和运行代码的 编程智能体，也可帮助理解陌生代码库。

• OpenAI Developers - 任务指令ing：Codex 提示词应包含任务、上下文、相关文件和验证步骤；复杂任务适合拆成小步骤。

• OpenAI Developers - Best practices：复杂任务建议先规划；稳定规则适合沉淀到 AGENTS.md。

• OpenAI Developers - Custom instructions with AGENTS.md：Codex 会在开始工作前读取 AGENTS.md，并按全局、项目和子目录规则组合指令。