Skill Planner

Skill Planner

WHAT

course-bundleの全抽出結果を分析し、生成可能なスキルの計画（skill-plan.json）を作成する。 各スキルの目的・入出力・必要リソース・依存関係を設計し、ユーザー承認後にskill-synthesizerへ渡す。

スコープ外:

• スキルの実際の生成（skill-synthesizerの責務）
• トランスクリプトの抽出（concept-extractor, procedure-extractor, visual-indexerの責務）
• リソースの取得（manabi-ingestの責務）

WHY

抽出フェーズで得られたknowledge, procedures, resourcesは断片的。そのままではスキル化できない。 計画フェーズで以下を決定する:

1. 何をスキルにするか - 手順+リソースの組み合わせから実行可能な単位を特定
2. 何を共有知識にするか - 概念・マインドセットは基盤knowledgeに集約
3. 依存関係は何か - スキル間の前提関係を明示
4. 何が未解決か - リソース未取得など、スキル化の障害を特定

ユーザー承認なしにskill-synthesizerに渡してはならない。 スキル構成はユーザーが決める。

発動条件

• 「スキル計画」「スキル設計」
• 「何のスキルが作れるか」
• 「skill plan」「plan skills」
• /skill-planner

HOW

入力要件

BLOCKER: 前提条件チェック

以下を確認するまでStep 2に進むな:

1. knowledge/knowledge-graph.json が存在すること
2. 少なくとも1つのprocedures.jsonが存在すること

存在しない場合はユーザーに報告し、concept-extractorまたはprocedure-extractorの実行を提案すること。

処理ステップ

Step 1: 前提条件チェック ← BLOCKER
Step 2: 全入力ファイル読み込み
Step 3: スキル候補の特定
Step 4: スキルタイプの判定
Step 5: 共有知識の設計
Step 6: 依存関係グラフの構築
Step 7: 未解決項目の特定
Step 8: skill-plan.json生成
Step 9: 自己検証
Step 10: ユーザーへの提示 ← BLOCKER（承認必須）

Step 2: 全入力ファイル読み込み

以下を全て読み込む（存在するもののみ）:

1. manifest.json → コース名・章リスト
2. knowledge/knowledge-graph.json → 概念依存関係
3. 全chapters/*/knowledge.json → 概念・暗黙知
4. 全chapters/*/procedures.json → 手順
5. resources-manifest.json → 取得済みリソース
6. manuals/ ディレクトリのファイル一覧 → マニュアル参照用

Step 3: スキル候補の特定

procedures.jsonの各手順について:

1. 独立した目的（入力→出力）を持つか確認
2. 対応するリソース（プロンプト、テンプレート等）があるか確認
3. 候補としてリストアップ

Step 4: スキルタイプの判定

Step 5: 共有知識の設計

以下を shared_knowledge に集約:

• 基盤概念（複数スキルの前提となる概念）
• NG/OKパターン（講座全体の判断基準）
• チェックリスト項目（品質確認の共通基準）
• マインドセット・価値観（暗黙知から抽出）

Step 6: 依存関係グラフの構築

1. knowledge-graph.jsonのprerequisite_graphを参照
2. 各スキルが参照する概念の前提を追跡
3. depends_onとして記録
4. 循環依存がないことを確認

Step 7: 未解決項目の特定

以下をunresolvedに記録:

• リソースが言及されているが未取得
• URLが記載されているがアクセスできない
• 外部ツールが必要だが未確認

Step 8: skill-plan.json生成

スキーマは schemas/skill-plan.schema.json に準拠。 出力先: {course-bundle}/skill-plan.json

Step 9: 自己検証

以下をすべてチェックし、問題があれば修正:

• 各executable skillにresourcesまたはproceduresがあるか
• skill_nameが全体で一意か
• depends_onが実在するスキル名を参照しているか
• trigger_wordsが講座固有の具体的なワードか（「作成」「生成」のような汎用語はNG）
• shared_knowledgeに基盤概念が含まれているか
• unresolved欄に未取得リソースが全て記載されているか
• dependency_graphに循環依存がないか
• 1スキルが3章以上の内容を含んでいないか（巨大スキル禁止）

スキル分割ルール

分割の詳細な判断基準は references/planning-strategy.md を参照。

候補の回収方針（網羅記録・厳選推奨）

候補の記録に上限はない（1個でも100個でもよい）。教材から作れる可能性のあるスキルは、 実現可能性が低いものも含めて全てskill-plan.jsonに記録する。候補はスキル資産の在庫であり、 ダッシュボード（manabi-hub）の「スキル」メニューで後からいつでも閲覧・採用できる。

ただし提示と生成は絞る。2層で扱うこと:

statusフィールド（必須）

skill-plan.jsonの各スキルに status を必ず付ける:

あわせて feasibility: ready（今すぐ生成可）/ needs_resource（配布物等が必要）/ idea（概念のみ・要設計）のいずれかを付ける。

NG / OK テーブル

BLOCKER: ユーザー承認

skill-plan.jsonを生成したら、必ず以下のフォーマットでユーザーに提示し、承認を得ること。 承認を得るまでskill-synthesizerに渡してはならない。

ユーザーへの提示

処理完了後、以下のフォーマットで提示:

## Skill Plan: {course_name}

### ヒアリング仮説との照合
manifest.jsonのuser_context.skill_hypothesesがある場合、仮説との照合結果を表示:

| 仮説 | 結果 | 対応スキル |
|------|------|-----------|
| {hypothesis} | ✅ 検出 / ⚠️ リソース未取得 / ❌ 該当なし | {skill_name or "—"} |

➕ 追加発見: {仮説になかったが作れるスキル}

### Executable Skills ({n}件)

| # | スキル名 | 目的 | リソース | 状態 |
|---|---------|------|---------|------|
| 1 | {skill_name} | {purpose} | {resource_names} | Ready / Unresolved |
| ... |

### Shared Knowledge
- 基盤概念: {n}件
- NG/OKパターン: {n}件
- チェックリスト: {n}件
- 参照マニュアル: {manual_refs}

### 依存関係

{dependency_graph as text}

### 未解決項目 ({n}件)
| リソース名 | 言及箇所 | 必要なアクション |
|-----------|---------|----------------|
| {name} | {mentioned_in} | {action_needed} |

---

このプランでスキルを生成しますか？（全部 / 選択 / 修正）

ユーザーの回答への対応