shiden 0.1.0 → 0.3.2

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

@@ -1,283 +1,288 @@
-# 理論検索スキル（TENJIN連携）
+# 理論検索スキル（SHIDEN SQLite統合）
 
-> TENJIN GraphRAG MCP Serverと連携し、教育理論のエビデンスを取得・引用します。
+> SHIDEN内蔵のSQLite教育理論データベースから175+の教育理論を検索・取得・引用します。
 
 ## 概要
 
-このスキルは、他のスキルから呼び出され、TENJIN GraphRAGを通じて175+の教育理論を検索・取得・引用します。生成されるコンテンツにエビデンスベースの裏付けを提供します。
+このスキルは、SHIDENに内蔵された175件の教育理論を検索・取得するための機能を提供します。FTS5 trigramによる日本語全文検索とWITH RECURSIVE CTEによるグラフ走査をサポートします。
 
-## TENJIN MCP Server 連携
+**v0.3.0の重要な変更**: TENJINのDocker依存を排除し、SQLiteデータベースを直接パッケージに同梱。`npx shiden init` だけでセットアップが完了します。
 
-### 接続設定
+## CLI コマンド
 
-TENJINはMCP（Model Context Protocol）サーバーとして動作します。
-VS Codeの設定でMCPサーバーとして登録されている必要があります。
+### 基本的な使い方
 
-### 利用可能なツール
+```bash
+# カテゴリ一覧を表示
+npx shiden theories categories
 
-#### 検索ツール（Search Tools）
+# 理論を検索（FTS5 trigram - 3文字以上推奨）
+npx shiden theories search "社会的構成主義"
+npx shiden theories search "constructivism"
 
-```
-search_theories(query, category?, limit?)
-```
-- **用途**: キーワードで教育理論を検索
-- **パラメータ**:
-  - `query`: 検索キーワード（必須）
-  - `category`: カテゴリフィルタ（任意）
-  - `limit`: 結果数上限（任意、デフォルト: 5）
-- **戻り値**: 理論リスト（ID、名前、概要、関連度スコア）
+# 理論の詳細を取得
+npx shiden theories get theory-003
 
-```
-get_theory(theory_id)
-```
-- **用途**: 特定の理論の詳細を取得
-- **パラメータ**:
-  - `theory_id`: 理論ID（必須）
-- **戻り値**: 理論の完全な情報（定義、理論家、原則、応用例、出典）
+# 理論一覧を表示
+npx shiden theories list -l 10
 
+# 関連理論をグラフ走査で取得
+npx shiden theories related theory-003 -d 2
 ```
-get_theories_by_category(category)
-```
-- **用途**: カテゴリ別の理論一覧を取得
-- **パラメータ**:
-  - `category`: カテゴリ名（必須）
-- **戻り値**: 該当カテゴリの理論リスト
 
-#### 推薦ツール（Recommendation Tools）
+### コマンドリファレンス
 
-```
-recommend_theories(context, learner_profile?)
-```
-- **用途**: コンテキストに基づいて適切な理論を推薦
-- **パラメータ**:
-  - `context`: 教育コンテキスト（必須）
-  - `learner_profile`: 学習者情報（任意）
-- **戻り値**: 推薦理論リスト（推薦理由付き）
+#### `theories categories`
 
-```
-recommend_theories_for_learner(learner_type, learning_goal)
-```
-- **用途**: 学習者タイプに適した理論を推薦
-- **パラメータ**:
-  - `learner_type`: 学習者タイプ
-  - `learning_goal`: 学習目標
-- **戻り値**: 推薦理論リスト
+カテゴリ一覧と各カテゴリの理論数を表示します。
 
-```
-recommend_complementary_theories(theory_id)
-```
-- **用途**: 指定理論と組み合わせると効果的な理論を推薦
-- **パラメータ**:
-  - `theory_id`: 基準となる理論ID
-- **戻り値**: 補完的な理論リスト
+```bash
+$ npx shiden theories categories
 
-#### 分析ツール（Analysis Tools）
+📁 カテゴリ一覧 (11カテゴリ, 175理論)
 
+  learning_theory            45件 █████████
+  asian_education            27件 ██████
+  instructional_design       19件 ████
+  technology_enhanced        18件 ████
+  modern_education           14件 ███
+  social_learning            11件 ███
+  assessment                 10件 ██
+  curriculum                 10件 ██
+  developmental              10件 ██
+  motivation                 10件 ██
+  critical_alternative        1件 █
 ```
-compare_theories(theory_ids[])
-```
-- **用途**: 複数の理論を比較分析
-- **パラメータ**:
-  - `theory_ids`: 比較する理論IDの配列
-- **戻り値**: 比較表（類似点、相違点、使い分けガイド）
 
-```
-analyze_theory(theory_id, analysis_type)
-```
-- **用途**: 理論の深層分析
-- **パラメータ**:
-  - `theory_id`: 理論ID
-  - `analysis_type`: 分析タイプ（strengths, limitations, applications等）
-- **戻り値**: 分析結果
+#### `theories search <query>`
 
-```
-get_theory_applications(theory_id, context)
-```
-- **用途**: 特定コンテキストでの理論の応用例を取得
-- **パラメータ**:
-  - `theory_id`: 理論ID
-  - `context`: 適用コンテキスト
-- **戻り値**: 具体的な応用例
+FTS5 trigramによる全文検索を実行します。
 
-#### グラフ走査ツール（Graph Traversal Tools）
+**オプション**:
+- `-c, --category <category>`: カテゴリでフィルタ
+- `-l, --limit <number>`: 表示件数（デフォルト: 10）
+- `-v, --verbose`: 詳細表示
 
-```
-get_related_theories(theory_id, relation_type?)
-```
-- **用途**: 関連理論を取得
-- **パラメータ**:
-  - `theory_id`: 理論ID
-  - `relation_type`: 関係タイプ（influenced_by, influenced, similar_to等）
-- **戻り値**: 関連理論リスト
+```bash
+$ npx shiden theories search "社会的" -v
 
-```
-find_theory_path(from_id, to_id)
-```
-- **用途**: 2つの理論間の関係パスを探索
-- **パラメータ**:
-  - `from_id`: 起点理論ID
-  - `to_id`: 終点理論ID
-- **戻り値**: 理論間のパス（経由する理論と関係）
+🔍 検索結果: "社会的" (10件, 4.54ms)
 
+theory-007: Social Constructivism
+  社会的構成主義
+  Category: learning_theory
+  Description: Learning as a social process...
+  Principles: Zone of proximal development, Scaffolding...
 ```
-get_influence_chain(theory_id)
-```
-- **用途**: 理論の影響関係チェーンを取得
-- **パラメータ**:
-  - `theory_id`: 理論ID
-- **戻り値**: 影響を与えた/受けた理論のチェーン
 
-## カテゴリ一覧
+**注意**: trigramインデックスのため、3文字以上のクエリを推奨します。2文字以下のクエリはLIKE検索にフォールバックします。
 
-TENJINで利用可能な主なカテゴリ：
+#### `theories get <id>`
 
-| カテゴリ | 説明 | 代表的な理論 |
-|---------|------|-------------|
-| `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 |
+理論の詳細情報を取得します。
 
-## 主要な教育理論
+```bash
+$ npx shiden theories get theory-003
 
-### 授業設計
+📖 Social Cognitive Theory
 
-| 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 | 動機づけ設計 |
+日本語名: 社会的認知理論
+カテゴリ: learning_theory
+ID: theory-003
 
-### 学習理論
+説明:
+  Triadic reciprocal interaction between behavior...
 
-| ID | 理論名 | 理論家 | 主な用途 |
-|----|--------|--------|----------|
-| `constructivism` | 構成主義 | Piaget, Vygotsky | 学習観 |
-| `zone_of_proximal_development` | 最近接発達領域 | Vygotsky | 個別支援 |
-| `cognitive_load_theory` | 認知負荷理論 | Sweller | 教材設計 |
-| `schema_theory` | スキーマ理論 | Bartlett | 知識構造 |
+説明（日本語）:
+  行動・環境・個人的要因の三者相互作用と自己効力感
 
-### 評価
+主要原則:
+  • Triadic reciprocal determinism
+  • Self-efficacy as central construct
+  • Self-regulation of behavior
 
-| ID | 理論名 | 理論家 | 主な用途 |
-|----|--------|--------|----------|
-| `constructive_alignment` | 構成的整合性 | John Biggs | 評価設計 |
-| `formative_assessment` | 形成的評価 | Black & Wiliam | 学習改善 |
-| `mastery_learning` | 完全習得学習 | Benjamin Bloom | 評価基準 |
+応用分野:
+  • Academic motivation interventions
+  • Health behavior change
 
-### 発達心理学
+強み:
+  ✓ Comprehensive framework
+  ✓ Strong empirical support
 
-| ID | 理論名 | 理論家 | 主な用途 |
-|----|--------|--------|----------|
-| `piagets_cognitive_development` | 認知発達理論 | Jean Piaget | 発達段階 |
-| `eriksons_psychosocial_development` | 心理社会的発達 | Erik Erikson | 生活指導 |
-| `kohlbergs_moral_development` | 道徳性発達 | Lawrence Kohlberg | 道徳教育 |
+限界・制約:
+  ✗ Complexity in measurement
+  ✗ Cultural variations
+```
 
-### 動機づけ
+#### `theories list`
 
-| ID | 理論名 | 理論家 | 主な用途 |
-|----|--------|--------|----------|
-| `growth_mindset` | 成長マインドセット | Carol Dweck | フィードバック |
-| `self_determination_theory` | 自己決定理論 | Deci & Ryan | 内発的動機づけ |
-| `expectancy_value_theory` | 期待価値理論 | Eccles | 動機づけ分析 |
+理論一覧を表示します。
 
-## 引用形式
+**オプション**:
+- `-c, --category <category>`: カテゴリでフィルタ
+- `-l, --limit <number>`: 表示件数（デフォルト: 20）
+- `-o, --offset <number>`: オフセット（デフォルト: 0）
 
-### 基本引用形式
+```bash
+$ npx shiden theories list -c motivation -l 5
 
-```markdown
-### 参照した教育理論
+📚 教育理論一覧 (5/10件)
 
-#### {理論名}（{理論家名}）
-- **概要**: {理論の簡潔な説明}
-- **本コンテンツへの適用**: {どのように適用したか}
-- **参考文献**: {出典情報}
+theory-029: Expectancy-Value Theory
+  期待価値理論
+  Category: motivation
+...
 ```
 
-### インライン引用
+#### `theories related <id>`
 
-```markdown
-この活動は**Vygotsky**の**最近接発達領域（ZPD）**理論に基づいています。
-生徒が一人では難しいが、適切な支援があればできるレベルの課題を設定しました。
-```
+WITH RECURSIVE CTEによるグラフ走査で関連理論を取得します。
 
-### 複数理論の組み合わせ
+**オプション**:
+- `-d, --depth <number>`: 走査深さ 1-3（デフォルト: 2）
 
-```markdown
-### 理論的背景
+```bash
+$ npx shiden theories related theory-003 -d 2
+
+🔗 関連理論: Social Cognitive Theory
 
-本授業計画は、以下の教育理論を統合的に適用しています：
+   起点: theory-003 (深さ: 2)
 
-| 理論 | 適用箇所 | 効果 |
-|------|----------|------|
-| Gagné's Nine Events | 授業構成 | 効果的な学習の流れ |
-| ARCS Model | 導入・展開 | 動機づけの維持 |
-| Bloom's Taxonomy | 学習目標 | 認知レベルの明確化 |
+  └─ theory-014: Self-Efficacy Theory (derived_from)
+    └─ theory-029: Expectancy-Value Theory (complements)
+
+  2件の関連理論
 ```
 
-## エラーハンドリング
+## プログラマティックAPI
 
-### TENJIN接続エラー
+TypeScript/JavaScriptからも直接利用可能です：
 
-```markdown
-> ⚠️ **注意**: 教育理論データベース（TENJIN）への接続に問題が発生しています。
-> 
-> 一般的な教授法に基づいてコンテンツを生成しますが、特定の理論に基づいたエビデンスは含まれていません。
-> 
-> TENJINが利用可能になったら、再度生成することでエビデンス付きのコンテンツを取得できます。
+```typescript
+import {
+  search,
+  get,
+  list,
+  categories,
+  related,
+  count,
+  closeDatabase,
+} from 'shiden/theories';
+
+// 検索
+const result = search('社会的学習', { limit: 5 });
+console.log(`${result.total}件 (${result.durationMs}ms)`);
+
+// 詳細取得
+const theory = get('theory-003');
+console.log(theory?.name_ja);
+
+// カテゴリ一覧
+const cats = categories();
+
+// 関連理論（グラフ走査）
+const rel = related('theory-003', { depth: 2 });
+
+// クリーンアップ
+closeDatabase();
 ```
 
-### 理論が見つからない場合
+## カテゴリ一覧
+
+| カテゴリ | 件数 | 説明 |
+|---------|------|------|
+| `learning_theory` | 45 | 学習理論（構成主義、行動主義など） |
+| `asian_education` | 27 | アジアの教育理論 |
+| `instructional_design` | 19 | 授業設計・教授法 |
+| `technology_enhanced` | 18 | 教育工学・ICT活用 |
+| `modern_education` | 14 | 現代教育（21世紀型スキルなど） |
+| `social_learning` | 11 | 社会的学習・協調学習 |
+| `assessment` | 10 | 評価理論 |
+| `curriculum` | 10 | カリキュラム設計 |
+| `developmental` | 10 | 発達心理学 |
+| `motivation` | 10 | 動機づけ理論 |
+| `critical_alternative` | 1 | 批判的教育学 |
+
+## 関係タイプ
+
+理論間の関係は以下のタイプで分類されています：
+
+| タイプ | 説明 |
+|--------|------|
+| `related_to` | 一般的な関連 |
+| `influenced_by` | 影響を受けた |
+| `influences` | 影響を与えた |
+| `builds_upon` | 基盤として構築 |
+| `derived_from` | 派生した |
+| `complements` | 補完的 |
+| `similar_to` | 類似 |
+| `contrasts_with` | 対照的 |
+
+## 他のスキルからの呼び出し
+
+他のスキル（lesson-plan.md、assessment-design.md等）から理論検索を行う場合：
 
 ```markdown
-> 💡 **情報**: 「{検索クエリ}」に直接一致する理論は見つかりませんでした。
-> 
-> 関連する可能性のある理論：
-> - {代替理論1}
-> - {代替理論2}
-> 
-> これらの理論を参照しますか？
+### 使用する教育理論の選定
+
+1. コンテキストに基づいて理論を検索：
+   ```bash
+   npx shiden theories search "アクティブラーニング"
+   ```
+
+2. 推奨される理論の詳細を確認：
+   ```bash
+   npx shiden theories get theory-038
+   ```
+
+3. 関連理論も併せて検討：
+   ```bash
+   npx shiden theories related theory-038 -d 2
+   ```
 ```
 
-### フォールバック動作
+## データベース仕様
 
-TENJIN非接続時のフォールバック：
+- **フォーマット**: SQLite 3（better-sqlite3使用）
+- **サイズ**: 約1.5MB
+- **理論数**: 175件
+- **関係数**: 77件
+- **FTS5インデックス**: trigram tokenizer（日本語対応）
+- **データソース**: TENJIN Neo4jデータベースからエクスポート
 
-1. **一般的な教授原則を適用**
-   - 学習目標の明確化
-   - 段階的な難易度設定
-   - フィードバックの提供
+## TENJIN MCP Server との比較
 
-2. **注意書きを追加**
-   - エビデンスが限定的である旨を明記
+| 機能 | SHIDEN (v0.3.0) | TENJIN MCP |
+|------|-----------------|------------|
+| セットアップ | `npx shiden init` | Docker + Neo4j + ChromaDB |
+| 依存関係 | なし | Neo4j, ChromaDB, Ollama |
+| 理論数 | 175 | 175+ |
+| 検索方式 | FTS5 trigram | ベクトル検索 + GraphRAG |
+| グラフ走査 | WITH RECURSIVE | Cypher |
+| オフライン | ✅ | ❌ |
+| 推薦機能 | ❌ | ✅（LLM利用） |
+| 深層分析 | ❌ | ✅（LLM利用） |
 
-3. **再生成の提案**
-   - TENJIN接続後の再生成を案内
+**推奨**:
+- **教育者・素早く始めたい方**: SHIDEN SQLite統合
+- **高度な推薦・分析が必要な方**: TENJIN MCP Server
 
-## スキル間連携
+## トラブルシューティング
 
-### 呼び出し元スキルとの連携
+### 検索結果が0件になる
 
-| 呼び出し元 | 推奨検索 |
-|-----------|---------|
-| `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 |
+- 3文字以上のクエリを使用してください（trigramインデックス）
+- 2文字以下のクエリはLIKE検索にフォールバックしますが、精度が下がります
 
-### 連携例
+### データベースが見つからない
 
 ```
-1. lesson-plan.md が theory-lookup.md を呼び出し
-2. search_theories(category="instructional_design") を実行
-3. 推薦された理論（Gagné's Nine Events 等）を取得
-4. lesson-plan.md が理論を授業構成に適用
-5. 引用情報を付与してコンテンツを完成
+Database file not found
 ```
+
+→ `npm install shiden` を再実行してください。`src/data/theories.db` が含まれているか確認してください。
+
+### 日本語検索がうまくいかない
+
+- trigramインデックスは3文字以上で最適に動作します
+- 「認知」より「認知負荷」のように具体的なクエリを使用してください

package/templates/.vscode/mcp.json

@@ -0,0 +1,35 @@
+{
+    "mcp": {
+        "servers": {
+            "tenjin": {
+                "command": "uvx",
+                "args": ["--from", "tenjin", "tenjin-server"],
+                "env": {
+                    "NEO4J_URI": "bolt://localhost:7687",
+                    "NEO4J_USER": "neo4j",
+                    "NEO4J_PASSWORD": "password",
+                    "CHROMA_PERSIST_DIR": "./data/chromadb",
+                    "EMBEDDING_PROVIDER": "ollama",
+                    "EMBEDDING_MODEL": "nomic-embed-text",
+                    "LLM_PROVIDER": "ollama",
+                    "LLM_MODEL": "qwen2.5:14b",
+                    "OLLAMA_HOST": "http://localhost:11434"
+                }
+            }
+        }
+    },
+    "inputs": [
+        {
+            "type": "promptString",
+            "id": "neo4j-password",
+            "description": "Neo4j database password",
+            "default": "password"
+        },
+        {
+            "type": "promptString",
+            "id": "ollama-host",
+            "description": "Ollama server URL",
+            "default": "http://localhost:11434"
+        }
+    ]
+}

package/templates/AGENTS.md

@@ -20,9 +20,80 @@ SHIDENは、教育者（小中高・大学教員）が質の高い教育コン
 
 1. ユーザーのリクエストを受け取る
 2. `.github/prompts/meta-prompt.md` を参照してプロンプトを強化
-3. 1問1答形式で必要なコンテキストを収集（最大5問）
+3. **1問1答形式で必要なコンテキストを収集（最大5問）**
 4. 構造化されたメタプロンプトを生成
 
+---
+
+## ⚠️ 重要: 1問1答コンテキスト収集の必須ルール
+
+**AIエージェントは以下のルールを必ず遵守すること。**
+
+### 判定基準: コンテキスト収集が必要な場合
+
+以下のいずれかに該当する場合、1問1答フローを開始する：
+
+| 条件 | 例 |
+|------|---|
+| 学年・対象が不明 | 「授業計画を作成して」 |
+| 教科・単元が不明 | 「ワークシートを作って」 |
+| 学習目標が曖昧 | 「わかりやすい教材」 |
+| 時間制約が不明 | 「授業で使いたい」 |
+| 特別な配慮の有無が不明 | 一般的なリクエスト |
+
+### 🚨 絶対ルール: 1問1答の実行フロー
+
+```
+【禁止】複数の質問を一度に提示すること
+【必須】1つの質問 → 回答待ち → 次の質問
+```
+
+#### Step 1: プロンプト強化・確認
+```
+📝 あなたのリクエストを以下のように理解しました：
+
+【元のリクエスト】{ユーザーの元のリクエスト}
+【強化されたリクエスト】{構造化されたリクエスト}
+【補足した要素】- {推測した情報}
+
+👉 この理解で正しいですか？修正があればお知らせください。
+```
+→ ユーザーの確認を待つ
+
+#### Step 2: 1問1答でコンテキスト収集
+
+**質問は必ず1つずつ。ユーザーの回答を待ってから次へ進む。**
+
+| 順序 | 質問内容 | 条件 |
+|------|---------|------|
+| Q1 | 学習目標（何を達成させたいか） | 目標が不明な場合 |
+| Q2 | 学習者レベル（学年・習熟度） | 対象が不明な場合 |
+| Q3 | 配慮事項（特別支援等） | 任意（スキップ可） |
+| Q4 | 時間・リソース制約 | 制約が不明な場合 |
+| Q5 | 成功基準（どうなれば成功か） | 任意（スキップ可） |
+
+**質問フォーマット例:**
+```
+📌 [Q1/5] この授業/教材で、生徒に達成してほしい具体的な目標は何ですか？
+（例: 「一次関数のグラフを正確に描けるようになる」）
+
+💡 スキップする場合は「スキップ」とお伝えください。
+```
+→ **必ずユーザーの回答を待つ**
+
+#### Step 3: 終了判定
+
+以下のいずれかで質問フェーズを終了：
+- 5問すべて完了
+- ユーザーが「もう十分」「早く作って」と発言
+- 必要な情報が揃った（学年・教科・目標が明確）
+
+#### Step 4: メタプロンプト生成
+
+収集した情報を統合し、メタプロンプトを生成・表示してからスキル実行へ。
+
+---
+
 ### Phase 2: スキル実行
 
 1. メタプロンプトに基づいて適切なスキルを選択