shiden 0.1.0

package/templates/.github/skills/theory-lookup.md

@@ -0,0 +1,283 @@
+# 理論検索スキル（TENJIN連携）
+
+> TENJIN GraphRAG MCP Serverと連携し、教育理論のエビデンスを取得・引用します。
+
+## 概要
+
+このスキルは、他のスキルから呼び出され、TENJIN GraphRAGを通じて175+の教育理論を検索・取得・引用します。生成されるコンテンツにエビデンスベースの裏付けを提供します。
+
+## TENJIN MCP Server 連携
+
+### 接続設定
+
+TENJINはMCP（Model Context Protocol）サーバーとして動作します。
+VS Codeの設定でMCPサーバーとして登録されている必要があります。
+
+### 利用可能なツール
+
+#### 検索ツール（Search Tools）
+
+```
+search_theories(query, category?, limit?)
+```
+- **用途**: キーワードで教育理論を検索
+- **パラメータ**:
+  - `query`: 検索キーワード（必須）
+  - `category`: カテゴリフィルタ（任意）
+  - `limit`: 結果数上限（任意、デフォルト: 5）
+- **戻り値**: 理論リスト（ID、名前、概要、関連度スコア）
+
+```
+get_theory(theory_id)
+```
+- **用途**: 特定の理論の詳細を取得
+- **パラメータ**:
+  - `theory_id`: 理論ID（必須）
+- **戻り値**: 理論の完全な情報（定義、理論家、原則、応用例、出典）
+
+```
+get_theories_by_category(category)
+```
+- **用途**: カテゴリ別の理論一覧を取得
+- **パラメータ**:
+  - `category`: カテゴリ名（必須）
+- **戻り値**: 該当カテゴリの理論リスト
+
+#### 推薦ツール（Recommendation Tools）
+
+```
+recommend_theories(context, learner_profile?)
+```
+- **用途**: コンテキストに基づいて適切な理論を推薦
+- **パラメータ**:
+  - `context`: 教育コンテキスト（必須）
+  - `learner_profile`: 学習者情報（任意）
+- **戻り値**: 推薦理論リスト（推薦理由付き）
+
+```
+recommend_theories_for_learner(learner_type, learning_goal)
+```
+- **用途**: 学習者タイプに適した理論を推薦
+- **パラメータ**:
+  - `learner_type`: 学習者タイプ
+  - `learning_goal`: 学習目標
+- **戻り値**: 推薦理論リスト
+
+```
+recommend_complementary_theories(theory_id)
+```
+- **用途**: 指定理論と組み合わせると効果的な理論を推薦
+- **パラメータ**:
+  - `theory_id`: 基準となる理論ID
+- **戻り値**: 補完的な理論リスト
+
+#### 分析ツール（Analysis Tools）
+
+```
+compare_theories(theory_ids[])
+```
+- **用途**: 複数の理論を比較分析
+- **パラメータ**:
+  - `theory_ids`: 比較する理論IDの配列
+- **戻り値**: 比較表（類似点、相違点、使い分けガイド）
+
+```
+analyze_theory(theory_id, analysis_type)
+```
+- **用途**: 理論の深層分析
+- **パラメータ**:
+  - `theory_id`: 理論ID
+  - `analysis_type`: 分析タイプ（strengths, limitations, applications等）
+- **戻り値**: 分析結果
+
+```
+get_theory_applications(theory_id, context)
+```
+- **用途**: 特定コンテキストでの理論の応用例を取得
+- **パラメータ**:
+  - `theory_id`: 理論ID
+  - `context`: 適用コンテキスト
+- **戻り値**: 具体的な応用例
+
+#### グラフ走査ツール（Graph Traversal Tools）
+
+```
+get_related_theories(theory_id, relation_type?)
+```
+- **用途**: 関連理論を取得
+- **パラメータ**:
+  - `theory_id`: 理論ID
+  - `relation_type`: 関係タイプ（influenced_by, influenced, similar_to等）
+- **戻り値**: 関連理論リスト
+
+```
+find_theory_path(from_id, to_id)
+```
+- **用途**: 2つの理論間の関係パスを探索
+- **パラメータ**:
+  - `from_id`: 起点理論ID
+  - `to_id`: 終点理論ID
+- **戻り値**: 理論間のパス（経由する理論と関係）
+
+```
+get_influence_chain(theory_id)
+```
+- **用途**: 理論の影響関係チェーンを取得
+- **パラメータ**:
+  - `theory_id`: 理論ID
+- **戻り値**: 影響を与えた/受けた理論のチェーン
+
+## カテゴリ一覧
+
+TENJINで利用可能な主なカテゴリ：
+
+| カテゴリ | 説明 | 代表的な理論 |
+|---------|------|-------------|
+| `instructional_design` | 授業設計・教授法 | Gagné's Nine Events, ADDIE |
+| `learning_theory` | 学習理論 | Constructivism, Behaviorism |
+| `cognitive` | 認知心理学 | Cognitive Load Theory, Schema Theory |
+| `motivation` | 動機づけ | ARCS Model, Self-Determination Theory |
+| `assessment` | 評価理論 | Formative Assessment, Constructive Alignment |
+| `development` | 発達心理学 | Piaget, Vygotsky, Erikson |
+| `special_needs` | 特別支援教育 | UDL, Differentiated Instruction |
+| `social_emotional` | 社会情緒的学習 | SEL, Growth Mindset |
+
+## 主要な教育理論
+
+### 授業設計
+
+| ID | 理論名 | 理論家 | 主な用途 |
+|----|--------|--------|----------|
+| `blooms_taxonomy` | Bloom's Taxonomy | Benjamin Bloom | 学習目標設定 |
+| `gagnes_nine_events` | Nine Events of Instruction | Robert Gagné | 授業構成 |
+| `addie_model` | ADDIE Model | - | 教材開発プロセス |
+| `arcs_model` | ARCS Model | John Keller | 動機づけ設計 |
+
+### 学習理論
+
+| ID | 理論名 | 理論家 | 主な用途 |
+|----|--------|--------|----------|
+| `constructivism` | 構成主義 | Piaget, Vygotsky | 学習観 |
+| `zone_of_proximal_development` | 最近接発達領域 | Vygotsky | 個別支援 |
+| `cognitive_load_theory` | 認知負荷理論 | Sweller | 教材設計 |
+| `schema_theory` | スキーマ理論 | Bartlett | 知識構造 |
+
+### 評価
+
+| ID | 理論名 | 理論家 | 主な用途 |
+|----|--------|--------|----------|
+| `constructive_alignment` | 構成的整合性 | John Biggs | 評価設計 |
+| `formative_assessment` | 形成的評価 | Black & Wiliam | 学習改善 |
+| `mastery_learning` | 完全習得学習 | Benjamin Bloom | 評価基準 |
+
+### 発達心理学
+
+| ID | 理論名 | 理論家 | 主な用途 |
+|----|--------|--------|----------|
+| `piagets_cognitive_development` | 認知発達理論 | Jean Piaget | 発達段階 |
+| `eriksons_psychosocial_development` | 心理社会的発達 | Erik Erikson | 生活指導 |
+| `kohlbergs_moral_development` | 道徳性発達 | Lawrence Kohlberg | 道徳教育 |
+
+### 動機づけ
+
+| ID | 理論名 | 理論家 | 主な用途 |
+|----|--------|--------|----------|
+| `growth_mindset` | 成長マインドセット | Carol Dweck | フィードバック |
+| `self_determination_theory` | 自己決定理論 | Deci & Ryan | 内発的動機づけ |
+| `expectancy_value_theory` | 期待価値理論 | Eccles | 動機づけ分析 |
+
+## 引用形式
+
+### 基本引用形式
+
+```markdown
+### 参照した教育理論
+
+#### {理論名}（{理論家名}）
+- **概要**: {理論の簡潔な説明}
+- **本コンテンツへの適用**: {どのように適用したか}
+- **参考文献**: {出典情報}
+```
+
+### インライン引用
+
+```markdown
+この活動は**Vygotsky**の**最近接発達領域（ZPD）**理論に基づいています。
+生徒が一人では難しいが、適切な支援があればできるレベルの課題を設定しました。
+```
+
+### 複数理論の組み合わせ
+
+```markdown
+### 理論的背景
+
+本授業計画は、以下の教育理論を統合的に適用しています：
+
+| 理論 | 適用箇所 | 効果 |
+|------|----------|------|
+| Gagné's Nine Events | 授業構成 | 効果的な学習の流れ |
+| ARCS Model | 導入・展開 | 動機づけの維持 |
+| Bloom's Taxonomy | 学習目標 | 認知レベルの明確化 |
+```
+
+## エラーハンドリング
+
+### TENJIN接続エラー
+
+```markdown
+> ⚠️ **注意**: 教育理論データベース（TENJIN）への接続に問題が発生しています。
+> 
+> 一般的な教授法に基づいてコンテンツを生成しますが、特定の理論に基づいたエビデンスは含まれていません。
+> 
+> TENJINが利用可能になったら、再度生成することでエビデンス付きのコンテンツを取得できます。
+```
+
+### 理論が見つからない場合
+
+```markdown
+> 💡 **情報**: 「{検索クエリ}」に直接一致する理論は見つかりませんでした。
+> 
+> 関連する可能性のある理論：
+> - {代替理論1}
+> - {代替理論2}
+> 
+> これらの理論を参照しますか？
+```
+
+### フォールバック動作
+
+TENJIN非接続時のフォールバック：
+
+1. **一般的な教授原則を適用**
+   - 学習目標の明確化
+   - 段階的な難易度設定
+   - フィードバックの提供
+
+2. **注意書きを追加**
+   - エビデンスが限定的である旨を明記
+
+3. **再生成の提案**
+   - TENJIN接続後の再生成を案内
+
+## スキル間連携
+
+### 呼び出し元スキルとの連携
+
+| 呼び出し元 | 推奨検索 |
+|-----------|---------|
+| `lesson-plan.md` | instructional_design, blooms_taxonomy |
+| `materials.md` | gagnes_nine_events, arcs_model, cognitive_load |
+| `assessment.md` | constructive_alignment, formative_assessment |
+| `individual.md` | zone_of_proximal_development, differentiated_instruction |
+| `feedback.md` | growth_mindset, effective_feedback |
+| `guidance.md` | erikson, kohlberg, piaget, pbis |
+
+### 連携例
+
+```
+1. lesson-plan.md が theory-lookup.md を呼び出し
+2. search_theories(category="instructional_design") を実行
+3. 推薦された理論（Gagné's Nine Events 等）を取得
+4. lesson-plan.md が理論を授業構成に適用
+5. 引用情報を付与してコンテンツを完成
+```

package/templates/AGENTS.md

@@ -0,0 +1,142 @@
+# SHIDEN - 教育者向けAgent Skills
+
+> 教育理論に基づいたエビデンスベースの教育コンテンツ作成を支援するGitHub Copilot Agent Skillsです。
+
+## システム概要
+
+SHIDENは、教育者（小中高・大学教員）が質の高い教育コンテンツを効率的に作成するためのAIアシスタントです。
+
+### 特徴
+
+1. **メタプロンプト生成** - 曖昧なリクエストを構造化し、真の目的を明確化
+2. **6つのユースケーススキル** - 授業計画、教材、評価、個別指導、フィードバック、生活指導
+3. **TENJIN GraphRAG連携** - 175+の教育理論に基づくエビデンス引用
+
+## ワークフロー
+
+教育コンテンツ作成は以下の3フェーズで進行します：
+
+### Phase 1: メタプロンプト生成
+
+1. ユーザーのリクエストを受け取る
+2. `.github/prompts/meta-prompt.md` を参照してプロンプトを強化
+3. 1問1答形式で必要なコンテキストを収集（最大5問）
+4. 構造化されたメタプロンプトを生成
+
+### Phase 2: スキル実行
+
+1. メタプロンプトに基づいて適切なスキルを選択
+2. `.github/prompts/` 配下の該当スキルを実行
+3. 教育コンテンツを生成
+
+### Phase 3: 理論引用・エビデンス付与
+
+1. `.github/skills/theory-lookup.md` を参照
+2. TENJINから関連する教育理論を取得
+3. 生成されたコンテンツに理論的根拠を付与
+
+## 利用可能スキル
+
+### プロンプト定義 (.github/prompts/)
+
+| スキル | ファイル | 説明 |
+|--------|----------|------|
+| メタプロンプト生成 | `meta-prompt.md` | リクエストの構造化・コンテキスト収集 |
+| 授業計画作成 | `lesson-plan.md` | Bloom's Taxonomy基準の指導案生成 |
+| 教材作成 | `materials.md` | ワークシート、スライド、クイズ生成 |
+| 評価設計 | `assessment.md` | ルーブリック、テスト問題生成 |
+| 個別指導計画 | `individual.md` | 学習者特性に応じた戦略提案 |
+| フィードバック | `feedback.md` | Growth Mindsetに基づく振り返り支援 |
+| 生活指導案 | `guidance.md` | 発達段階を考慮した指導案 |
+
+### 統合スキル (.github/skills/)
+
+| スキル | ファイル | 説明 |
+|--------|----------|------|
+| オーケストレーション | `orchestrator.md` | スキル選択・連携制御 |
+| 理論検索 | `theory-lookup.md` | TENJIN GraphRAG連携 |
+| コンテキスト管理 | `context-manager.md` | セッション情報保持 |
+
+## スキルルーティング
+
+ユーザーのリクエストに含まれるキーワードに基づいて、適切なスキルにルーティングします：
+
+| キーワード | ルーティング先 |
+|-----------|---------------|
+| 授業計画, 指導案, lesson plan | `lesson-plan.md` |
+| 教材, ワークシート, スライド, クイズ | `materials.md` |
+| 評価, ルーブリック, テスト | `assessment.md` |
+| 個別指導, 配慮, 支援 | `individual.md` |
+| フィードバック, 振り返り, コメント | `feedback.md` |
+| 生活指導, 行動, 相談 | `guidance.md` |
+
+### 意図が不明な場合
+
+リクエストの意図が明確でない場合は、以下の確認を行います：
+
+```
+どのような教育コンテンツを作成しますか？
+1. 📚 授業計画・指導案
+2. 📝 教材（ワークシート、スライド等）
+3. ✅ 評価（ルーブリック、テスト等）
+4. 👤 個別指導計画
+5. 💬 フィードバック・振り返り
+6. 🤝 生活指導案
+
+番号または内容でお答えください。
+```
+
+## TENJIN連携
+
+SHIDENはTENJIN GraphRAG MCP Serverと連携し、以下の機能を提供します：
+
+### 主要な連携ツール
+
+- `search_theories(query)` - キーワードで理論を検索
+- `get_theory(theory_id)` - 理論の詳細を取得
+- `recommend_theories(context)` - コンテキストに基づく理論推薦
+- `get_related_theories(theory_id)` - 関連理論の取得
+
+### 引用される主な理論
+
+- **Bloom's Taxonomy** - 認知的領域の分類
+- **Gagné's Nine Events of Instruction** - 教授の9事象
+- **ARCS Model** - 動機づけモデル
+- **Zone of Proximal Development** - 最近接発達領域
+- **Growth Mindset** - 成長マインドセット
+- **Universal Design for Learning** - 学びのユニバーサルデザイン
+
+## 使用例
+
+### 例1: 授業計画作成
+
+```
+中学2年生の数学で「一次関数」の授業計画を作成してください。
+45分授業で、グラフの読み取りを中心にしたいです。
+```
+
+### 例2: 教材作成
+
+```
+小学4年生の理科「電気の流れ」のワークシートを作成してください。
+実験の手順と考察欄を含めてください。
+```
+
+### 例3: 評価設計
+
+```
+高校1年生の英語プレゼンテーション用の5段階ルーブリックを作成してください。
+発音、内容、構成、アイコンタクト、時間管理を評価項目にしてください。
+```
+
+## 注意事項
+
+### 危機対応について
+
+生活指導において危機的状況（自傷、いじめ、虐待等）が疑われる場合は、必ず以下を含めます：
+
+> ⚠️ **重要**: この状況については、スクールカウンセラー、管理職、または専門機関への相談を強くお勧めします。AIの提案はあくまで参考情報であり、専門家の判断に代わるものではありません。
+
+### 理論の限界について
+
+教育理論は万能ではありません。生成されたコンテンツは、教育者自身の専門的判断と組み合わせて活用してください。