技能:從影片建立課程
提供給終端使用者的靈活指南
版本: 2.0.0 最後更新: 2025-11-24 目標對象: 客戶/內容創作者 方法: 互動式診斷 + 適應性結構
目錄
技能哲學
基本原則
┌─────────────────────────────────────────────────────────────────────┐
│ 結構 = f(內容) │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ❌ 錯誤:「每個課程都有 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 部影片 | 每個主題一個章節 | 中 |
| 大型播放清單 | 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-[cor]-100 p-4 rounded"> |
進階轉換(長課程)
| 元素 | JSX |
|---|---|
| 時間軸 | 包含日期/事件的網格 |
| 比較 | 2 欄網格 |
| 圖表 | 自訂視覺元件 |
| 互動 | React 狀態 + 處理函式 |
情境範例
情境 1:短影片(45 分鐘)
輸入:「我有一個 45 分鐘關於 Git 基礎的影片」
診斷:
- 類型:單一短影片
- 時長:< 1h
- 目標:入門介紹
提案:
- 1 個章節
- 3-4 個單元(簡介、指令、分支、實作)
- 無閃卡(可選)
- 簡單進度
結果:
├── gitLearningData.js(1 個階段,4 個單元)
└── GitLearningSystem.jsx(簡單元件)
情境 2:中型播放清單(20 部影片,15 小時)
輸入:「有 20 部影片的 Docker 播放清單」
診斷:
- 類型:中型播放清單
- 時長:~15h
- 目標:完整課程
提案:
- 4 個章節(基礎、映像檔、Compose、生產環境)
- 20 個單元(每部影片一個)
- 每個章節有閃卡
- 詳細進度
結果:
├── dockerLearningData.js(4 個階段,20 個單元)
├── DockerLearningSystem.jsx
├── DockerNotesView.jsx(4 個檔案,每個章節一個)
└── 整合的閃卡
情境 3:特大播放清單(100+ 部影片)
輸入:「完整的 Python 課程,150 部影片」
診斷:
- 類型:極大型播放清單
- 時長:80h+
- 目標:完整培訓
互動式提案:
「這是一個長課程。我建議將其分成多個學習路徑:
學習路徑 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. 觀看影片並記下主要主題
您偏好哪個選項?」