
Course Generator
- 102 installs
- 543 repo stars
- Updated August 5, 2026
- cat-xierluo/legal-skills
Turn transcripts and literature into structured course documents, archive courses to a knowledge base, or extract custom course plans from existing material.
About
A course content platform with three modes: generate structured courses from transcripts/literature, archive courses into a knowledge base, and extract custom course plans from existing material, with a user dictionary to fix mis-transcribed terms. A developer or trainer uses it to convert long transcripts into readable, well-structured course documents.
- Three modes: generate, archive, extract
- User dictionary corrects transcription term errors
Course Generator by the numbers
- 102 all-time installs (skills.sh)
- Ranked #645 of 1,879 Documentation skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/cat-xierluo/legal-skills --skill course-generatorAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 102 |
|---|---|
| repo stars | ★ 543 |
| Last updated | August 5, 2026 |
| Repository | cat-xierluo/legal-skills ↗ |
What it does
Turn transcripts and literature into structured course documents, archive courses to a knowledge base, or extract custom course plans from existing material.
Files
Course Generator v2.3.3
概述
课程内容管理平台,支持三种工作模式:
| 模式 | 触发场景 | 输入 | 输出 |
|---|---|---|---|
| 生成模式 | 有新的转录稿/文献需要整理为课程 | 转录稿、文献文件 | 结构化课程文档 |
| 归档模式 | 课程文件需要整理到知识库 | 已生成的课程文件 | 按规范归档的知识库目录 |
| 提取模式 | 客户提出培训需求,需要定制方案 | 客户需求描述 | 定制化课程方案文档 |
核心原则:
- 忠实原文:保留文献中的核心观点、具体例子、重要表述,不添加文档外信息
- 叙述性写作:以段落论述为主,避免用要点堆砌替代完整论证
- 详尽完整:总览 + 专题文档,包含核心观点、案例分析、重要表述、数据支撑、背景信息
- 高保真正文增强:生成模式不是轻量摘要,应少压缩、多保留有思想密度的观点、案例、判断、金句、工具选择理由、踩坑经验和真实疑问
- 独立正文去来源痕迹:最终章节应像独立文章或书稿章节,不反复出现"现场演示"、"课程现场"、"现场问答"、"主讲人提到"等转录来源表述
- 专有名称保真:保留 Skill 名称、工具名、项目名、产品名、命令名、API、文件名和框架名的原始语言和大小写;原文是
Course Generator、Claude Code、Codex、Cursor、Markdown等英文专有名称时,不翻译成中文 - 图片资产保真与克制插图:图片资产表完整保留原文 Markdown 图片引用的 URL、alt 文本和原始顺序;正文只插入能帮助理解核心观点、流程、案例或工具界面的高价值图片,避免把章节变成图片堆叠
- 正文密度不因少插图而下降:图片筛选只控制插图密度,不得借此压缩原文中的高价值观点、案例链路、判断依据、问答疑惑和实践细节
- 智能处理:自动识别并去除发言人标记、时间戳,提取配图链接,清洗冗余信息,结合用户词典校正术语,转换口语为书面语
- 结构适配:根据素材自身的流程、框架、能力模型或主题关系选择结构表达,不套固定模板
- 可读性优先:控制段落长度,三级标题使用编号,保持章节边界清楚,避免相近主题重复展开
模式识别
根据用户输入自动判断工作模式:
- 生成模式:用户提供了文件/目录路径,或明确要求"生成课程""整理文献""从转录稿生成"
- 归档模式:用户要求"归档""整理到知识库""保存课程"
- 提取模式:用户描述了培训需求(受众、时长、方向),如"给某企业做培训,需要 XX 内容"
Step 0:读取配置
首次使用时,先复制 config/paths.example.yaml 为 config/paths.yaml,再读取 config/paths.yaml 获取路径配置。
如需启用用户词典,复制 config/user_dictionary.example.yaml 为 config/user_dictionary.yaml,在 terms 中添加正确术语即可。用户词典只记录正确写法,不需要维护"错误词 -> 正确词"映射。
路径规则:
knowledge_base、archive_root、curriculum_file、training_root强烈建议使用绝对路径- 只有在明确知道当前工作目录时,才使用相对路径;相对路径默认相对于当前工作目录解析
- 路径中包含空格、中文或 emoji 时,YAML 值必须放在引号中
knowledge_base:知识库根目录archive_root:课程归档路径archive_naming:归档目录命名规范curriculum_file:课程主题体系文件路径training_root:培训材料根目录
用户词典规则:
config/user_dictionary.yaml不存在或terms为空时,跳过术语校正terms中的每一项都是正确术语,输出时应按词典中的大小写和写法呈现- 仅在上下文明确指向某个词典术语时,才将近似误转写替换为该术语
- 可校正大小写、空格、标点、音近/形近、英文术语被拆分或被转成中文近音等高置信错误
- 不要将英文专有名称翻译成中文;如果词典或原文中出现
Course Generator,后续输出应保留Course Generator,而不是改写为"课程生成器" - 模糊或低置信场景保持原文,不做猜测式替换
- 校正只用于生成课程内容,不修改原始转录文件,也不在成品课程文档中输出校正日志
---
生成模式
流程
读取文献 → 读取用户词典 → 校正近似误转写 → 建立图片资产表并筛选正文配图 → 智能识别内容特征 → 生成课程大纲 → 生成总览+专题 → 归档到知识库Step 1:读取文献文件
使用 Glob 工具一次性读取指定目录下的所有文献文件:
Glob: {输入目录}/**/*.{md,txt}保持完整上下文,一次性读取所有文件内容。
Step 2:读取用户词典并校正术语
如果存在 config/user_dictionary.yaml,读取其中的 terms 列表。将这些术语视为正确写法,在转录稿和文献内容中查找高度相近且上下文明确的误转写,并统一替换为词典中的术语写法。
示例:词典中包含 OpenClaw 时,如果转录稿出现明显指向该工具或平台的近似写法,应在后续大纲、总览和章节中统一写作 OpenClaw。
不要把用户词典理解为替换映射表;用户只维护正确术语,AI 负责基于上下文识别可能的误转写。不要为了使用词典而强行替换普通词,也不要补充词典中不存在的术语。
Step 3:建立图片资产表并筛选正文配图
如果原文包含 Markdown 图片引用(如 ),先按原文出现顺序建立图片资产表:
- 为每张图片分配稳定编号:
IMG-001、IMG-002、IMG-003... - 原样保留图片 Markdown:alt 文本、URL、括号和路径均不改写
- 记录图片附近的时间戳、前后 1-3 段文字或标题,作为归属章节判断依据
- 归属章节时优先根据图片邻近内容和时间顺序判断;同一章节内图片必须按原文出现顺序排列
- 区分"资产保留"和"正文插入":图片资产表尽量完整保留图片引用,但正文不需要插入所有图片
- 为每张图片标注图片价值:
核心图、辅助图、低价值图、跳过图 - 为每张图片标注正文处理:
插入正文、仅资产表保留、跳过 - 核心图通常包括方法框架、工具界面、关键流程、案例证据、对比结论、操作结果等能独立增加理解的信息,应优先插入正文
- 辅助图只有在能支撑相邻段落理解、且不会造成图片堆叠时才插入正文
- 会务测试、音频调试、空白页、过渡页、纯标题页、重复页、装饰页或无法贡献课程理解的图片,标注为
仅资产表保留或跳过,并说明原因 - 同一位置连续插入图片原则上不超过 2 张,确有必要时最多 3 张;如果一组图片更多,应选择代表图插入,其余仅在资产表保留或分散到不同小节
- 如果无法判断归属,放入时间位置最接近的章节;如果无法判断是否应进正文,默认先
仅资产表保留,不要把低置信图片塞进正文 - 图片筛选只影响图片是否进入正文,不影响正文素材保留力度;不要因为删减图片而同步删减对应案例、操作逻辑、判断理由或问答中有价值的信息
Step 4:智能识别内容特征
检测文件特征,自动识别内容类型:
- 发言人标记:发言人1、发言人2等
- 时间戳模式:00:00、12:34等格式
- 配图链接:包含图片URL链接
- 转录特征:口语化表达、操作过程描述、临时插话和补充讨论等
根据识别的内容特征,自动选择最合适的处理方式。
Step 5:生成课程大纲
调用 AI 模型,一次性分析所有文献并生成课程大纲。详见 outline_prompt.md。
核心要求:
- 整体把握:理解所有内容的整体脉络和逻辑关系
- 主题识别:基于所有内容自动识别主要主题
- 内容优化:清洗冗余信息,保留核心内容,转换口语为书面语
- 高价值素材识别:显式识别核心观点、方法论、实践案例、工具选择理由、踩坑经验、反直觉判断、可迁移表达和问答素材中的真实疑惑
- 术语校正:根据用户词典识别并修正高置信的近似误转写,统一使用词典中的正确写法
- 专有名称保真:保留英文 Skill 名称、工具名、产品名、命令名、API、文件名和框架名,不把
Course Generator等专有名称意译成中文 - 课程组织:按主题生成章节,明确每章边界,标注核心章节,案例、问答和展望融入相应主题
- 配图处理:建立图片资产表,保留图片 Markdown 原文、原始顺序、章节归属、图片价值、正文处理和放置建议;正文只插入核心图和必要辅助图
输出格式:
课程标题:[基于原文生成的课程名称]
第一章 [主题名称] - 核心观点摘要
边界: [本章负责的问题范围]
高价值素材: [观点、案例、判断、金句、真实疑问或实践细节]
本章正文配图: [只列出标注为插入正文的 IMG-001, IMG-002...;无则写"无"]
第二章 [主题名称] - 核心观点摘要
边界: [本章负责的问题范围]
高价值素材: [观点、案例、判断、金句、真实疑问或实践细节]
本章正文配图: [只列出标注为插入正文的 IMG-003, IMG-004...;无则写"无"]Step 6:生成总览文档
详见 overview_prompt.md。
总览中的结构导览是可选模块。只有当素材确实包含流程链路、方法框架、能力模型或系统架构时,才加入简短导览;导览标题应根据内容自动命名,不能固定套用"核心工作流地图"。
输出文件名:00 [课程名称] - 总览.md
Step 7:生成专题文档
详见 chapter_prompt.md。
可选模块架构:AI 从 11 个可选模块中选择合适的组合:
| 模块名称 | 适用场景 |
|---|---|
| 引言与概述 | 需要背景介绍和内容导航 |
| 核心概念与原理 | 理论性内容,需要概念阐释 |
| 理论框架 | 学术性、理论性较强的内容 |
| 历史背景 | 需要时间线或发展历程的内容 |
| 实践案例 | 有具体应用实例的内容 |
| 应用场景 | 需要场景说明的内容 |
| 最佳实践 | 需要操作指南的内容 |
| 对比分析 | 需要比较不同方案/观点的内容 |
| 未来展望 | 有前瞻性、趋势性内容 |
| 本章小结 | 需要总结回顾的内容 |
| 延伸阅读 | 有相关资源推荐的内容 |
默认推荐组合:
- 理论类:引言与概述 + 核心概念与原理 + 本章小结
- 实践类:引言与概述 + 应用场景 + 最佳实践 + 本章小结
- 案例类:引言与概述 + 实践案例 + 对比分析 + 本章小结
- 综合类:根据内容特点灵活组合
排版与可读性要求:
- 三级标题统一使用
### 1、标题格式,每个二级标题下从1重新编号 - 段落目标长度约 160-240 个中文字符,超过 260 字优先拆分,避免 300 字以上长段
- 同一段只讲一个核心意思,避免把概念定义、案例说明和价值判断塞进同一段
- Q&A 必须按主题融入对应章节,转化为常见疑问、补充解释、案例回应或实践注意事项,不单独成章,也不机械保留问答格式
- 操作过程、补充讨论和工具选择过程应提炼为案例、方法、取舍或实践经验,不要压缩成一句泛泛结论,也不要在正文中保留"现场演示"式来源叙述
- 只有大纲标注为
插入正文的本章正文配图必须插入正文,使用原始 Markdown 图片引用,不改 URL,不改 alt,不重新排序;标注为仅资产表保留或跳过的图片不得强行插入正文 - 同一小节连续图片原则上不超过 2 张,确有必要时最多 3 张;超过时选择代表图,或分散到真正相关的不同段落之后
- 图片数量减少不等于正文压缩,章节仍需保留原素材中的案例链路、工具取舍、限制条件、真实疑问和可迁移表达
- 允许使用少量“关键判断”“实践启发”“方法框架”等三级标题突出重点,但必须服务正文论证,不把章节写成提纲
- 保持叙述性写作,但流程、步骤、术语映射、工具对比等场景可以使用简短列表或箭头链路辅助理解
Step 8:创建输出目录并保存
1. 读取 config/paths.yaml 中的 archive_root 和 archive_naming 2. 按命名规范创建目录:YYMMDD 课程主题/ 3. 保存文件:
- 总览:
00 [课程名称] - 总览.md - 章节:
0X [章节序号] [主题名称].md
4. 目录位于 archive_root 下,由配置文件决定实际位置
---
归档模式
流程
读取课程文件 → 确定归档路径 → 移动/复制 → 更新索引Step 1:读取待归档课程
使用 Glob 读取指定目录下的课程文件。优先识别当前标准命名,同时兼容旧命名:
- 总览:
00 [课程名称] - 总览.md - 兼容旧总览:
00_*.md - 章节:
0X [主题名称].md - 兼容旧章节:
0X_*.md
Step 2:确定归档路径
1. 读取 config/paths.yaml 配置 2. 从总览文件中提取课程名称和日期信息 3. 按命名规范确定目标路径:{archive_root}/{YYMMDD} {课程主题}/
Step 3:归档文件
1. 使用 Bash 创建目标目录 2. 将课程文件复制到目标目录 3. 验证文件完整性(总览 + 全部章节)
Step 4:更新索引
如果知识库目录下存在 README.md,将新课程添加到索引中。
---
提取模式
流程
解析需求 → 匹配课程 → 定位素材 → 提取重组 → 输出方案Step 1:解析客户需求
从需求描述中提取关键信息:
- 受众:企业法务 / 律师 / 法律研发 / 产品团队
- AI 基础水平:零基础 / 有一定经验 / 技术背景
- 培训时长:2-3 小时 / 半天 / 1 天 / 多天
- 重点方向:认知 / 工具 / Agent-Skill / 案例 / 组织 / 超级个体
Step 2:匹配课程讲次
读取配置中的 curriculum_file,根据需求匹配讲次组合:
1. 基于受众和基础水平确定阶段范围 2. 基于培训时长确定讲次数(每讲约 60-90 分钟) 3. 基于重点方向优先匹配对应讲次 4. 确保选取的讲次逻辑连贯
Step 3:定位素材文件
根据匹配到的讲次,在知识库中定位对应的素材源文件:
1. 对照 curriculum_file 中的素材来源目录 2. 使用 Glob 搜索知识库目录下的相关文件 3. 优先读取总览文件了解内容全貌,优先匹配 00 [课程名称] - 总览.md,兼容旧命名 00_*.md 4. 按需深入读取具体章节
Step 4:提取与重组
详见 extract_prompt.md。
核心原则:
- 忠实原文:保留素材中的核心观点、案例、数据
- 逻辑重组:按培训的时间线和认知逻辑重新组织
- 受众适配:根据受众水平调整内容深度
- 时长控制:根据培训时长裁剪内容量
Step 5:输出课程方案
输出定制化课程方案文档,保存到 training_root 目录下。
方案格式包含:培训目标、课程结构(各部分主题+时长+核心内容+详细内容)、素材来源。
---
参考文档
- config/paths.example.yaml - 路径配置模板
- config/user_dictionary.example.yaml - 用户词典模板
config/paths.yaml- 本地实际路径配置(不提交到仓库)config/user_dictionary.yaml- 本地用户词典(不提交到仓库)- references/outline_prompt.md - 课程大纲生成提示词
- references/overview_prompt.md - 总览文档生成提示词
- references/chapter_prompt.md - 专题文档撰写提示词
- references/extract_prompt.md - 提取模式提示词
变更日志
[2.3.3] - 2026-05-06
修复
- 图片正文插入过度:修正 v2.3.2 容易把图片资产表中的图片全部插入正文的问题,避免章节退化为幻灯片堆叠。
- 连续图片堆叠:新增同一位置连续配图数量控制,原则上不超过 2 张,确有必要时最多 3 张。
改进
- 图片资产分级:大纲阶段为每张图片标注
核心图、辅助图、低价值图或跳过图,并区分插入正文、仅资产表保留和跳过。 - 正文配图克制:保留图片资产表的完整追溯能力,但正文只插入能支撑核心观点、流程、案例或工具界面的高价值图片。
- 正文密度保护:明确图片筛选只影响图片是否进入正文,不得同步压缩高价值观点、案例链路、工具取舍、真实疑问和实践细节。
文档完善
- 更新
SKILL.md、references/outline_prompt.md、references/overview_prompt.md、references/chapter_prompt.md。 - 同步
README.md与.claude-plugin/marketplace.json中的 course-generator 版本和描述。
---
[2.3.2] - 2026-05-01
修复
- 图片引用保真:修复生成模式中原始 Markdown 图片引用容易在总览和章节生成阶段丢失的问题。
- 图片顺序稳定:新增图片资产表,要求按原文顺序为图片分配
IMG-xxx编号,并按章节归属保持顺序插入正文。 - 图片归属规则:要求根据图片邻近时间戳、前后文和主题判断归属章节;无法判断时放入时间位置最接近的章节,不直接删除。
文档完善
- 更新
SKILL.md、references/outline_prompt.md、references/overview_prompt.md、references/chapter_prompt.md。 - 同步
README.md与.claude-plugin/marketplace.json中的 course-generator 版本和描述。
---
[2.3.1] - 2026-05-01
修复
- 独立正文去来源痕迹:修正 v2.3.0 高保真正文增强后容易反复出现"现场演示""课程现场""现场问答"等来源叙述的问题。
- 操作过程正文化:要求将演示、问答和补充讨论转化为实践案例、应用场景、常见疑问或操作流程,而不是在章节中保留转录现场痕迹。
- 英文专有名称保真:明确保留 Skill 名称、工具名、项目名、产品名、命令名、API、文件名和框架名的原始英文写法,避免将
Course Generator等专有名称意译成中文。
文档完善
- 更新
SKILL.md、references/outline_prompt.md、references/overview_prompt.md、references/chapter_prompt.md、config/user_dictionary.example.yaml。 - 同步
README.md与.claude-plugin/marketplace.json中的 course-generator 版本和描述。
---
[2.3.0] - 2026-05-01
改进
- 高保真正文增强:生成模式明确采用书稿素材取向,不再只做轻量摘要,要求少压缩、多保留有思想密度的观点、案例、判断、金句和实践细节。
- 价值抽取标准强化:大纲生成阶段新增高价值素材识别,覆盖方法论、工具选择理由、踩坑经验、反直觉判断、可迁移表达和现场问答中的真实疑惑。
- 章节正文增强:专题文档要求将案例背景、问题、做法、结果和启发写完整,并说明工具或方案取舍的适用条件与局限。
- 问答融入规则固化:Q&A 必须作为正文素材按主题融入章节,不单独成章,也不机械保留问答格式。
文档完善
- 更新
SKILL.md、references/outline_prompt.md、references/overview_prompt.md、references/chapter_prompt.md。 - 同步
README.md与.claude-plugin/marketplace.json中的 course-generator 描述和版本号。
---
[2.2.0] - 2026-05-01
改进
- 结构判断优化:生成模式要求识别主讲内容、现场演示、问答和补充讨论四类素材,按主题组织章节并输出章节边界说明。
- 问答融合规则:Q&A 不再作为独立章节处理,而是融入对应正文,转化为常见疑问、补充解释、案例回应或实践注意事项。
- 可读性优化:专题文档要求三级标题使用编号格式,控制段落长度,避免长段堆叠。
- 结构导览改为可选:总览仅在素材确实包含流程链路、方法框架、能力模型或系统架构时加入导览,不固定生成工作流地图。
文档完善
- 更新
SKILL.md、references/outline_prompt.md、references/overview_prompt.md、references/chapter_prompt.md。 - 同步
README.md与.claude-plugin/marketplace.json中的 course-generator 描述和版本号。
---
[2.1.0] - 2026-04-30
新增
- 用户词典术语纠错:生成模式支持读取
config/user_dictionary.yaml中的正确术语列表,在转录稿中识别高置信的近似误转写,并统一改为词典中的正确写法。 - 词典模板:新增
config/user_dictionary.example.yaml,用户只需维护正确术语,不需要维护错误词到正确词的映射表。
改进
- 更新
SKILL.md:在生成模式中增加用户词典读取、近似误转写校正和低置信不替换规则。 - 更新
references/outline_prompt.md、references/overview_prompt.md、references/chapter_prompt.md:贯穿术语校正和术语一致性要求,避免后续生成阶段恢复转录错误。 - 更新
README.md与.claude-plugin/marketplace.json中的 course-generator 描述和版本号。
---
[2.0.1] - 2026-04-24
修复
- 路径配置改为绝对路径优先:补充
config/paths.example.yaml模板说明,明确建议在config/paths.yaml中使用绝对路径,避免因当前工作目录不同导致找不到知识库、课程体系和培训目录 - 兼容旧版总览命名:提取模式和归档模式统一优先匹配
00 [课程名称] - 总览.md,同时兼容旧命名00_*.md
文档完善
- 更新
SKILL.md:补充首次使用配置步骤、路径解析规则、总览文件命名兼容规则 - 更新
references/extract_prompt.md:补充绝对路径要求和总览文件匹配规则 - 同步
README.md与.claude-plugin/marketplace.json中的 skill 描述和版本号
---
[2.0.0] - 2026-04-23
重大更新
- 三模式架构:从单一课程生成工具升级为课程内容管理平台
- 生成模式(保留):转录稿/文献 → 结构化课程,新增自动归档
- 归档模式(新增):将课程文件按
YYMMDD 主题/规范整理到知识库 - 提取模式(新增):根据客户培训需求,从现有素材中提取重组课程方案
- 配置系统:新增
config/paths.yaml,可配置知识库路径、归档命名规范、课程主题体系路径 - 课程主题体系:通过
curriculum_file配置指向外部课程体系文件,不再内嵌到 skill 中
新增文件
config/paths.example.yaml— 路径配置模板config/paths.yaml— 本地路径配置(不提交到仓库)references/extract_prompt.md— 提取模式提示词
改进
- 生成模式完成后自动进入归档流程(可跳过)
- 模式自动识别:根据用户输入判断使用哪种模式
- 版本号从 1.3.1 升级到 2.0.0
---
[1.3.1] - 2026-02-10
修复
- 移除内容来源归属表述:修复生成课程内容时频繁出现"主讲人强调"、"主讲人指出"、"主讲人提到"等表述的问题
- 更新核心原则:明确要求去除发言人标记,将内容直接呈现而非强调说话者
- 在所有提示词模板中添加"客观陈述"要求
- 将转录内容转换为客观的知识陈述形式,而非会议记录形式
改进
- 强化自然表达要求:
- 禁止使用"主讲人强调"、"主讲人指出"、"主讲人提到"、"主讲人认为"、"发言人表示"等表述
- 直接陈述内容本身,不强调内容来源归属
- 去除发言人标记,将内容整合为连贯的叙述
技术优化
- 更新
skill.md(2处):核心原则中的"智能处理"和质量标准中的"自然表达" - 更新
references/chapter_prompt.md:完全重写"自然表达"条款,增加4条具体子要求 - 更新
references/outline_prompt.md:在"内容优化"部分添加去除发言人标记的要求 - 更新
references/overview_prompt.md:新增第4条核心要求"客观陈述"
---
[1.3.0] - 2026-02-07
改进
- 可选模块架构:将固定的5部分章节结构改为可选模块库
- 提供 11 个可选模块(引言与概述、核心概念与原理、理论框架、历史背景、实践案例、应用场景、最佳实践、对比分析、未来展望、本章小结、延伸阅读)
- AI 根据内容类型和特征智能选择合适的模块组合
- 提供默认推荐组合(理论类、实践类、案例类、综合类)
- 每章至少 2 个模块,遵循逻辑关系
技术优化
- 更新
references/chapter_prompt.md- 从固定结构改为可选模块架构 - 更新 SKILL.md - 反映新的可选模块设计
- 提升技能对不同类型内容的适应性
文档更新
- 更新 DECISIONS.md - 添加可选模块架构决策记录
- 更新 TASKS.md - 添加 v1.3.0 任务记录
---
[1.2.0] - 2026-02-07
新增功能
- 智能内容识别:自动检测发言人、时间戳、配图等特征,智能选择处理方式
- 总览文档输出:新增
00_课程名称-总览.md,包含课程概述、学习目标、课程结构、学习路径建议 - 配图处理:自动识别配图链接并合理安排到相关主题章节
- 内容优化:清洗冗余信息,转换口语为书面语
改进
- 强化叙述性写作:完全避免要点列表,使用段落形式,保持逻辑连贯
- 案例融合原则:案例和展望内容智能融入相关主题章节,不单独成章
- 中文标题序号:使用"一二三"标题序号,更符合中文阅读习惯
- 专题文档结构:5部分结构(引言与概述、核心概念与原理、实践案例分析、应用场景与最佳实践、本章小结)
- 输出位置优化:输出目录改在输入文件所在位置
文档更新
- 新增
references/overview_prompt.md- 总览文档生成提示词 - 更新
references/outline_prompt.md- 添加内容优化、案例融合原则 - 更新
references/chapter_prompt.md- 采用5部分结构,强化叙述性写作 - 更新 SKILL.md - 反映新的工作流程和功能
- 更新 DECISIONS.md - 添加 v4.3 升级决策记录
技术变更
- 版本基于 Command v4.3
- 工作流程从 5 步扩展到 7 步(增加智能识别和总览生成)
- 文件命名从
XX_序号_标题.md改为00_总览.md+0X_序号_标题.md
---
[1.1.0] - 2026-02-07
改进
- 合并工作流程步骤:将"整体分析"和"生成课程大纲"合并为一步
- 减少不必要的中间输出(分析报告)
- 减少 AI 调用次数,提升响应速度
- 保持思维连贯性,避免上下文切换
- 更符合人脑处理信息的自然方式
技术优化
- 删除
references/analysis_prompt.md,功能合并到outline_prompt.md - 简化工作流程:从 6 步减少到 5 步
- 优化提示词模板,直接输出课程大纲
文档更新
- 更新 SKILL.md,反映新的工作流程
- 更新 DECISIONS.md,添加解耦决策记录
---
[1.0.0] - 2026-02-07
新增
- 初始版本发布:从 extract-course.md Command 转换为标准 Skill 格式
- 课程生成功能:从多个文献内容中系统化提取并生成结构化课程
- 支持 1-100+ 个文献文件的处理
- 自动进行整体主题识别和内容分类
- 基于原文生成系统化课程大纲
- 逐章节生成详细的段落式内容
- 核心原则:
- 忠实原文:保留文献中的核心观点、具体例子、重要表述,不添加文档外信息
- 段落式写作:避免要点罗列,包含完整的论证和阐述
- 详尽完整:每个章节包含核心观点、案例分析、重要表述、数据支撑、背景信息
v1.0.0 工作流程
1. 读取文献文件:使用 Glob 工具一次性读取指定目录下的所有文献文件 2. 整体分析内容:调用 AI 模型进行整体主题识别和内容分类 3. 生成课程大纲:基于分析结果生成完整课程大纲 4. 逐章节生成内容:为每个章节生成详细的段落式内容 5. 创建输出目录:以 AI 生成的课程名称创建文件夹 6. 保存章节文件:为每个章节创建独立文件
提示词模板(v1.0.0)
- references/analysis_prompt.md:整体分析提示词
- references/outline_prompt.md:课程大纲生成提示词
- references/chapter_prompt.md:章节内容撰写提示词
文档完善
- 添加 MIT License(LICENSE.txt)
- 创建 SKILL.md 主文件,包含完整工作流程说明
- 创建 CHANGELOG.md 版本变更记录
- 创建 DECISIONS.md 决策记录
- 创建 TASKS.md 任务管理
技术优化
- 使用 Progressive Disclosure 设计原则,将详细提示词移至 references/ 目录
- 保持 SKILL.md 简洁,便于快速理解和执行
- 模块化提示词设计,便于后续迭代优化
待办事项
- 收集用户使用反馈,优化提示词模板
- 考虑添加更多输出格式选项(如 PDF、Word)
- 考虑添加课程封面生成功能
---
原始版本记录(Command 时期)
v4.3 (2025-12-15)
- 体验优化:输出目录改在输入文件所在位置,添加标题序号(一二三、123),进一步优化叙述性写作
v4.2 (2025-12-15)
- 内容优化:强化叙述性写作,生成可直接用于书籍出版的章节内容,避免要点式罗列
v4.1 (2025-12-15)
- 流程简化:统一处理逻辑,自动识别内容类型,无需区分标准文献和转录内容
v4.0 (2025-12-15)
- 优化升级:增强内容处理能力,智能识别发言人、时间戳、配图等特征,默认生成总览和专题文档
v3.2 (2025-11-21)
- 优化表达方式:移除"原文中"等生硬表述,使内容表达更加自然流畅
v3.1 (2025-11-14)
- 通用化优化:支持1-100+个文献,生成系统化课程章节
v3.0 (2025-11-14)
- 重大简化:文件从500行缩短至195行,保留核心要点和流程
v2.3 (2025-11-14)
- 优化输出目录命名:使用AI生成的课程名称作为文件夹名
v2.2 (2025-11-14)
- 移除所有导航文档,仅保留核心内容章节
v2.1 (2025-11-14)
- 优化读取方式:一次性读取所有文件,保持完整上下文
v2.0 (2025-11-14)
- 严格要求忠实于原文,改为信息整理导向
v1.0 (2025-11-14)
- 初始版本
# 个性化配置文件(包含实际路径,不提交到仓库)
paths.yaml
user_dictionary.yaml
# Course Generator 路径配置模板
# 首次使用请复制为 paths.yaml,并改成你本机的真实绝对路径
# 强烈建议使用绝对路径,避免因当前工作目录不同而找不到素材
# 知识库根目录(绝对路径)
knowledge_base: "/Users/yourname/Documents/工作文档/300 - 法律AI/2 - 📚 知识整理"
# 课程归档路径(绝对路径)
archive_root: "/Users/yourname/Documents/工作文档/300 - 法律AI/2 - 📚 知识整理"
# 归档目录命名规范({date} = YYMMDD, {topic} = 课程主题)
archive_naming: "{date} {topic}"
# 课程主题体系文件路径(绝对路径)
curriculum_file: "/Users/yourname/Documents/工作文档/300 - 法律AI/2 - 📚 知识整理/课程体系/杨卫薪律师法律AI课程主题体系.md"
# 课程培训材料根目录(绝对路径)
training_root: "/Users/yourname/Documents/工作文档/300 - 法律AI/1 - 🎓 讲课培训"
# Course Generator 用户词典模板
# 首次使用请复制为 user_dictionary.yaml,并在 terms 中维护正确术语
# 本文件只记录正确写法,不需要维护"错误词 -> 正确词"映射
version: 1
# 正确术语列表
# 生成模式会在转录稿中识别高置信的近似误转写,并统一改为这里的写法
terms:
- "Course Generator"
- "OpenClaw"
- "Claude Code"
- "Cursor"
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
Copyright (c) 2026 杨卫薪律师(微信ywxlaw)
=======================================================================
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
You are free to:
- Share — copy and redistribute the material in any medium or format
- Adapt — remix, transform, and build upon the material
Under the following terms:
- Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made.
- NonCommercial — You may not use the material for commercial purposes.
- ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license.
No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
To view a copy of this license, visit:
http://creativecommons.org/licenses/by-nc-sa/4.0/
=======================================================================
Commercial License
For commercial use licenses, please contact:
Email: secretxierluo@gmail.com
WeChat: ywxlaw (微信)
=======================================================================
The full text of the CC BY-NC-SA 4.0 license is reproduced below:
CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
LEGAL SERVICES. DISTRIBUTION OF THIS LICENSE DOES NOT CREATE AN
ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING
FROM THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
HEREUNDER.
Section 1 – Definitions.
Adapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.
Adapter's License means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.
BY-NC-SA Compatible License means a license licensed by You under the terms of this Public License that meets the following conditions: (i) is listed at https://creativecommons.org/compatiblelicenses; (ii) includes the same elements as this Public License; and (iii) complies with the conditions of this Public License.
Copyright and Similar Rights means copyright and/or similar rights closely related to copyright, including without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.
Effective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.
Exceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.
License Elements means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution, NonCommercial, and ShareAlike.
Licensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License.
Licensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.
Licensor means the individual(s) or entity(ies) granting rights under this Public License.
NonCommercial means not primarily intended for or directed towards commercial advantage or monetary compensation. For purposes of this Public License, the exchange of the Licensed Material for other material subject to Copyright and Similar Rights by digital file-sharing or similar means is NonCommercial provided there is no payment of monetary compensation in connection with the exchange.
Share means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.
Sui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.
You means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.
Section 2 – Scope.
Subject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:
reproduce and Share the Licensed Material, in whole or in part, for NonCommercial purposes only; and
produce, reproduce, and Share Adapted Material for NonCommercial purposes only.
Exceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.
Term. The term of this Public License is specified in Section 6(a).
Media and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.
Downstream recipients. Each recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.
No endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated as receiving attribution as provided in Section 3(a)(1)(A)(i).
Other rights. Moral rights, rights against unfair competition, rights to protect publicity, privacy, or personality rights, and any other rights other than Copyright and Similar Rights are not subject to this Public License. Additional rights may apply to the Licensed Material, such as patent, trademark, or other intellectual property rights.
Section 3 – License Conditions.
Your exercise of the Licensed Rights is expressly made subject to the following conditions.
Attribution.
If You Share the Licensed Material (including in modified form), You must:
retain the following if it is supplied by the Licensor with the Licensed Material:
identification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);
a copyright notice;
a notice that refers to this Public License;
a notice that refers to the disclaimer of warranties;
a URI or hyperlink to the Licensed Material to the extent reasonably practicable;
indicate if You modified the Licensed Material and retain an indication of any previous modifications; and
indicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.
For the avoidance of doubt, You do not have permission under this Public License to Share Adapted Material.
You may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.
If requested by the Licensor, You must remove any of the information required by Section 3(a)(1) to the extent reasonably practicable.
NonCommercial. You may not exercise the Licensed Rights for commercial purposes.
ShareAlike.
In addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply.
The Adapter's License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-NC-SA Compatible License.
You must include the text of, or the URI or hyperlink to, the Adapter's License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material.
You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter's License You apply.
Section 4 – Sui Generis Database Rights.
Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:
for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database for NonCommercial purposes only;
if You include all or a substantial portion of the database contents in a database to which You applied the Adapter's License, then the database to which You applied the Adapter's License (but not its individual contents) is Adapted Material; and
You must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.
For the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.
Section 5 – Disclaimer of Warranties and Limitation of Liability.
Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available to make no representation or warranty of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.
To the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.
The disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.
Section 6 – Term and Termination.
Term. This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.
Where Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:
automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or
upon express reinstatement by the Licensor.
For the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License. For the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License. Sections 1, 5, 6, 7, and 8 survive termination of this Public License.
Section 7 – Other Terms and Conditions.
The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.
Any arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.
Section 8 – Interpretation.
For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.
To the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.
No term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.
Nothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.
=======================================================================
Creative Commons may be contacted at creativecommons.org.
专题文档撰写提示词
基于课程大纲和分析素材,生成专题详细内容。
撰写要求
1. 忠实原文:保留文献中的核心观点、具体例子、重要表述 2. 叙述性写作:以段落论述为主,避免用要点堆砌替代完整论证 3. 详尽完整:每个概念都有完整的解释和论证,保持逻辑连贯 4. 避免外部扩展:不添加文档外的知识和信息 5. 高保真正文增强:
- 不要把章节写成轻量摘要,应尽量保留原素材中有思想密度的观点、案例、判断、金句、工具选择理由、踩坑经验和实践细节
- 关键案例应交代背景、问题、做法、结果和启发,不要压缩成一句"某案例说明了某道理"
- 工具或方案取舍应说明选择理由、适用条件、局限和放弃其他方案的原因
- 反直觉判断、个人经验、临时展开但有启发价值的观点,应自然融入正文
6. 自然表达:
- 禁止使用"原文中"、"根据原文"、"主讲人强调"、"主讲人指出"、"主讲人提到"、"主讲人认为"、"发言人表示"等表述
- 禁止反复使用"现场演示"、"演示中"、"课程现场"、"现场问答"、"现场提到"、"本次分享中"等来源痕迹表述
- 直接陈述内容本身,不强调内容来源归属
- 将转录内容转换为客观的知识陈述形式
- 去除发言人标记,将内容整合为连贯的叙述
- 将操作型内容改写为"实践案例"、"应用场景"、"操作流程"、"一次典型迭代"等独立正文表达
7. 术语一致:
- 如已提供用户词典,保持大纲和素材中的校正结果
- 统一使用词典中的正确术语写法,不恢复转录稿中的近似误写
- 不新增词典外术语,也不对低置信内容做猜测式替换
- 保留专有英文名称的原始写法、大小写、空格和连字符;
Course Generator、Claude Code、Codex、Cursor、Markdown、Git等不要翻译成中文 - 可以解释专有名称的功能,但不要用中文译名替代英文名称;例如写
Course Generator 用于...,不要写"课程生成器用于..." - 文件名、命令名、API 名、Skill 名和项目名默认使用原文写法
8. 章节边界清晰:
- 严格围绕当前章节信息展开
- 相近主题只在必要时建立连接,不重复其他章节的主体内容
- 对核心章节给出更充分的方法论、框架和案例展开
9. 图片资产保真与正文配图克制:
- 如果课程大纲提供"本章正文配图"或图片资产表,只插入正文处理为
插入正文的图片,不得遗漏这些正文配图 - 使用图片资产表中的
原始Markdown原样插入正文,包括 alt 文本、URL、扩展名和括号,不得改写、翻译、重命名、下载或重新上传 - 同一章节内正文配图必须按
IMG-xxx原始顺序出现,不要根据正文改写随意调换顺序 - 图片应放在最相关的小节或段落之后;如果某张图片难以精确匹配,放在本章最接近的主题段落之后
- 不要把所有正文配图集中堆到文末,除非该章没有更细的主题位置可放
- 同一小节或同一位置连续图片原则上不超过 2 张,确有必要时最多 3 张;超过时保留最能说明问题的代表图,或分散到真正相关的不同段落之后
- 不要为了保持独立正文而删除大纲已标注为
插入正文的图片;这些图片是原始材料中的高价值结构线索 - 如果大纲将图片标注为
仅资产表保留或跳过,本章不插入该图 - 插入图片前后可用一句短句说明它支撑的观点、流程或案例,不要写成"下面是 PPT"或"现场展示了这张图"
- 图片数量减少不等于正文压缩;即使跳过连续操作页,也要保留其中有价值的操作逻辑、工具取舍、失败经验、限制条件和真实疑问
10. 问答自然融入:
- 原文中的 Q&A 是正文素材,必须按主题融入对应段落,不单独生成问答章节
- 将问题转化为读者常见疑问、补充解释、案例回应或实践注意事项,将回答转化为正文论证
- 保留问答中体现真实疑惑、实践阻力、误区和取舍的内容,过滤会务、设备调试等无课程价值的问答
- 不机械保留"Q:"/"A:"格式,除非用户明确要求输出问答手册
- 融入后不要写成"现场有人问"、"现场问答补充",而应写成"实践中常见的疑问是..."或直接纳入对应论证
11. 重点表达:
- 允许使用少量
### 1、关键判断、### 2、实践启发、### 3、方法框架等三级标题突出重点 - 标题必须来自当前章节真实内容,不得为了模板完整硬造
- 重点标题下仍以完整段落论述,不把章节退化成提纲
12. 标题与段落可读性:
- 所有三级标题必须使用
### 1、标题格式,每个二级标题下从1重新编号 - 段落目标长度约 160-240 个中文字符
- 超过 260 字的段落应优先拆分,避免出现 300 字以上长段
- 同一段只讲一个核心意思,不把概念定义、案例说明和价值判断塞进同一段
叙述性写作原则
重要:以叙述性表达为主
- 使用段落形式展开所有内容
- 每个概念都有完整的解释和论证
- 保持逻辑连贯,层层递进
- 避免使用"首先、其次、最后"等机械连接词
- 用自然流畅的叙述方式组织内容
- 在流程、步骤、术语映射、工具对比等场景,可以使用简短列表或箭头链路提升可读性,但不要把整章写成提纲
- 书稿素材取向下,宁可多保留一段有判断、有案例、有取舍的正文,也不要为了简洁删掉关键细节
- 图片是原始材料的结构线索,但正文只承载大纲筛选出的高价值配图;不要因为追求保真而把低价值、重复或会务性质图片塞进章节正文
- 克制插图只针对图片密度,不得把有价值正文同步压缩成摘要
章节模块库
根据内容特点,从以下模块中选择合适的组合:
可选模块
| 模块名称 | 适用场景 | 编号格式 |
|---|---|---|
| 引言与概述 | 需要背景介绍和内容导航 | 一、 |
| 核心概念与原理 | 理论性内容,需要概念阐释 | 二、 |
| 理论框架 | 学术性、理论性较强的内容 | 三、 |
| 历史背景 | 需要时间线或发展历程的内容 | 四、 |
| 实践案例 | 有具体应用实例的内容 | 五、 |
| 应用场景 | 需要场景说明的内容 | 六、 |
| 最佳实践 | 需要操作指南的内容 | 七、 |
| 对比分析 | 需要比较不同方案/观点的内容 | 八、 |
| 未来展望 | 有前瞻性、趋势性内容 | 九、 |
| 本章小结 | 需要总结回顾的内容 | 十、 |
| 延伸阅读 | 有相关资源推荐的内容 | 十一、 |
模块选择原则
1. 根据内容类型选择合适的模块 2. 每章至少包含 2 个模块 3. 模块顺序遵循逻辑关系 4. 避免内容空洞的模块
默认推荐组合
- 理论类:引言与概述 + 核心概念与原理 + 本章小结
- 实践类:引言与概述 + 应用场景 + 最佳实践 + 本章小结
- 案例类:引言与概述 + 实践案例 + 对比分析 + 本章小结
- 综合类:根据内容特点灵活组合
模块详细说明
模块1:引言与概述
## 一、引言与概述
本章将深入探讨[章节主题]的核心概念和实践应用。首先介绍该主题的背景和重要性,帮助读者建立整体认知框架。接着概述本章将要讨论的主要内容,为读者提供清晰的学习路径。模块2:核心概念与原理
## 二、核心概念与原理
[详细阐述核心概念,采用叙述性表达,每个概念都有完整的解释和论证。以段落形式展开说明,避免使用要点列表。整个论述过程要保持逻辑连贯,层层递进。]
### 1、[子主题1]
[以段落形式深入讲解,系统阐述该子概念的各个方面。首先介绍其基本定义和内涵,然后探讨其起源和发展历程,分析其理论基础和核心原理,最后说明其实际意义和应用价值。]
### 2、[子主题2]
[继续以叙述方式展开,与前一子主题形成逻辑递进关系。深入剖析该概念的本质特征,探讨其与相关概念的内在联系。]模块3:理论框架
## 三、理论框架
[阐述本主题的理论基础和框架结构,以段落形式说明核心理论的构成要素、内在逻辑和理论来源。]
### 1、[框架要素1]
[围绕一个框架要素展开,保持段落短而清楚。]模块4:历史背景
## 四、历史背景
[以时间线或发展历程的方式,介绍该主题的历史沿革、发展阶段和重要节点。以叙述方式展开,避免使用要点列表。]
### 1、[阶段或节点1]
[说明该阶段的背景、变化和影响。]模块5:实践案例
## 五、实践案例
通过具体案例来展示理论知识的实际应用,帮助读者将抽象概念转化为具体认知。
### 1、[案例名称]
这个案例生动地展示了[章节主题]在实际工作中的具体应用。案例背景是[背景描述],面临的主要挑战是[挑战描述]。通过采用[具体方法],成功实现了[预期效果]。整个过程中遇到的关键问题包括[问题清单],而解决方案则体现了[章节主题]的核心价值。
### 2、[案例名称]
作为另一个典型应用场景,这个案例从不同角度展示了[章节主题]的灵活性和适用性。通过对比分析两个案例,读者可以更好地理解[章节主题]在不同情境下的应用策略和实施要点。模块6:应用场景
## 六、应用场景
基于前面的理论分析,本节将系统介绍[章节主题]的各类应用场景。
### 1、[场景名称]
在[场景1]中,[章节主题]主要用于[用途描述]。这种场景的特点是[特点描述],需要特别注意[注意事项]。通过合理运用[章节主题],能够有效解决[解决的问题],实现[预期价值]。
### 2、[场景名称]
在[场景2]下,[章节主题]则展现出不同的应用特点。这里的重点在于[重点内容],关键在于[关键要素]。模块7:最佳实践
## 七、最佳实践
基于大量实践经验,我们总结出以下最佳实践:首先,在[实践环节1]中,应当遵循[原则或方法],这是成功应用的基础。其次,在[实践环节2]时,需要重点关注[关注点],这直接影响到最终效果。最后,通过[实践环节3]的持续改进,可以不断提升应用水平。
### 1、[实践要点1]
[将具体实践写成短段,说明适用条件和操作要点。]模块8:对比分析
## 八、对比分析
[对不同的方案、观点或方法进行比较分析,以段落形式阐述各自的优缺点、适用场景和选择标准。]
### 1、[对比维度1]
[围绕一个维度比较不同方案,不混入其他维度。]模块9:未来展望
## 九、未来展望
[探讨该主题的发展趋势、潜在挑战和未来方向。以叙述方式展开,避免使用要点列表。]模块10:本章小结
## 十、本章小结
通过对[章节主题]的系统学习,我们深入了解了其核心概念、实践应用和发展趋势。本章首先介绍了[核心概念1],为理解整个主题奠定了基础;然后通过[核心概念2]的深入分析,揭示了主题的内在规律;最后结合实际案例,展示了理论知识的实践价值。
掌握[章节主题]不仅能够提升当前的[相关工作]能力,更为未来的[发展趋势]做好了准备。建议读者在实践中不断总结和反思,形成自己的理解和应用体系。模块11:延伸阅读
## 十一、延伸阅读
[推荐相关的学习资源、参考资料或扩展阅读材料,以段落形式介绍每个资源的特点和价值。]输入内容
- 课程大纲:[生成的课程大纲]
- 分析素材:[整体分析结果和原文内容]
- 章节信息:[当前章节的标题和核心观点]
- 高价值素材:[大纲中标注的本章需要保留的观点、案例、判断、金句、真实疑问或实践细节]
- 本章正文配图清单:[从图片资产表中筛选出的、正文处理为"插入正文"的本章图片,包含 IMG 编号、原始Markdown、邻近信息、图片价值、处理理由和放置建议;无则写"无"]
- 用户词典:[如果存在,列出 config/user_dictionary.yaml 中的 terms;如果不存在则写"未配置"]
提取模式提示词
任务
根据客户的培训需求,从现有课程素材中提取并重组内容,生成定制化的课程方案文档。
输入
1. 客户需求描述:包含受众画像、培训时长、重点方向等 2. 课程主题体系:来自配置中的 curriculum_file,包含课程体系的完整索引 3. 素材文件:从知识库中定位的源文件内容
路径要求:
curriculum_file和知识库路径优先使用绝对路径- 如果使用相对路径,默认相对于当前工作目录解析
执行步骤
第一步:解析客户需求
从需求描述中提取关键信息:
- 受众:企业法务 / 律师 / 法律研发 / 产品团队 / 混合
- AI 基础水平:零基础 / 有一定经验 / 技术背景
- 培训时长:2-3 小时(一次性讲座)/ 半天 / 1 天 / 多天
- 重点方向:认知普及 / 基础工具 / Agent/Skill / 实战案例 / 组织落地 / 超级个体
- 特殊需求:特定业务场景、特定平台、特定行业
第二步:匹配课程讲次
根据解析的需求,在课程主题体系中匹配最合适的讲次组合:
1. 基于受众和基础水平,确定从哪些阶段中选取 2. 基于培训时长,确定选几讲(每讲约 60-90 分钟) 3. 基于重点方向,优先匹配对应讲次 4. 确保选取的讲次之间逻辑连贯
异常场景处理:
- 如果现有课程体系无法完全覆盖客户需求,明确标注缺口部分,并在方案中说明"以下内容需要额外准备素材"
- 如果客户需求过于模糊,先列出 2-3 个可能的方向供用户选择,再进行匹配
- 如果匹配到的讲次素材不完整,在方案中标注哪些讲次有完整素材、哪些需要补充
输出格式:
推荐讲次:第 X 讲、第 Y 讲、第 Z 讲
对应阶段:阶段 N
预估时长:约 X 小时第三步:定位素材文件
根据匹配到的讲次,在知识库中定位对应的素材源文件:
- 对照
curriculum_file中的"素材来源目录",确定每个讲次的素材来源 - 使用 Glob 工具搜索知识库目录下的相关文件
- 优先读取各素材目录的总览文件了解内容全貌,优先匹配
00 [课程名称] - 总览.md,兼容旧命名00_*.md - 根据需要深入读取具体章节文件
第四步:提取与重组
从定位到的素材文件中提取相关内容,按以下原则重组:
1. 忠实原文:保留素材中的核心观点、案例、数据,不添加素材外的信息 2. 逻辑重组:按培训的时间线和认知逻辑重新组织,而非照搬素材的原始结构 3. 受众适配:根据受众水平调整内容深度,基础受众侧重"是什么"和"怎么用",技术受众侧重"为什么"和"怎么做" 4. 时长控制:根据培训时长裁剪内容量,2-3 小时的讲座选取最精华的要点
第五步:输出课程方案
输出定制化的课程方案文档,格式如下:
# [客户名称] 定制培训方案
> 受众:[受众画像]
> 时长:[预估时长]
> 生成日期:YYYY-MM-DD
## 培训目标
[基于客户需求,2-3 句话说明本次培训要达成的目标]
## 课程结构
### 第一部分:[主题](约 XX 分钟)
**核心内容:**
1. [要点一]
2. [要点二]
3. [要点三]
**详细内容:**
[从素材中提取的详细内容,段落式展开]
### 第二部分:[主题](约 XX 分钟)
[同上结构]
## 素材来源
- [素材文件路径 1]
- [素材文件路径 2]质量标准
1. 针对性:方案内容与客户需求高度匹配,不包含无关内容 2. 完整性:在匹配的讲次范围内,核心要点不遗漏 3. 连贯性:各部分之间逻辑衔接自然,不是简单拼接 4. 实用性:包含具体案例、实操建议,不是空泛理论 5. 忠实性:所有内容都有素材来源支撑,不凭空编造
课程大纲生成提示词
请一次性分析以下所有文献内容,生成系统化的课程大纲。
核心要求
1. 整体把握:理解所有内容的整体脉络和逻辑关系 2. 主题识别:基于所有内容自动识别主要主题(不限于特定领域) 3. 内容优化:
- 识别并保留重要观点、具体例子、重要表述
- 清洗冗余信息(如过度口语化表达、重复语句)
- 去除发言人标记和内容来源归属表述(如"主讲人强调"、"主讲人指出"等)
- 提取 Markdown 图片引用,建立可追溯图片资产表,并筛选真正适合进入正文的图片
- 将口语化内容转换为专业书面语,直接陈述内容而非强调说话者
- 区分轻量摘要和书稿素材型整理:本任务采用书稿素材取向,应少压缩、多保留有思想密度的内容
4. 用户词典校正:
- 如果提供用户词典,将词典中的每一项视为正确术语
- 在转录内容中识别与词典术语高度相近、且上下文明确指向同一概念的误转写
- 将高置信误转写统一改为词典中的正确写法,保留词典中的大小写和空格
- 可校正大小写、空格、标点、音近/形近、英文术语被拆分或被转成中文近音等错误
- 模糊、低置信或上下文无法确认的内容保持原文,不要为了使用词典而强行替换
5. 专有名称保真:
- 对 Skill 名称、工具名、项目名、产品名、命令名、API、文件名、框架名等专有名称,保留原文语言、大小写、空格和连字符
- 原文或用户词典中明确出现英文名称时,不要翻译成中文;例如
Course Generator应保留为Course Generator,不要写作"课程生成器" - 可以在首次出现时用中文解释其功能,但专有名称本身必须保持英文原名
- 只有当原文和用户词典都使用中文官方名称时,才使用中文名称
6. 高价值素材识别:
- 核心观点:能概括课程主张、判断标准、能力模型或行业趋势的内容
- 实践案例:真实项目、工具链、操作流程、业务场景和结果反馈
- 方法论:可迁移的方法框架、步骤、判断问题、工作流和任务拆解方式
- 取舍理由:为什么选择某个工具、模式、路径或不选择另一方案
- 踩坑经验:失败、中断、误识别、配置问题、成本问题、安全事故及其修正方式
- 反直觉判断:与常见认知不同、能体现个人经验或行业洞察的判断
- 可迁移表达:适合后续写书或文章复用的比喻、金句、概念命名和解释方式
- 真实疑惑:问答素材中反映一线使用者困惑、阻力、误区和实践取舍的问题
7. 结构化组织:按主题自动分组,标注各主题的核心观点 8. 图片资产表与正文插图筛选:
- 如果原文包含 Markdown 图片引用,必须建立图片资产表,不得只笼统写"有配图"
- 为每张图片按原文顺序分配稳定编号:
IMG-001、IMG-002、IMG-003... - 原样保留图片 Markdown:包括 alt 文本、URL、括号、扩展名和查询参数,不得改写、重命名、下载或重新上传
- 记录图片附近的时间戳、前后 1-3 段文字或标题,用于判断归属章节和放置位置
- 同一章节内图片必须保持原文出现顺序;跨章节分配也应遵循原文时间线,不能把后面的图片放到前面章节
- 图片资产表负责保真和追溯,正文配图负责帮助阅读;不要把"不丢图片"理解为"所有图片都插入正文"
- 为每张图片标注图片价值:
核心图、辅助图、低价值图、跳过图 - 为每张图片标注正文处理:
插入正文、仅资产表保留、跳过 核心图通常包括方法框架、工具界面、关键流程、案例证据、对比结论、操作结果等能独立增加理解的信息,应优先标注为插入正文辅助图只有在能支撑相邻段落理解、且不会造成图片堆叠时,才标注为插入正文- 会务测试、音频调试、空白页、过渡页、纯标题页、重复页、装饰页或无法贡献课程理解的图片,标注为
仅资产表保留或跳过,并说明原因 - 同一位置连续插入图片原则上不超过 2 张,确有必要时最多 3 张;如果一组图片更多,应选择代表图插入,其余仅在资产表保留或分散到不同小节
- 如果无法判断图片归属,应放入时间位置最接近的章节;如果无法判断是否应进正文,默认标注为
仅资产表保留,不要把低置信图片塞进正文 - 图片筛选只影响图片是否进入正文,不得降低正文素材保留力度;即使某组图片仅资产表保留,也要把其中对应的高价值案例、操作逻辑、判断理由和真实疑问吸收进章节高价值素材
9. 素材类型识别与去来源痕迹:
- 区分主讲内容、操作过程、问答、补充讨论四类素材
- 主讲内容用于构建章节主线
- 操作过程转化为实践案例或应用场景,不机械保留"演示"叙述
- 问答必须按主题融入对应章节,可作为常见疑问、补充解释、案例回应或实践注意事项,不单独成章,也不机械保留问答格式
- 补充讨论用于丰富对应主题,不打断主线结构
- 章节成品应像独立文章或书稿章节,避免输出"现场演示"、"课程现场"、"现场问答"、"主讲人提到"等来源痕迹
- 如果转录稿末尾包含平台自动生成的摘要、重点内容或 Q&A,可作为线索辅助定位价值点,但不得替代对逐字转录内容的判断
10. 章节边界控制:
- 为每章标注清晰的主题边界,说明本章负责回答什么问题
- 相近主题必须明确分工,避免重复展开;例如 Agent 工作台、信息自动化、知识管理应分别聚焦工具环境、信息筛选、资产沉淀
- 标注核心章节,核心章节应承载课程主方法论、主框架或关键能力迁移,后续生成时需要更充分展开
11. 完整提取:保留关键观点、重要细节、具体案例、金句、工具选择理由、专有名称原始写法、图片引用和实践中的限制条件 12. 章节划分指导:
- 通常 3-8 章,取决于素材量和主题复杂度
- 素材少(1-3 个文件)时合并为 3-4 章
- 素材多(10+ 个文件)时拆分为 6-8 章
- 相关性强的子主题应合并,独立完整的大主题可独立成章
案例融合原则
重要:实践案例和展望内容的整合原则
当分析内容包含实践案例、应用场景或未来展望时,应智能地将其融入相应的主题专题中,而不是创建独立的章节。
整合策略: 1. 案例匹配:将案例内容按照主题相关性分配到对应的专题文档中 2. 内容融合:在专题文档的"实践案例分析"部分自然地融入相关案例 3. 展望分配:将未来发展趋势的内容融入相关主题的结尾部分 4. 智能判断:AI 应根据内容的核心主题和应用领域进行合理分配
输出格式
===课程大纲开始===
课程标题:[基于原文生成的课程名称]
内容来源: [文件来源描述]
内容特征: [转录内容/普通文献/混合内容]
图片资产表:
[如果有图片,逐项列出;没有图片则写"无"]
- IMG-001
原始顺序: 1
原始Markdown: 
邻近信息: [时间戳/前后文/标题]
归属章节: [总览/第一章/第二章/.../跳过]
图片价值: [核心图/辅助图/低价值图/跳过图]
正文处理: [插入正文/仅资产表保留/跳过]
处理理由: [为什么插入、仅保留或跳过]
放置建议: [仅当正文处理为插入正文时,说明建议放在哪个主题或段落之后;否则说明不插入正文]
- IMG-002
原始顺序: 2
原始Markdown: 
邻近信息: [时间戳/前后文/标题]
归属章节: [总览/第一章/第二章/.../跳过]
图片价值: [核心图/辅助图/低价值图/跳过图]
正文处理: [插入正文/仅资产表保留/跳过]
处理理由: [为什么插入、仅保留或跳过]
放置建议: [仅当正文处理为插入正文时,说明建议放在哪个主题或段落之后;否则说明不插入正文]
第一章 [主题名称] - 核心观点摘要
边界: [本章负责的问题范围,避免与其他章节重复]
核心程度: [核心章节/普通章节]
融入素材: [主讲内容/操作过程/问答/补充讨论的使用方式;说明如何转化为独立正文]
高价值素材: [本章需要保留的观点、案例、判断、金句、真实疑问或实践细节]
本章正文配图: [仅列出正文处理为"插入正文"的 IMG-xxx,按原文顺序;无则写"无"]
第二章 [主题名称] - 核心观点摘要
边界: [本章负责的问题范围,避免与其他章节重复]
核心程度: [核心章节/普通章节]
融入素材: [主讲内容/操作过程/问答/补充讨论的使用方式;说明如何转化为独立正文]
高价值素材: [本章需要保留的观点、案例、判断、金句、真实疑问或实践细节]
本章正文配图: [仅列出正文处理为"插入正文"的 IMG-xxx,按原文顺序;无则写"无"]
第三章 [主题名称] - 核心观点摘要
边界: [本章负责的问题范围,避免与其他章节重复]
核心程度: [核心章节/普通章节]
融入素材: [主讲内容/操作过程/问答/补充讨论的使用方式;说明如何转化为独立正文]
高价值素材: [本章需要保留的观点、案例、判断、金句、真实疑问或实践细节]
本章正文配图: [仅列出正文处理为"插入正文"的 IMG-xxx,按原文顺序;无则写"无"]
输出计划:
- 总览文档:课程概览和学习路径
- 专题文档:每个主题的详细内容(包含融合的案例、问答、补充讨论、展望、高价值实践细节和本章正文配图)
===课程大纲结束===输入内容
- 用户词典:[如果存在,列出 config/user_dictionary.yaml 中的 terms;如果不存在则写"未配置"]
[以下是所有文件的内容,按文件 ID 排序] 文件ID: [文件名1] 内容: [详细内容]
文件ID: [文件名2] 内容: [详细内容] ...
总览文档生成提示词
基于课程大纲,生成课程总览文档,帮助学习者快速了解课程全貌。
核心要求
1. 段落式写作:以段落形式为主,避免把总览写成提纲堆砌 2. 全面覆盖:涵盖课程概述、学习目标、课程结构、学习路径 3. 段落式展开:每个部分都以段落形式详细阐述 4. 客观陈述:禁止使用"主讲人强调"、"主讲人指出"、"主讲人提到"等表述,直接呈现课程内容本身 5. 避免套话:根据课程实际内容组织语言,不使用固定的过渡词(如"首先...其次...最后..."),确保不同课程的总览各有特色 6. 术语一致:如已提供用户词典,保持课程大纲中的校正结果,统一使用词典中的正确术语写法,不恢复转录稿中的近似误写 7. 专有名称保真:保留 Skill 名称、工具名、项目名、产品名、命令名、API、文件名和框架名的原始语言与大小写;原文或用户词典中是 Course Generator 等英文专有名称时,不翻译成中文 8. 图片资产保真与总览配图克制:如果课程大纲的图片资产表将图片归属为"总览"且正文处理为插入正文,总览必须使用原始 Markdown 图片引用插入,不改 URL、不改 alt、不重排顺序;归属章节、仅资产表保留或跳过的图片不要在总览重复插入 9. 书稿素材取向:总览应指出课程中最有后续写作价值的核心问题、关键方法论或实践经验,但不新增独立素材索引 10. 结构导览可选:
- 不要固定生成"核心工作流地图"
- 只有当课程大纲显示原文确实包含流程链路、方法框架、能力模型、系统架构或主题关系时,才加入简短结构导览
- 导览标题应按内容自动命名,如"核心工作流地图""方法框架""能力模型""主题关系"
- 没有明确结构时直接省略该部分,不要为了模板完整而硬加
- 导览可以使用一行箭头链路或短列表,但必须服务于理解课程结构
输出格式
# [课程标题] - 总览
## 一、课程概述
[基于内容分析的简要概述,以段落形式展开介绍课程背景、核心价值和主要内容简介。说明本课程最值得沉淀的核心问题、实践经验或方法论价值。每段聚焦一个核心意思,避免过长段落。]
[如果图片资产表中有归属为"总览"且正文处理为"插入正文"的图片,在最相关段落后插入原始 Markdown 图片引用;如果没有则省略。总览配图应服务课程整体理解,不要插入会务、音频测试、纯标题、重复或装饰性图片。]
[如果课程确实包含清晰的流程链路、方法框架、能力模型、系统架构或主题关系,可加入一个自动命名的结构导览部分;否则省略本部分。例如:
## 二、[核心工作流地图/方法框架/能力模型/主题关系]
[用一段话或一行箭头链路说明结构,例如:原始素材 -> 转录/OCR -> Markdown -> Skill -> Agent 编排 -> 知识库/交付物。标题和内容必须贴合素材,不固定套用该示例。]
后续二级标题序号根据是否加入结构导览自动顺延:如果没有结构导览,学习目标就是"二";如果有结构导览,学习目标就是"三"。]
## [二或三]、学习目标
[根据课程实际内容,提炼 2-3 个核心学习目标,以段落形式阐述。目标应具体反映本课程的核心内容和预期收获,避免空泛表述。]
## [三或四]、课程结构
本课程共分为X个章节,每个章节聚焦一个核心主题。
[以段落形式逐一介绍各章主题和核心内容,注意:
- 根据各章实际内容描述其侧重点,不使用固定句式
- 突出章节之间的逻辑递进关系
- 说明核心章节及其原因
- 用自己的语言组织,避免模板化表达]
## [四或五]、学习路径建议
[根据课程的实际内容结构和难度梯度,给出具体的学习建议。建议应体现课程内容的特点,而非通用套话。]输入内容
- 课程大纲:[生成的课程大纲]
- 课程标题:[AI 生成的课程名称]
- 总览正文配图清单:[图片资产表中归属为"总览"且正文处理为"插入正文"的图片;无则写"无"]
- 用户词典:[如果存在,列出 config/user_dictionary.yaml 中的 terms;如果不存在则写"未配置"]