shiden 0.4.2 → 0.5.0

package/.github/skills/references/session-schema.md

@@ -0,0 +1,37 @@
+# Session Schema Reference
+
+SHIDENのcontext-managerが優先して保持するキー。
+
+```typescript
+interface ShidenSessionContext {
+  defaults: {
+    grade?: string;
+    subject?: string;
+    topic?: string;
+  };
+  promptContext: {
+    artifactType?: string;
+    learningGoal?: string;
+    constraints?: string[];
+    considerations?: string[];
+  };
+  latestArtifacts: {
+    lessonPlan?: string;
+    materials?: string;
+    assessment?: string;
+    individual?: string;
+    feedback?: string;
+    guidance?: string;
+  };
+  processLogs: {
+    filePaths?: string[];
+    lastSavedAt?: string;
+  };
+}
+```
+
+## Handoff Rule
+
+- 後続promptには、必要なキーだけを抜き出して渡す。
+- 最新の明示入力が保存値より優先される。
+- 匿名化可能な情報は匿名化して保持する。

package/.github/skills/references/sqlite-cli-reference.md

@@ -0,0 +1,23 @@
+# SQLite CLI Reference
+
+SHIDENの理論検索で優先するCLIパターン。
+
+## 基本コマンド
+
+```bash
+npx shiden theories categories
+npx shiden theories search "{keyword}"
+npx shiden theories get {theory_id}
+npx shiden theories related {theory_id} -d 2
+```
+
+## 検索語の作り方
+
+- 成果物タイプ + 目的語で検索する。
+- 例: `学習目標`, `動機づけ`, `形成的評価`, `足場かけ`
+
+## 出力へ残す最小情報
+
+- 理論名
+- どの判断に使ったか
+- 必要なら関連理論との関係

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

@@ -1,288 +1,62 @@
-# 理論検索スキル（SHIDEN SQLite統合）
+---
+name: theory-lookup
+description: >
+  Retrieve relevant education theories from SHIDEN's bundled SQLite database and
+  connect them to the current artifact. Use when a prompt needs theory-backed justification,
+  related theory discovery, or evidence-based instructional rationale.
+metadata:
+  author: nahisaho
+  version: "0.5.0"
+---
 
-> SHIDEN内蔵のSQLite教育理論データベースから175+の教育理論を検索・取得・引用します。
+# Theory Lookup
 
-## 概要
+内蔵教育理論データベースから、成果物に必要な理論を検索して根拠づけする。
 
-このスキルは、SHIDENに内蔵された175件の教育理論を検索・取得するための機能を提供します。FTS5 trigramによる日本語全文検索とWITH RECURSIVE CTEによるグラフ走査をサポートします。
+## Use This Skill When
 
-**v0.3.0の重要な変更**: TENJINのDocker依存を排除し、SQLiteデータベースを直接パッケージに同梱。`npx shiden init` だけでセットアップが完了します。
+- 授業計画、教材、評価、個別支援に理論的根拠が必要である。
+- 適用候補を複数比較したい。
+- 関連理論や補完理論も合わせて確認したい。
 
-## CLI コマンド
+## Workflow
 
-### 基本的な使い方
+1. 現在の成果物タイプと目的から検索キーワードを抽出する。
+2. theories searchで候補を絞り、必要ならcategoryやrelatedを使って比較する。
+3. 採用理論ごとに、何に使うかを1文で説明できる形へ整理する。
+4. 生成物には、理論名だけでなく適用理由と配置箇所を明記する。
+5. 候補が弱い場合は、一般理論を無理に当てず「適用候補が限定的」と明示する。
 
-```bash
-# カテゴリ一覧を表示
-npx shiden theories categories
+## Conditional References
 
-# 理論を検索（FTS5 trigram - 3文字以上推奨）
-npx shiden theories search "社会的構成主義"
-npx shiden theories search "constructivism"
+- Read references/sqlite-cli-reference.md when you need exact theory CLI commands or query patterns.
+- Read ../prompts/references/common-theory-selection.md when mapping theories to prompt types.
 
-# 理論の詳細を取得
-npx shiden theories get theory-003
+## Quality Gates
 
-# 理論一覧を表示
-npx shiden theories list -l 10
+- [ ] 理論名だけでなく、成果物への適用理由がある。
+- [ ] 少なくとも1件は直接適用、必要なら補完理論も提示している。
+- [ ] 検索語が成果物タイプと一致している。
+- [ ] データベース未確認の理論を断定引用していない。
 
-# 関連理論をグラフ走査で取得
-npx shiden theories related theory-003 -d 2
-```
+## Data Handling & Safety
 
-### コマンドリファレンス
+- 理論選定は教育支援の根拠付与であり、医療や法的判断の裏づけに流用しない。
+- 検索結果が乏しい場合は、未確認情報を補完せず不足を明示する。
+- 固有理論を引用するときは、効果を過剰断定しない。
 
-#### `theories categories`
+## Gotchas
 
-カテゴリ一覧と各カテゴリの理論数を表示します。
+- 理論検索を省くとSHIDENのエビデンスベース価値が弱まり、一般生成との差がなくなる。
+- 理論を多く並べすぎると、どこに効いているのか不明瞭になるので2〜3件に絞るのが基本である。
+- 検索語が広すぎると一般論ばかり出るため、成果物タイプと目的語を含めて検索する方が精度が高い。
 
-```bash
-$ npx shiden theories categories
+## Validation Loop
 
-📁 カテゴリ一覧 (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件 █
-```
-
-#### `theories search <query>`
-
-FTS5 trigramによる全文検索を実行します。
-
-**オプション**:
-- `-c, --category <category>`: カテゴリでフィルタ
-- `-l, --limit <number>`: 表示件数（デフォルト: 10）
-- `-v, --verbose`: 詳細表示
-
-```bash
-$ npx shiden theories search "社会的" -v
-
-🔍 検索結果: "社会的" (10件, 4.54ms)
-
-theory-007: Social Constructivism
-  社会的構成主義
-  Category: learning_theory
-  Description: Learning as a social process...
-  Principles: Zone of proximal development, Scaffolding...
-```
-
-**注意**: trigramインデックスのため、3文字以上のクエリを推奨します。2文字以下のクエリはLIKE検索にフォールバックします。
-
-#### `theories get <id>`
-
-理論の詳細情報を取得します。
-
-```bash
-$ npx shiden theories get theory-003
-
-📖 Social Cognitive Theory
-
-日本語名: 社会的認知理論
-カテゴリ: learning_theory
-ID: theory-003
-
-説明:
-  Triadic reciprocal interaction between behavior...
-
-説明（日本語）:
-  行動・環境・個人的要因の三者相互作用と自己効力感
-
-主要原則:
-  • Triadic reciprocal determinism
-  • Self-efficacy as central construct
-  • Self-regulation of behavior
-
-応用分野:
-  • Academic motivation interventions
-  • Health behavior change
-
-強み:
-  ✓ Comprehensive framework
-  ✓ Strong empirical support
-
-限界・制約:
-  ✗ Complexity in measurement
-  ✗ Cultural variations
-```
-
-#### `theories list`
-
-理論一覧を表示します。
-
-**オプション**:
-- `-c, --category <category>`: カテゴリでフィルタ
-- `-l, --limit <number>`: 表示件数（デフォルト: 20）
-- `-o, --offset <number>`: オフセット（デフォルト: 0）
-
-```bash
-$ npx shiden theories list -c motivation -l 5
-
-📚 教育理論一覧 (5/10件)
-
-theory-029: Expectancy-Value Theory
-  期待価値理論
-  Category: motivation
-...
-```
-
-#### `theories related <id>`
-
-WITH RECURSIVE CTEによるグラフ走査で関連理論を取得します。
-
-**オプション**:
-- `-d, --depth <number>`: 走査深さ 1-3（デフォルト: 2）
-
-```bash
-$ npx shiden theories related theory-003 -d 2
-
-🔗 関連理論: Social Cognitive Theory
-
-   起点: theory-003 (深さ: 2)
-
-  └─ theory-014: Self-Efficacy Theory (derived_from)
-    └─ theory-029: Expectancy-Value Theory (complements)
-
-  2件の関連理論
-```
-
-## プログラマティックAPI
-
-TypeScript/JavaScriptからも直接利用可能です：
-
-```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. コンテキストに基づいて理論を検索：
-   ```bash
-   npx shiden theories search "アクティブラーニング"
-   ```
-
-2. 推奨される理論の詳細を確認：
-   ```bash
-   npx shiden theories get theory-038
-   ```
-
-3. 関連理論も併せて検討：
-   ```bash
-   npx shiden theories related theory-038 -d 2
-   ```
-```
-
-## データベース仕様
-
-- **フォーマット**: SQLite 3（better-sqlite3使用）
-- **サイズ**: 約1.5MB
-- **理論数**: 175件
-- **関係数**: 77件
-- **FTS5インデックス**: trigram tokenizer（日本語対応）
-- **データソース**: TENJIN Neo4jデータベースからエクスポート
-
-## TENJIN MCP Server との比較
-
-| 機能 | 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利用） |
-
-**推奨**:
-- **教育者・素早く始めたい方**: SHIDEN SQLite統合
-- **高度な推薦・分析が必要な方**: TENJIN MCP Server
-
-## トラブルシューティング
-
-### 検索結果が0件になる
-
-- 3文字以上のクエリを使用してください（trigramインデックス）
-- 2文字以下のクエリはLIKE検索にフォールバックしますが、精度が下がります
-
-### データベースが見つからない
-
-```
-Database file not found
-```
-
-→ `npm install shiden` を再実行してください。`src/data/theories.db` が含まれているか確認してください。
-
-### 日本語検索がうまくいかない
-
-- trigramインデックスは3文字以上で最適に動作します
-- 「認知」より「認知負荷」のように具体的なクエリを使用してください
+1. 候補理論を選ぶ。
+2. 確認する。
+   - 検索結果に基づいているか。
+   - 成果物内の適用位置が説明できるか。
+   - 過剰断定がないか。
+3. 不合格なら、検索語か採用理論を見直して再検索する。
+4. 適用理由まで説明できたら完了とする。

package/AGENTS.md

@@ -34,7 +34,7 @@ SHIDENは、教育者（小中高・大学教員）が質の高い教育コン
 以下のいずれかに該当する場合、1問1答フローを開始する：
 
 | 条件 | 例 |
-|------|----|
+|------|---|
 | 学年・対象が不明 | 「授業計画を作成して」 |
 | 教科・単元が不明 | 「ワークシートを作って」 |
 | 学習目標が曖昧 | 「わかりやすい教材」 |
@@ -94,13 +94,29 @@ SHIDENは、教育者（小中高・大学教員）が質の高い教育コン
 
 ---
 
-### Phase 2: スキル実行
+### Phase 2: 学習指導要領参照（必須）
+
+> ⚠️ **必須ステップ**: 小中高の授業計画・教材・評価を作成する場合、必ず学習指導要領を参照すること。
+
+1. 対象学年・教科を特定
+2. **学習指導要領を検索**（`npx shiden curriculum search`）
+3. 該当する目標・内容を確認
+4. 出力に「学習指導要領との関連」セクションを含める
+
+```bash
+# 検索例
+npx shiden curriculum subject 算数
+npx shiden curriculum search "一次関数"
+npx shiden curriculum grade "第3学年"
+```
+
+### Phase 3: スキル実行
 
 1. メタプロンプトに基づいて適切なスキルを選択
 2. `.github/prompts/` 配下の該当スキルを実行
-3. 教育コンテンツを生成
+3. **学習指導要領を引用しながら**教育コンテンツを生成
 
-### Phase 3: 理論引用・エビデンス付与
+### Phase 4: 理論引用・エビデンス付与
 
 1. `.github/skills/theory-lookup.md` を参照
 2. TENJINから関連する教育理論を取得
@@ -179,6 +195,54 @@ npx shiden theories related <id>     # 関連理論
 - **Growth Mindset** - 成長マインドセット
 - **Universal Design for Learning** - 学びのユニバーサルデザイン
 
+## 学習指導要領データベース（v0.4.0 NEW!）
+
+SHIDENは**文部科学省の学習指導要領**をGraphRAG DBとして内蔵しています。  
+授業計画・教材作成時に、学習指導要領に準拠した内容を参照できます。
+
+### CLIコマンド
+
+```bash
+npx shiden curriculum search "キーワード"  # 全文検索
+npx shiden curriculum subject <教科名>     # 教科別検索（算数、国語、理科等）
+npx shiden curriculum grade <学年>         # 学年別検索
+npx shiden curriculum stats               # 統計表示
+```
+
+### 収録コンテンツ（2,469セクション）
+
+- **小学校学習指導要領**（平成29年告示）
+  - 国語、社会、算数、理科、生活、音楽、図画工作、家庭、体育、外国語
+  - 特別の教科 道徳、外国語活動、総合的な学習の時間、特別活動
+
+### ⚠️ ワークフローでの活用方法（必須）
+
+> **重要**: 小中高向けの授業計画・教材作成時は、**必ず**以下の手順で学習指導要領を参照すること。
+
+1. **対象学年・教科を特定**（1問1答フローで収集）
+2. **学習指導要領を検索**（`npx shiden curriculum search`）
+3. **該当する目標・内容を引用**してコンテンツに反映
+4. **出力に必須セクション「学習指導要領との関連」を含める**
+5. **理論的根拠と合わせて**エビデンスベースの教材を作成
+
+### 必須出力セクション
+
+```markdown
+### 学習指導要領との関連
+
+**参照箇所**: {学校種}学習指導要領 第{章}章 第{節}節 {教科} {学年}
+**目標**: 「{学習指導要領の目標を引用}」
+**内容**: 「{当該単元の内容を引用}」
+**本教材との対応**: {どのように対応しているか}
+```
+
+**例: 算数「一次関数」の授業計画作成時**
+```bash
+npx shiden curriculum search "関数"
+npx shiden curriculum subject 算数
+```
+→ 学習指導要領の該当箇所を確認し、目標設定に反映
+
 ## 使用例
 
 ### 例1: 授業計画作成

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shiden",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "教育者向けGitHub Copilot Agent Skills - 175件の教育理論＋学習指導要領を内蔵、FTS5日本語検索対応",
   "keywords": [
     "github-copilot",

package/templates/.github/prompts/assessment.md

@@ -14,6 +14,35 @@
 - **推奨**: 学習目標、評価の目的（形成的/総括的）
 - **任意**: 評価観点、配点、フィードバック方針
 
+## ⚠️ 必須: 学習指導要領参照
+
+> **小中高の評価設計時は、必ず学習指導要領を参照すること。**
+
+### 参照手順
+
+```bash
+# 1. 教科で検索
+npx shiden curriculum subject 英語
+
+# 2. 単元・キーワードで検索
+npx shiden curriculum search "プレゼンテーション"
+
+# 3. 学年で絞り込み
+npx shiden curriculum grade "高校"
+```
+
+### 必須出力セクション
+
+評価ツールには必ず以下のセクションを含める：
+
+```markdown
+### 学習指導要領との関連
+
+**参照箇所**: {学校種}学習指導要領 第{章}章 第{節}節 {教科} {学年}
+**評価の観点**: 知識・技能 / 思考・判断・表現 / 主体的に学習に取り組む態度
+**目標との対応**: {評価項目が学習指導要領のどの目標に対応するか}
+```
+
 ## 対応する評価タイプ
 
 | タイプ | 説明 | 適した場面 |

package/templates/.github/prompts/individual.md

@@ -14,6 +14,36 @@
 - **推奨**: 学習スタイル、習熟度、特別な配慮事項
 - **任意**: 強み、興味関心、過去の指導履歴
 
+## ⚠️ 必須: 学習指導要領参照
+
+> **小中高の個別指導計画作成時は、必ず学習指導要領を参照すること。**
+
+### 参照手順
+
+```bash
+# 1. 教科で検索
+npx shiden curriculum subject 算数
+
+# 2. 単元・キーワードで検索
+npx shiden curriculum search "図形"
+
+# 3. 学年で絞り込み
+npx shiden curriculum grade "第2学年"
+```
+
+### 必須出力セクション
+
+個別指導計画には必ず以下のセクションを含める：
+
+```markdown
+### 学習指導要領との関連
+
+**参照箇所**: {学校種}学習指導要領 第{章}章 第{節}節 {教科} {学年}
+**目標**: 「{学習指導要領の目標を引用}」
+**当該学年の内容**: 「{指導する内容の範囲を引用}」
+**前学年との系統性**: {前学年での既習事項との関連}
+```
+
 ## 学習者プロファイル収集
 
 ### プロファイル項目

package/templates/.github/prompts/lesson-plan.md

@@ -14,6 +14,36 @@
 - **推奨**: 学習目標、生徒状況、特別な配慮
 - **任意**: 使用可能な機材、評価基準
 
+## ⚠️ 必須: 学習指導要領参照
+
+> **小中高の授業計画作成時は、必ず学習指導要領を参照すること。**
+
+### 参照手順
+
+```bash
+# 1. 教科で検索
+npx shiden curriculum subject 算数
+
+# 2. 単元・キーワードで検索
+npx shiden curriculum search "一次関数"
+
+# 3. 学年で絞り込み
+npx shiden curriculum grade "第3学年"
+```
+
+### 必須出力セクション
+
+授業計画には必ず以下のセクションを含める：
+
+```markdown
+### 学習指導要領との関連
+
+**参照箇所**: {学校種}学習指導要領 第{章}章 第{節}節 {教科} {学年}
+**目標**: 「{学習指導要領の目標を引用}」
+**内容**: 「{当該単元の内容を引用}」
+**本時との対応**: {本時の目標が学習指導要領のどの部分に対応するか}
+```
+
 ## 出力構造
 
 ### 1. 基本情報
@@ -147,11 +177,11 @@ npx shiden theories related blooms_taxonomy
 - **Zone of Proximal Development** - 難易度設定
 - **ARCS Model** - 動機づけの工夫
 
-## 学習指導要領データベースの活用（v0.4.0 NEW!）
+## 学習指導要領データベースの活用（必須）
 
 ### 学習指導要領の参照手順
 
-授業計画作成時は、必ず**学習指導要領**を参照し、目標・内容を準拠させます。
+> ⚠️ **必須**: 授業計画作成時は、**必ず**学習指導要領を参照し、目標・内容を準拠させます。
 
 ```bash
 # 教科で検索（算数、国語、理科、社会、英語など）

package/templates/.github/prompts/materials.md

@@ -14,6 +14,36 @@
 - **推奨**: 学習目標、難易度、時間配分
 - **任意**: デザイン要件、差別化対応
 
+## ⚠️ 必須: 学習指導要領参照
+
+> **小中高の教材作成時は、必ず学習指導要領を参照すること。**
+
+### 参照手順
+
+```bash
+# 1. 教科で検索
+npx shiden curriculum subject 理科
+
+# 2. 単元・キーワードで検索
+npx shiden curriculum search "電気の流れ"
+
+# 3. 学年で絞り込み
+npx shiden curriculum grade "第4学年"
+```
+
+### 必須出力セクション
+
+教材には必ず以下のセクションを含める：
+
+```markdown
+### 学習指導要領との関連
+
+**参照箇所**: {学校種}学習指導要領 第{章}章 第{節}節 {教科} {学年}
+**目標**: 「{学習指導要領の目標を引用}」
+**内容**: 「{当該単元の内容を引用}」
+**本教材との対応**: {教材内容が学習指導要領のどの部分に対応するか}
+```
+
 ## 対応する教材形式
 
 | 形式 | 説明 | 適した場面 |
@@ -288,11 +318,11 @@ npx shiden theories list --category "授業設計"
 | `arcs_model` | ARCS Model | 動機づけを高める教材設計 |
 | `udl` | Universal Design for Learning | 多様な学習者への対応 |
 
-## 学習指導要領データベースの活用（v0.4.0 NEW!）
+## 学習指導要領データベースの活用（必須）
 
 ### 学習指導要領の参照手順
 
-教材作成時は、**学習指導要領**を参照して内容の妥当性を確認します。
+> ⚠️ **必須**: 教材作成時は、**必ず**学習指導要領を参照して内容の妥当性を確認します。
 
 ```bash
 # 教科で検索