技能:基于视频创建课程
面向最终用户的灵活指南
版本: 2.0.0 最后更新: 2025-11-24 目标受众: 客户/内容创作者 方法: 交互式诊断 + 自适应结构
目录
技能理念
基本原则
┌─────────────────────────────────────────────────────────────────────┐
│ 结构 = 函数(内容) │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ❌ 错误:"每门课程都有4个章节和16个模块" │
│ │
│ ✅ 正确:"结构源自内容诊断" │
│ │
│ • 30分钟视频 → 可以是一个单独的模块 │
│ • 50个视频的播放列表 → 可以分成5个章节,每个章节10个模块 │
│ • 100小时的课程 → 可能需要额外的层次结构 │
│ │
└─────────────────────────────────────────────────────────────────────┘
不固定的内容:
4个章节→ 章节数由内容决定16个模块→ 模块数由分析决定32小时→ 实际的素材时长强制抽认卡→ 根据需要可选
一致的内容:
- 交互式诊断流程
- React/Tailwind 代码模式
- UX命名规范(章节、课程、模块)
- 与现有系统集成
诊断流程
步骤0:信息收集(必需)
在执行任何操作之前,Claude 必须收集:
┌─────────────────────────────────────────────────────────────────────┐
│ 初步诊断 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 1. 输入类型 │
│ □ 单个视频(URL) │
│ □ YouTube播放列表(URL) │
│ □ 多个独立视频(URL列表) │
│ □ 现有系列/课程(描述) │
│ │
│ 2. 内容特征 │
│ • 估计总时长:___ │
│ • 视频数量:___ │
│ • 主要主题/领域:___ │
│ • 目标受众:___ │
│ • 语言:___ │
│ │
│ 3. 课程目标 │
│ □ 快速入门/概述 │
│ □ 完整的结构化课程 │
│ □ 参考资料/查询材料 │
│ □ 企业培训 │
│ │
│ 4. 期望的资源 │
│ □ 按章节导航 │
│ □ 进度复选框 │
│ □ 抽认卡 │
│ □ 实践练习 │
│ □ 笔记簿 │
│ │
└─────────────────────────────────────────────────────────────────────┘
诊断问题(Claude 应询问)
## 诊断:课程创建
在开始之前,我需要更好地了解您的内容:
1. **输入是什么?**
- 单个视频的URL?
- 播放列表的URL?
- 多个单独视频的列表?
2. **总内容的大概时长是多少?**
- 少于1小时
- 1-5小时
- 5-20小时
- 超过20小时
3. **您如何设想的课程结构?**
- 一个模块(简短内容)
- 几个模块(2-5)
- 包含章节的完整结构
- 还不知道,我需要建议
4. **哪些资源很重要?**
- 带复选框的进度跟踪
- 用于复习的抽认卡
- 仅简单导航
支持的输入类型
格式矩阵
| 输入类型 | 典型时长 | 建议结构 | 复杂度 |
|---|---|---|---|
| 单个短视频 | < 1h | 1个模块,章节可选 | 低 |
| 单个长视频 | 1-5h | 3-8个模块,1-2个章节 | 中 |
| 单个超长视频 | 5-20h | 多个章节和模块 | 高 |
| 小型播放列表 | 5-10个视频 | 每个主题1个章节 | 中 |
| 大型播放列表 | 10-50个视频 | 多个分组章节 | 高 |
| 超大型播放列表 | 50+个视频 | 多层次结构 | 非常高 |
| 独立视频 | 可变 | 逐案分析 | 可变 |
| 网络研讨会/直播 | 1-3h | 1个模块带时间戳 | 低 |
自动决策 vs. 交互决策
自动(Claude决定):
├── 代码模式(React/Tailwind)
├── 文件结构
├── 组件命名
└── 技术集成
交互(用户验证):
├── 章节数量
├── 模块分组
├── 名称/标题
├── 可选资源(抽认卡等)
└── 详细程度
交互流程
沟通循环
┌─────────────────────────────────────────────────────────────────────┐
│ 对齐循环 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 用户 Claude │
│ │ │ │
│ │──── "我想创建课程" ────────────▶│ │
│ │ │ │
│ │◀─── 诊断问题 ─────────────────│ │
│ │ │ │
│ │──── 回答 ──────────────────────▶│ │
│ │ │ │
│ │◀─── 结构建议 ─────────────────│ │
│ │ "根据您的输入, │ │
│ │ 我建议 X 个章节, │ │
│ │ Y 个模块。同意吗?" │ │
│ │ │ │
│ │──── 调整/批准 ─────────────────▶│ │
│ │ │ │
│ │◀─── 执行 ─────────────────────│ │
│ │ │ │
└─────────────────────────────────────────────────────────────────────┘
结构建议模板
## 结构建议
基于对您内容的分析,我建议:
### 总体概览
- **总时长:** [X小时]
- **格式:** [描述]
### 建议结构
**选项A:[描述性名称]**
- [N] 个章节
- [M] 个模块总计
- 资源:[列表]
**选项B:[描述性名称]**
- [N'] 个章节
- [M'] 个模块总计
- 资源:[列表]
### 完善问题
1. 您更喜欢哪个选项?
2. 分组方面需要调整吗?
3. 您想添加/删除哪些资源?
我等待您的验证后再继续。
执行步骤
步骤1:提取转录
根据输入自适应:
# 单个视频
python youtube_transcript.py "URL_VIDEO"
# 播放列表(先提取列表)
# Claude分析播放列表并提出分组
# 多个视频
python youtube_transcript.py --batch lista_videos.txt
步骤2:分析与建议
Claude 分析并提出(尚未执行):
我分析了转录并确定了:
- [X] 个主要主题
- [Y] 个子主题
- 时长:[Z] 小时
组织建议:
[建议的结构]
我可以用这个结构继续吗?
步骤3:创建数据(批准后)
自适应结构:
// 示例:短课程(1个视频,2小时)
export const fases[Nome] = [
{ id: 1, nome: "完整内容", ... }
];
export const modulos[Nome] = [
{ id: '1.1', nome: '介绍', ... },
{ id: '1.2', nome: '概念', ... },
{ id: '1.3', nome: '实践', ... }
];
// 示例:长课程(50个视频的播放列表)
export const fases[Nome] = [
{ id: 1, nome: "基础", ... },
{ id: 2, nome: "中级", ... },
{ id: 3, nome: "高级", ... },
{ id: 4, nome: "专业", ... },
{ id: 5, nome: "项目", ... }
];
export const modulos[Nome] = [
// 50个模块分布在5个章节中
];
步骤4:内容转换
根据需要调整详细程度:
| 场景 | 详细程度 | 组件 |
|---|---|---|
| 短课程 | 最低 | 仅LearningSystem |
| 中等课程 | 标准 | LearningSystem + 基本NotesView |
| 长课程 | 完整 | LearningSystem + 详细NotesView + 抽认卡 |
步骤5:集成
始终需要:
- 更新
studyAreas.js - 更新
SistemaEducacionalCompleto.jsx
根据范围可选:
- 为每个模块创建NotesView
- 创建抽认卡
- 创建练习
转换模式
基本转换(任何课程)
| 元素 | JSX |
|---|---|
| 标题 | <h2 className="text-2xl font-bold"> |
| 段落 | <p className="text-gray-700"> |
| 列表 | <ul className="list-disc"> |
中级转换(中等以上课程)
| 元素 | JSX |
|---|---|
| 代码 | <CodeBlock code={...}> |
| 警告 | <div className="bg-yellow-50 border"> |
| 高亮 | <div className="bg-[color]-100 p-4 rounded"> |
高级转换(长课程)
| 元素 | JSX |
|---|---|
| 时间线 | 带有日期/事件的网格 |
| 比较 | 2列网格 |
| 图表 | 自定义可视化组件 |
| 交互式 | React状态 + 处理函数 |
场景示例
场景1:短视频(45分钟)
输入:"我有一个关于Git基础的45分钟视频"
诊断:
- 类型:单个短视频
- 时长:< 1小时
- 目标:介绍
建议:
- 1个单个章节
- 3-4个模块(介绍、命令、分支、实践)
- 无抽认卡(可选)
- 简单进度
结果:
├── gitLearningData.js(1个阶段,4个模块)
└── GitLearningSystem.jsx(简单组件)
场景2:中等播放列表(20个视频,15小时)
输入:"包含20个视频的Docker播放列表"
诊断:
- 类型:中等播放列表
- 时长:~15小时
- 目标:完整课程
建议:
- 4个章节(基础、镜像、Compose、生产)
- 20个模块(每个视频1个)
- 每章节的抽认卡
- 详细进度
结果:
├── dockerLearningData.js(4个阶段,20个模块)
├── DockerLearningSystem.jsx
├── DockerNotesView.jsx(4个文件,每章节1个)
└── 集成抽认卡
场景3:超大型播放列表(100+个视频)
输入:"Python完整课程,150个视频"
诊断:
- 类型:超大型播放列表
- 时长:80小时+
- 目标:完整培训
交互式建议:
"这是一门长课程。我建议划分为多个路径:
路径1:Python基础(30个视频)
路径2:Python中级(40个视频)
路径3:Python高级(40个视频)
路径4:项目(40个视频)
每个路径将成为系统中的独立'课程'。
您同意这种方法吗?"
结果(批准后):
├── pythonBasicoLearningData.js
├── pythonIntermedLearningData.js
├── pythonAvancadoLearningData.js
├── pythonProjetosLearningData.js
└── 对应组件
故障排除
问题:我不知道要创建多少个章节
解决方案: Claude 根据以下因素分析并提出建议:
- 转录中的主题变化
- 块的相对时长
- 内容的复杂度
问题:播放列表中的视频高度异质
解决方案: Claude 建议分组并请求验证:
"我在播放列表中确定了3个不同的主题:
- 视频1-8:基础
- 视频9-15:应用
- 视频16-20:高级
我可以这样分组,还是您更倾向于其他组织方式?"
问题:内容太短,不适合完整结构
解决方案: Claude 建议最小结构:
"仅有30分钟的内容,我建议:
- 1个单一模块,内部包含3-4个章节
- 无需单独的NotesView
- 简单进度(已完成/未完成)
您更喜欢这种简化方法吗?"
问题:转录不可用
解决方案: Claude 提供替代方案:
"该视频没有自动转录。选项:
1. 手动转录(您提供文本)
2. 使用外部转录服务
3. 基于标题/描述创建结构
4. 观看并记录主要主题
您更喜欢哪种?"
参考
数据文件
...