スキル:動画からコースを作成する
エンドユーザー向け柔軟ガイド
バージョン: 2.0.0 最終更新日: 2025-11-24 対象者: 顧客/コンテンツ作成者 アプローチ: 対話型診断 + 適応的構造
目次
スキルの哲学
基本原則
┌─────────────────────────────────────────────────────────────────────┐
│ 構造 = f(コンテンツ) │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ❌ 誤り:「すべてのコースは4セクション、16モジュール」 │
│ │
│ ✅ 正解:「構造はコンテンツの診断から生まれる」 │
│ │
│ • 30分の動画 → 1モジュールで十分 │
│ • 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. **重要なリソースはどれですか?**
- チェックボックスによる進捗管理
- 復習用のフラッシュカード
- シンプルなナビゲーションのみ
サポートされる入力タイプ
フォーマットマトリックス
| 入力タイプ | 標準的な時間 | 推奨される構造 | 複雑さ |
|---|---|---|---|
| 短い単一動画 | < 1時間 | 1モジュール、セクションは任意 | 低 |
| 長い単一動画 | 1〜5時間 | 3〜8モジュール、1〜2セクション | 中 |
| 非常に長い動画 | 5〜20時間 | 複数セクションとモジュール | 高 |
| 小規模プレイリスト | 5〜10動画 | テーマごとに1セクション | 中 |
| 大規模プレイリスト | 10〜50動画 | 複数セクションにグループ化 | 高 |
| 超大規模プレイリスト | 50+動画 | 複数レベルの階層構造 | 非常に高 |
| 個別動画 | 変動 | ケースバイケース | 変動 |
| ウェビナー/ライブ配信 | 1〜3時間 | タイムスタンプ付き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] = [
// 5セクションに編成された50モジュール
];
ステップ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分)
INPUT:「Gitの基礎について45分の動画があります」
診断:
- タイプ:短い単一動画
- 時間:< 1時間
- 目的:イントロダクション
提案:
- 1つの単一セクション
- 3〜4モジュール(イントロ、コマンド、ブランチ、実践)
- フラッシュカードなし(任意)
- シンプルな進捗管理
結果:
├── gitLearningData.js (1フェーズ、4モジュール)
└── GitLearningSystem.jsx (シンプルなコンポーネント)
シナリオ2:中規模プレイリスト(20動画、15時間)
INPUT:「Dockerのプレイリストが20動画あります」
診断:
- タイプ:中規模プレイリスト
- 時間:約15時間
- 目的:完全なコース
提案:
- 4セクション(基礎、イメージ、Compose、本番)
- 20モジュール(動画ごとに1つ)
- セクションごとにフラッシュカード
- 詳細な進捗管理
結果:
├── dockerLearningData.js (4フェーズ、20モジュール)
├── DockerLearningSystem.jsx
├── DockerNotesView.jsx (4ファイル、セクションごとに1つ)
├── 統合されたフラッシュカード
シナリオ3:メガプレイリスト(100+動画)
INPUT:「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. 視聴して主要トピックをメモ
どれをご希望ですか?」
参考資料
参照ファイル
studyAreas.js- すべての学習領域の登録SistemaEducacionalCompleto.jsx- 統合レンダリングシステム- 各コンポーネントの標準パターン
フラッシュカード作成(オプション)
フラッシュカードが必要な場合:
// 標準形式
export const flashcards[Nome] = [
{ id: 1, pergunta: "...", resposta: "..." },
// 質問・回答のペア
];
コーディング標準
- すべてのUIにTailwind CSSを使用
- データファイルは
NomeLearningData.jsの命名規則 - コンポーネントファイルは
NomeLearningSystem.jsxの命名規則 - NotesViewは
NomeNotesView.jsx - テキストは必ずポルトガル語
- [既存システムのリンク]
バージョン履歴
| バージョン | 日付 | 変更点 |
|---|---|---|
| 2.0.0 | 2025-11-24 | 診断プロセスの全面見直し、適応的構造の導入 |
| 1.0.0 | 初期 | 固定構造の最初のバージョン |