AI一键生成海量课程讲解文案的实用技巧

首页

AI一键生成海量课程讲解文案的实用技巧

热心网友

转载

2026-05-19

你是否想过将复杂的知识主题拆解为系列课程，再通过三人脱口秀的形式生动呈现？如今，这一创意已固化为一个名为“三人行技能”的实用工具。

简而言之，它是一个“任意主题 → 三人脱口秀课程文档”的批量生成器。用户只需提供课程主题、分节大纲及三位主播的人设，该工具便能自动生成一批格式规范、内容详实的Word文档，每节课的平均字数可轻松超过2800字。

经过全面测试，该技能已能稳定运行。无论是基础的3课测试，还是使用JSON配置文件调用的10课Python课程示例，均成功达标，生成质量可靠。

三人行技能 · 完整使用指南

一、技能核心价值

“三人行技能”的核心优势在于其自动化能力。用户只需定义课程名称、总节数以及三位主播角色，它便能自动生成一批格式统一、内容充实的 .docx 课程文件，极大地节省了手动编写与格式调整的时间。

那么，生成的一节课具体包含哪些内容呢？其结构清晰明了：

开场白：三位主播互相介绍并引出本课话题，约250字，起到快速破冰的作用。
第一段：核心概念解析：由专家角色深入讲解核心概念，期间新手角色会适时提问，确保基础听众也能理解，约700字。
第二段：原理深度剖析：进一步探讨技术或理论的运作原理与背景知识，约700字。
第三段：实战经验分享：分享实际应用中的经验、常见问题与实用建议，促进知识落地，约700字。
结尾总结：三人共同回顾要点，进行总结，约300字。

这种结构设计确保了内容既有专业深度，又能兼顾不同认知水平学习者的需求。

二、文件位置与验证结果

所有相关文件均存放于以下目录，结构清晰：

C:\Users\Administrator\.workbuddy\skills\三人行技能\
├── SKILL.md          # 技能核心说明书
├── scripts/
│   └── sanrenxing.py # 核心生成器脚本
└── examples/
    ├── python_course.json   # Python课程示例配置
    ├── health_course.json   # 健康饮食课程示例配置
    └── config_template.json # 通用配置模板

在开发与测试阶段，其表现稳定可靠：

测试项目	课程节数	达标情况	平均字数
基础功能测试	3课	✅ 3/3	2859字
Python课程 JSON配置	10课	✅ 10/10	2959字

这意味着，当您需要生成一个新主题的系列课程时，整个过程将非常简便高效。

三、两种使用方式

方式一：通过AI智能体直接指令（推荐，最简便）

如果您在使用WorkBuddy等智能体环境，最便捷的方式是使用自然语言直接下达指令。例如：

「使用三人行技能为我生成一套《区块链入门》课程，共8节课，输出到 D:\区块链课程目录」

AI将自动理解您的意图，协助生成配置文件、调用脚本、执行生成任务，并最终汇报结果。

方式二：手动配置JSON文件

如果您倾向于手动控制，或需要在非AI环境下运行，请按以下步骤操作：

第一步：复制配置模板

copy "C:\Users\Administrator\.workbuddy\skills\三人行技能\examples\config_template.json" "D:\我的课程.json"

第二步：使用文本编辑器填写配置

JSON配置文件结构直观，每个字段均有明确用途：

{
  "course_name": "区块链从入门到精通", // 课程系列名称
  "output_dir": "D:\\区块链课程",      // 输出目录（注意Windows路径需使用双反斜杠）
  "char_target": 2400,                // 每节课目标字数（可选参数，默认2400）
  "speakers": [                       // 定义三位主播的人设
    {
      "name": "陈教授",
      "desc": "区块链技术专家，男，曾参与多个主链项目开发，风趣幽默。",
      "color": [0, 100, 200],         // RGB颜色值，深蓝色适合专家角色
      "role": "expert"                // 固定角色，请勿修改
    },
    {
      "name": "小雨",
      "desc": "金融从业者，女，听说区块链能赚钱但完全不懂技术，代表普通人视角。",
      "color": [180, 50, 0],          // RGB颜色值，深红色适合提问者角色
      "role": "novice"                // 固定角色，请勿修改
    },
    {
      "name": "王博士",
      "desc": "科技教育专家，男，擅长将复杂技术类比成生活现象，语言平易近人。",
      "color": [0, 130, 60],          // RGB颜色值，深绿色适合教育者角色
      "role": "educator"              // 固定角色，请勿修改
    }
  ],
  "lessons": [                        // 定义具体的课程列表
    {
      "num": 1,
      "title": "区块链是什么：从比特币说起",
      "category": "基础概念"
    },
    {
      "num": 2,
      "title": "去中心化：没有中心机构的系统如何运转",
      "category": "核心原理"
    }
    // ... 可在此继续添加更多课程
  ]
}

第三步：运行生成脚本

python "C:\Users\Administrator\.workbuddy\skills\三人行技能\scripts\sanrenxing.py" --config "D:\我的课程.json"

四、配置字段速查表

字段	是否必填	说明	示例
`course_name`	✅	课程系列名称	`"Python从小白到大牛"`
`output_dir`	✅	输出目录（注意使用双反斜杠）	`"D:\\Python课程"`
`char_target`	可选	每节课目标字数，默认2400	`2400`
`speakers[].name`	✅	主播名字	`"张教授"`
`speakers[].desc`	✅	主播人设描述	`"技术专家，男……"`
`speakers[].color`	✅	RGB颜色值 [R,G,B]	`[0, 100, 200]`
`speakers[].role`	✅	固定角色：`"expert"` / `"novice"` / `"educator"`	`"expert"`
`lessons[].num`	✅	课程编号（整数）	`1`
`lessons[].title`	✅	课程标题	`"什么是Python"`
`lessons[].category`	可选	所属类别（影响对话方向）	`"基础概念"`

五、三种固定角色的定位与职责

三位主播的角色（role）是固定的，他们各司其职，共同构建一场层次丰富的对话：

角色 (role)	对话职责	适合的人设类型
`expert`	主讲人。负责深度解析原理，运用比喻，提供专业见解与建议。	行业专家、资深从业者、技术权威
`novice`	提问者。代表初学者或普通用户视角，提出常见疑问，确保内容通俗易懂。	小白用户、行业新人、跨领域学习者
`educator`	引导者。负责补充背景知识，总结规律，串联对话，承上启下。	教师、科普作者、行业分析师

⚠️ 请注意：role 字段的值是固定的，只能是上述三个。但您可以自由修改 name（名字）和 desc（描述）来定制个性化的人设。

六、主播发言颜色搭配推荐

为了让生成的文档在阅读时能清晰区分三位主播的发言，建议为他们分配对比鲜明的文字颜色。以下是一些经过验证的配色方案：

专家（深蓝）：[0, 100, 200]
提问者（深红）：[180, 50, 0]
教育者（深绿）：[0, 130, 60]
技术要点（深紫）：[100, 50, 150]

当然，您也可以使用任何RGB值。核心原则是：三人的颜色要有明显区分度，方便读者快速识别发言者。

七、脚本运行输出样例

运行生成脚本后，您将在命令行界面看到清晰的进度提示与结果报告，类似如下格式：

============================================================
三人行技能 · 开始生成
课程名称：区块链从入门到精通
输出目录：D:\区块链课程
总课程数：8课 | 字数目标：≥2400字
============================================================
[批次 1] 第1课 ~ 第8课
✅ 第1课《区块链是什么》→ 2847字 → 第1课_区块链是什么.docx
✅ 第2课《去中心化》     → 2831字 → 第2课_去中心化.docx
...
============================================================
生成报告
达标课程：8/8 课
平均字数：2839 字
输出目录：D:\区块链课程
============================================================

八、现成示例课程（可直接运行体验）

如果您不想从头开始配置，可以直接运行附带的示例文件，快速体验生成效果：

Python入门课程（10节）

python "C:\Users\Administrator\.workbuddy\skills\三人行技能\scripts\sanrenxing.py" --config "C:\Users\Administrator\.workbuddy\skills\三人行技能\examples\python_course.json"

健康饮食科普课程（8节）

python "C:\Users\Administrator\.workbuddy\skills\三人行技能\scripts\sanrenxing.py" --config "C:\Users\Administrator\.workbuddy\skills\三人行技能\examples\health_course.json"

九、常见问题与解决方法

问题现象	可能原因	解决方法
`ModuleNotFoundError: docx`	缺少必要的Python依赖库	运行 `pip install python-docx` 命令安装
输出目录不存在	正常情况	脚本会自动创建指定目录，无需手动处理
文件名包含特殊字符	正常处理	脚本会自动将文件名中的非法字符替换为下划线 `_`
某节课生成字数不足2400	课程标题或类别定义过于宽泛	检查并细化 `title` 和 `category` 字段，报告会标记⚠️提示
`role` 配置错误	填写了非法的角色值	角色值只能是 `expert`、`novice`、`educator` 三者之一