shiden 0.1.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/.github/skills/theory-lookup.md +215 -210
  2. package/README.md +78 -10
  3. package/dist/cli/commands/theories.js +191 -0
  4. package/dist/cli/commands/theories.js.map +1 -0
  5. package/dist/cli/index.js +30 -59
  6. package/dist/cli/index.js.map +1 -1
  7. package/dist/theories/TheoryRepository.js +169 -0
  8. package/dist/theories/TheoryRepository.js.map +1 -0
  9. package/dist/theories/TheoryService.js +102 -0
  10. package/dist/theories/TheoryService.js.map +1 -0
  11. package/dist/theories/database.js +62 -0
  12. package/dist/theories/database.js.map +1 -0
  13. package/dist/theories/index.js +10 -0
  14. package/dist/theories/index.js.map +1 -0
  15. package/dist/theories/types.js +7 -0
  16. package/dist/theories/types.js.map +1 -0
  17. package/dist/types/cli/commands/theories.d.ts +12 -0
  18. package/dist/types/cli/commands/theories.d.ts.map +1 -0
  19. package/dist/types/theories/TheoryRepository.d.ts +52 -0
  20. package/dist/types/theories/TheoryRepository.d.ts.map +1 -0
  21. package/dist/types/theories/TheoryService.d.ts +48 -0
  22. package/dist/types/theories/TheoryService.d.ts.map +1 -0
  23. package/dist/types/theories/database.d.ts +20 -0
  24. package/dist/types/theories/database.d.ts.map +1 -0
  25. package/dist/types/theories/index.d.ts +8 -0
  26. package/dist/types/theories/index.d.ts.map +1 -0
  27. package/dist/types/theories/types.d.ts +132 -0
  28. package/dist/types/theories/types.d.ts.map +1 -0
  29. package/package.json +10 -3
  30. package/src/data/relations.json +464 -0
  31. package/src/data/theories.db +0 -0
  32. package/src/data/theories.db-shm +0 -0
  33. package/src/data/theories.db-wal +0 -0
  34. package/src/data/theories.json +6063 -0
  35. package/templates/.github/prompts/assessment.md +25 -11
  36. package/templates/.github/prompts/feedback.md +26 -11
  37. package/templates/.github/prompts/guidance.md +27 -13
  38. package/templates/.github/prompts/individual.md +28 -16
  39. package/templates/.github/prompts/lesson-plan.md +26 -18
  40. package/templates/.github/prompts/materials.md +25 -9
  41. package/templates/.github/prompts/meta-prompt.md +8 -1
  42. package/templates/.github/skills/context-manager.md +2 -2
  43. package/templates/.github/skills/orchestrator.md +14 -6
  44. package/templates/.github/skills/theory-lookup.md +215 -210
  45. package/templates/.vscode/mcp.json +35 -0
@@ -1,283 +1,288 @@
1
- # 理論検索スキル(TENJIN連携)
1
+ # 理論検索スキル(SHIDEN SQLite統合)
2
2
 
3
- > TENJIN GraphRAG MCP Serverと連携し、教育理論のエビデンスを取得・引用します。
3
+ > SHIDEN内蔵のSQLite教育理論データベースから175+の教育理論を検索・取得・引用します。
4
4
 
5
5
  ## 概要
6
6
 
7
- このスキルは、他のスキルから呼び出され、TENJIN GraphRAGを通じて175+の教育理論を検索・取得・引用します。生成されるコンテンツにエビデンスベースの裏付けを提供します。
7
+ このスキルは、SHIDENに内蔵された175件の教育理論を検索・取得するための機能を提供します。FTS5 trigramによる日本語全文検索とWITH RECURSIVE CTEによるグラフ走査をサポートします。
8
8
 
9
- ## TENJIN MCP Server 連携
9
+ **v0.3.0の重要な変更**: TENJINのDocker依存を排除し、SQLiteデータベースを直接パッケージに同梱。`npx shiden init` だけでセットアップが完了します。
10
10
 
11
- ### 接続設定
11
+ ## CLI コマンド
12
12
 
13
- TENJINはMCP(Model Context Protocol)サーバーとして動作します。
14
- VS Codeの設定でMCPサーバーとして登録されている必要があります。
13
+ ### 基本的な使い方
15
14
 
16
- ### 利用可能なツール
15
+ ```bash
16
+ # カテゴリ一覧を表示
17
+ npx shiden theories categories
17
18
 
18
- #### 検索ツール(Search Tools)
19
+ # 理論を検索(FTS5 trigram - 3文字以上推奨)
20
+ npx shiden theories search "社会的構成主義"
21
+ npx shiden theories search "constructivism"
19
22
 
20
- ```
21
- search_theories(query, category?, limit?)
22
- ```
23
- - **用途**: キーワードで教育理論を検索
24
- - **パラメータ**:
25
- - `query`: 検索キーワード(必須)
26
- - `category`: カテゴリフィルタ(任意)
27
- - `limit`: 結果数上限(任意、デフォルト: 5)
28
- - **戻り値**: 理論リスト(ID、名前、概要、関連度スコア)
23
+ # 理論の詳細を取得
24
+ npx shiden theories get theory-003
29
25
 
30
- ```
31
- get_theory(theory_id)
32
- ```
33
- - **用途**: 特定の理論の詳細を取得
34
- - **パラメータ**:
35
- - `theory_id`: 理論ID(必須)
36
- - **戻り値**: 理論の完全な情報(定義、理論家、原則、応用例、出典)
26
+ # 理論一覧を表示
27
+ npx shiden theories list -l 10
37
28
 
29
+ # 関連理論をグラフ走査で取得
30
+ npx shiden theories related theory-003 -d 2
38
31
  ```
39
- get_theories_by_category(category)
40
- ```
41
- - **用途**: カテゴリ別の理論一覧を取得
42
- - **パラメータ**:
43
- - `category`: カテゴリ名(必須)
44
- - **戻り値**: 該当カテゴリの理論リスト
45
32
 
46
- #### 推薦ツール(Recommendation Tools)
33
+ ### コマンドリファレンス
47
34
 
48
- ```
49
- recommend_theories(context, learner_profile?)
50
- ```
51
- - **用途**: コンテキストに基づいて適切な理論を推薦
52
- - **パラメータ**:
53
- - `context`: 教育コンテキスト(必須)
54
- - `learner_profile`: 学習者情報(任意)
55
- - **戻り値**: 推薦理論リスト(推薦理由付き)
35
+ #### `theories categories`
56
36
 
57
- ```
58
- recommend_theories_for_learner(learner_type, learning_goal)
59
- ```
60
- - **用途**: 学習者タイプに適した理論を推薦
61
- - **パラメータ**:
62
- - `learner_type`: 学習者タイプ
63
- - `learning_goal`: 学習目標
64
- - **戻り値**: 推薦理論リスト
37
+ カテゴリ一覧と各カテゴリの理論数を表示します。
65
38
 
66
- ```
67
- recommend_complementary_theories(theory_id)
68
- ```
69
- - **用途**: 指定理論と組み合わせると効果的な理論を推薦
70
- - **パラメータ**:
71
- - `theory_id`: 基準となる理論ID
72
- - **戻り値**: 補完的な理論リスト
39
+ ```bash
40
+ $ npx shiden theories categories
73
41
 
74
- #### 分析ツール(Analysis Tools)
42
+ 📁 カテゴリ一覧 (11カテゴリ, 175理論)
75
43
 
44
+ learning_theory 45件 █████████
45
+ asian_education 27件 ██████
46
+ instructional_design 19件 ████
47
+ technology_enhanced 18件 ████
48
+ modern_education 14件 ███
49
+ social_learning 11件 ███
50
+ assessment 10件 ██
51
+ curriculum 10件 ██
52
+ developmental 10件 ██
53
+ motivation 10件 ██
54
+ critical_alternative 1件 █
76
55
  ```
77
- compare_theories(theory_ids[])
78
- ```
79
- - **用途**: 複数の理論を比較分析
80
- - **パラメータ**:
81
- - `theory_ids`: 比較する理論IDの配列
82
- - **戻り値**: 比較表(類似点、相違点、使い分けガイド)
83
56
 
84
- ```
85
- analyze_theory(theory_id, analysis_type)
86
- ```
87
- - **用途**: 理論の深層分析
88
- - **パラメータ**:
89
- - `theory_id`: 理論ID
90
- - `analysis_type`: 分析タイプ(strengths, limitations, applications等)
91
- - **戻り値**: 分析結果
57
+ #### `theories search <query>`
92
58
 
93
- ```
94
- get_theory_applications(theory_id, context)
95
- ```
96
- - **用途**: 特定コンテキストでの理論の応用例を取得
97
- - **パラメータ**:
98
- - `theory_id`: 理論ID
99
- - `context`: 適用コンテキスト
100
- - **戻り値**: 具体的な応用例
59
+ FTS5 trigramによる全文検索を実行します。
101
60
 
102
- #### グラフ走査ツール(Graph Traversal Tools)
61
+ **オプション**:
62
+ - `-c, --category <category>`: カテゴリでフィルタ
63
+ - `-l, --limit <number>`: 表示件数(デフォルト: 10)
64
+ - `-v, --verbose`: 詳細表示
103
65
 
104
- ```
105
- get_related_theories(theory_id, relation_type?)
106
- ```
107
- - **用途**: 関連理論を取得
108
- - **パラメータ**:
109
- - `theory_id`: 理論ID
110
- - `relation_type`: 関係タイプ(influenced_by, influenced, similar_to等)
111
- - **戻り値**: 関連理論リスト
66
+ ```bash
67
+ $ npx shiden theories search "社会的" -v
112
68
 
113
- ```
114
- find_theory_path(from_id, to_id)
115
- ```
116
- - **用途**: 2つの理論間の関係パスを探索
117
- - **パラメータ**:
118
- - `from_id`: 起点理論ID
119
- - `to_id`: 終点理論ID
120
- - **戻り値**: 理論間のパス(経由する理論と関係)
69
+ 🔍 検索結果: "社会的" (10件, 4.54ms)
121
70
 
71
+ theory-007: Social Constructivism
72
+ 社会的構成主義
73
+ Category: learning_theory
74
+ Description: Learning as a social process...
75
+ Principles: Zone of proximal development, Scaffolding...
122
76
  ```
123
- get_influence_chain(theory_id)
124
- ```
125
- - **用途**: 理論の影響関係チェーンを取得
126
- - **パラメータ**:
127
- - `theory_id`: 理論ID
128
- - **戻り値**: 影響を与えた/受けた理論のチェーン
129
77
 
130
- ## カテゴリ一覧
78
+ **注意**: trigramインデックスのため、3文字以上のクエリを推奨します。2文字以下のクエリはLIKE検索にフォールバックします。
131
79
 
132
- TENJINで利用可能な主なカテゴリ:
80
+ #### `theories get <id>`
133
81
 
134
- | カテゴリ | 説明 | 代表的な理論 |
135
- |---------|------|-------------|
136
- | `instructional_design` | 授業設計・教授法 | Gagné's Nine Events, ADDIE |
137
- | `learning_theory` | 学習理論 | Constructivism, Behaviorism |
138
- | `cognitive` | 認知心理学 | Cognitive Load Theory, Schema Theory |
139
- | `motivation` | 動機づけ | ARCS Model, Self-Determination Theory |
140
- | `assessment` | 評価理論 | Formative Assessment, Constructive Alignment |
141
- | `development` | 発達心理学 | Piaget, Vygotsky, Erikson |
142
- | `special_needs` | 特別支援教育 | UDL, Differentiated Instruction |
143
- | `social_emotional` | 社会情緒的学習 | SEL, Growth Mindset |
82
+ 理論の詳細情報を取得します。
144
83
 
145
- ## 主要な教育理論
84
+ ```bash
85
+ $ npx shiden theories get theory-003
146
86
 
147
- ### 授業設計
87
+ 📖 Social Cognitive Theory
148
88
 
149
- | ID | 理論名 | 理論家 | 主な用途 |
150
- |----|--------|--------|----------|
151
- | `blooms_taxonomy` | Bloom's Taxonomy | Benjamin Bloom | 学習目標設定 |
152
- | `gagnes_nine_events` | Nine Events of Instruction | Robert Gagné | 授業構成 |
153
- | `addie_model` | ADDIE Model | - | 教材開発プロセス |
154
- | `arcs_model` | ARCS Model | John Keller | 動機づけ設計 |
89
+ 日本語名: 社会的認知理論
90
+ カテゴリ: learning_theory
91
+ ID: theory-003
155
92
 
156
- ### 学習理論
93
+ 説明:
94
+ Triadic reciprocal interaction between behavior...
157
95
 
158
- | ID | 理論名 | 理論家 | 主な用途 |
159
- |----|--------|--------|----------|
160
- | `constructivism` | 構成主義 | Piaget, Vygotsky | 学習観 |
161
- | `zone_of_proximal_development` | 最近接発達領域 | Vygotsky | 個別支援 |
162
- | `cognitive_load_theory` | 認知負荷理論 | Sweller | 教材設計 |
163
- | `schema_theory` | スキーマ理論 | Bartlett | 知識構造 |
96
+ 説明(日本語):
97
+ 行動・環境・個人的要因の三者相互作用と自己効力感
164
98
 
165
- ### 評価
99
+ 主要原則:
100
+ • Triadic reciprocal determinism
101
+ • Self-efficacy as central construct
102
+ • Self-regulation of behavior
166
103
 
167
- | ID | 理論名 | 理論家 | 主な用途 |
168
- |----|--------|--------|----------|
169
- | `constructive_alignment` | 構成的整合性 | John Biggs | 評価設計 |
170
- | `formative_assessment` | 形成的評価 | Black & Wiliam | 学習改善 |
171
- | `mastery_learning` | 完全習得学習 | Benjamin Bloom | 評価基準 |
104
+ 応用分野:
105
+ • Academic motivation interventions
106
+ Health behavior change
172
107
 
173
- ### 発達心理学
108
+ 強み:
109
+ ✓ Comprehensive framework
110
+ ✓ Strong empirical support
174
111
 
175
- | ID | 理論名 | 理論家 | 主な用途 |
176
- |----|--------|--------|----------|
177
- | `piagets_cognitive_development` | 認知発達理論 | Jean Piaget | 発達段階 |
178
- | `eriksons_psychosocial_development` | 心理社会的発達 | Erik Erikson | 生活指導 |
179
- | `kohlbergs_moral_development` | 道徳性発達 | Lawrence Kohlberg | 道徳教育 |
112
+ 限界・制約:
113
+ ✗ Complexity in measurement
114
+ Cultural variations
115
+ ```
180
116
 
181
- ### 動機づけ
117
+ #### `theories list`
182
118
 
183
- | ID | 理論名 | 理論家 | 主な用途 |
184
- |----|--------|--------|----------|
185
- | `growth_mindset` | 成長マインドセット | Carol Dweck | フィードバック |
186
- | `self_determination_theory` | 自己決定理論 | Deci & Ryan | 内発的動機づけ |
187
- | `expectancy_value_theory` | 期待価値理論 | Eccles | 動機づけ分析 |
119
+ 理論一覧を表示します。
188
120
 
189
- ## 引用形式
121
+ **オプション**:
122
+ - `-c, --category <category>`: カテゴリでフィルタ
123
+ - `-l, --limit <number>`: 表示件数(デフォルト: 20)
124
+ - `-o, --offset <number>`: オフセット(デフォルト: 0)
190
125
 
191
- ### 基本引用形式
126
+ ```bash
127
+ $ npx shiden theories list -c motivation -l 5
192
128
 
193
- ```markdown
194
- ### 参照した教育理論
129
+ 📚 教育理論一覧 (5/10件)
195
130
 
196
- #### {理論名}({理論家名})
197
- - **概要**: {理論の簡潔な説明}
198
- - **本コンテンツへの適用**: {どのように適用したか}
199
- - **参考文献**: {出典情報}
131
+ theory-029: Expectancy-Value Theory
132
+ 期待価値理論
133
+ Category: motivation
134
+ ...
200
135
  ```
201
136
 
202
- ### インライン引用
137
+ #### `theories related <id>`
203
138
 
204
- ```markdown
205
- この活動は**Vygotsky**の**最近接発達領域(ZPD)**理論に基づいています。
206
- 生徒が一人では難しいが、適切な支援があればできるレベルの課題を設定しました。
207
- ```
139
+ WITH RECURSIVE CTEによるグラフ走査で関連理論を取得します。
208
140
 
209
- ### 複数理論の組み合わせ
141
+ **オプション**:
142
+ - `-d, --depth <number>`: 走査深さ 1-3(デフォルト: 2)
210
143
 
211
- ```markdown
212
- ### 理論的背景
144
+ ```bash
145
+ $ npx shiden theories related theory-003 -d 2
146
+
147
+ 🔗 関連理論: Social Cognitive Theory
213
148
 
214
- 本授業計画は、以下の教育理論を統合的に適用しています:
149
+ 起点: theory-003 (深さ: 2)
215
150
 
216
- | 理論 | 適用箇所 | 効果 |
217
- |------|----------|------|
218
- | Gagné's Nine Events | 授業構成 | 効果的な学習の流れ |
219
- | ARCS Model | 導入・展開 | 動機づけの維持 |
220
- | Bloom's Taxonomy | 学習目標 | 認知レベルの明確化 |
151
+ └─ theory-014: Self-Efficacy Theory (derived_from)
152
+ └─ theory-029: Expectancy-Value Theory (complements)
153
+
154
+ 2件の関連理論
221
155
  ```
222
156
 
223
- ## エラーハンドリング
157
+ ## プログラマティックAPI
224
158
 
225
- ### TENJIN接続エラー
159
+ TypeScript/JavaScriptからも直接利用可能です:
226
160
 
227
- ```markdown
228
- > ⚠️ **注意**: 教育理論データベース(TENJIN)への接続に問題が発生しています。
229
- >
230
- > 一般的な教授法に基づいてコンテンツを生成しますが、特定の理論に基づいたエビデンスは含まれていません。
231
- >
232
- > TENJINが利用可能になったら、再度生成することでエビデンス付きのコンテンツを取得できます。
161
+ ```typescript
162
+ import {
163
+ search,
164
+ get,
165
+ list,
166
+ categories,
167
+ related,
168
+ count,
169
+ closeDatabase,
170
+ } from 'shiden/theories';
171
+
172
+ // 検索
173
+ const result = search('社会的学習', { limit: 5 });
174
+ console.log(`${result.total}件 (${result.durationMs}ms)`);
175
+
176
+ // 詳細取得
177
+ const theory = get('theory-003');
178
+ console.log(theory?.name_ja);
179
+
180
+ // カテゴリ一覧
181
+ const cats = categories();
182
+
183
+ // 関連理論(グラフ走査)
184
+ const rel = related('theory-003', { depth: 2 });
185
+
186
+ // クリーンアップ
187
+ closeDatabase();
233
188
  ```
234
189
 
235
- ### 理論が見つからない場合
190
+ ## カテゴリ一覧
191
+
192
+ | カテゴリ | 件数 | 説明 |
193
+ |---------|------|------|
194
+ | `learning_theory` | 45 | 学習理論(構成主義、行動主義など) |
195
+ | `asian_education` | 27 | アジアの教育理論 |
196
+ | `instructional_design` | 19 | 授業設計・教授法 |
197
+ | `technology_enhanced` | 18 | 教育工学・ICT活用 |
198
+ | `modern_education` | 14 | 現代教育(21世紀型スキルなど) |
199
+ | `social_learning` | 11 | 社会的学習・協調学習 |
200
+ | `assessment` | 10 | 評価理論 |
201
+ | `curriculum` | 10 | カリキュラム設計 |
202
+ | `developmental` | 10 | 発達心理学 |
203
+ | `motivation` | 10 | 動機づけ理論 |
204
+ | `critical_alternative` | 1 | 批判的教育学 |
205
+
206
+ ## 関係タイプ
207
+
208
+ 理論間の関係は以下のタイプで分類されています:
209
+
210
+ | タイプ | 説明 |
211
+ |--------|------|
212
+ | `related_to` | 一般的な関連 |
213
+ | `influenced_by` | 影響を受けた |
214
+ | `influences` | 影響を与えた |
215
+ | `builds_upon` | 基盤として構築 |
216
+ | `derived_from` | 派生した |
217
+ | `complements` | 補完的 |
218
+ | `similar_to` | 類似 |
219
+ | `contrasts_with` | 対照的 |
220
+
221
+ ## 他のスキルからの呼び出し
222
+
223
+ 他のスキル(lesson-plan.md、assessment-design.md等)から理論検索を行う場合:
236
224
 
237
225
  ```markdown
238
- > 💡 **情報**: 「{検索クエリ}」に直接一致する理論は見つかりませんでした。
239
- >
240
- > 関連する可能性のある理論:
241
- > - {代替理論1}
242
- > - {代替理論2}
243
- >
244
- > これらの理論を参照しますか?
226
+ ### 使用する教育理論の選定
227
+
228
+ 1. コンテキストに基づいて理論を検索:
229
+ ```bash
230
+ npx shiden theories search "アクティブラーニング"
231
+ ```
232
+
233
+ 2. 推奨される理論の詳細を確認:
234
+ ```bash
235
+ npx shiden theories get theory-038
236
+ ```
237
+
238
+ 3. 関連理論も併せて検討:
239
+ ```bash
240
+ npx shiden theories related theory-038 -d 2
241
+ ```
245
242
  ```
246
243
 
247
- ### フォールバック動作
244
+ ## データベース仕様
248
245
 
249
- TENJIN非接続時のフォールバック:
246
+ - **フォーマット**: SQLite 3(better-sqlite3使用)
247
+ - **サイズ**: 約1.5MB
248
+ - **理論数**: 175件
249
+ - **関係数**: 77件
250
+ - **FTS5インデックス**: trigram tokenizer(日本語対応)
251
+ - **データソース**: TENJIN Neo4jデータベースからエクスポート
250
252
 
251
- 1. **一般的な教授原則を適用**
252
- - 学習目標の明確化
253
- - 段階的な難易度設定
254
- - フィードバックの提供
253
+ ## TENJIN MCP Server との比較
255
254
 
256
- 2. **注意書きを追加**
257
- - エビデンスが限定的である旨を明記
255
+ | 機能 | SHIDEN (v0.3.0) | TENJIN MCP |
256
+ |------|-----------------|------------|
257
+ | セットアップ | `npx shiden init` | Docker + Neo4j + ChromaDB |
258
+ | 依存関係 | なし | Neo4j, ChromaDB, Ollama |
259
+ | 理論数 | 175 | 175+ |
260
+ | 検索方式 | FTS5 trigram | ベクトル検索 + GraphRAG |
261
+ | グラフ走査 | WITH RECURSIVE | Cypher |
262
+ | オフライン | ✅ | ❌ |
263
+ | 推薦機能 | ❌ | ✅(LLM利用) |
264
+ | 深層分析 | ❌ | ✅(LLM利用) |
258
265
 
259
- 3. **再生成の提案**
260
- - TENJIN接続後の再生成を案内
266
+ **推奨**:
267
+ - **教育者・素早く始めたい方**: SHIDEN SQLite統合
268
+ - **高度な推薦・分析が必要な方**: TENJIN MCP Server
261
269
 
262
- ## スキル間連携
270
+ ## トラブルシューティング
263
271
 
264
- ### 呼び出し元スキルとの連携
272
+ ### 検索結果が0件になる
265
273
 
266
- | 呼び出し元 | 推奨検索 |
267
- |-----------|---------|
268
- | `lesson-plan.md` | instructional_design, blooms_taxonomy |
269
- | `materials.md` | gagnes_nine_events, arcs_model, cognitive_load |
270
- | `assessment.md` | constructive_alignment, formative_assessment |
271
- | `individual.md` | zone_of_proximal_development, differentiated_instruction |
272
- | `feedback.md` | growth_mindset, effective_feedback |
273
- | `guidance.md` | erikson, kohlberg, piaget, pbis |
274
+ - 3文字以上のクエリを使用してください(trigramインデックス)
275
+ - 2文字以下のクエリはLIKE検索にフォールバックしますが、精度が下がります
274
276
 
275
- ### 連携例
277
+ ### データベースが見つからない
276
278
 
277
279
  ```
278
- 1. lesson-plan.md theory-lookup.md を呼び出し
279
- 2. search_theories(category="instructional_design") を実行
280
- 3. 推薦された理論(Gagné's Nine Events 等)を取得
281
- 4. lesson-plan.md が理論を授業構成に適用
282
- 5. 引用情報を付与してコンテンツを完成
280
+ Database file not found
283
281
  ```
282
+
283
+ → `npm install shiden` を再実行してください。`src/data/theories.db` が含まれているか確認してください。
284
+
285
+ ### 日本語検索がうまくいかない
286
+
287
+ - trigramインデックスは3文字以上で最適に動作します
288
+ - 「認知」より「認知負荷」のように具体的なクエリを使用してください
package/README.md CHANGED
@@ -4,14 +4,15 @@
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
5
 
6
6
  **SHIDEN**(紫電)は、教育者のためのGitHub Copilot Agent Skillsパッケージです。
7
- TENJIN GraphRAGと連携し、175+の教育理論に基づいたエビデンスベースの教育コンテンツ作成を支援します。
7
+ **175件の教育理論を内蔵**し、エビデンスベースの教育コンテンツ作成を支援します。
8
8
 
9
9
  ## ✨ 特徴
10
10
 
11
11
  - 🎯 **6つのユースケーススキル** - 授業計画、教材、評価、個別指導、フィードバック、生活指導
12
12
  - 🧠 **メタプロンプト生成** - 曖昧なリクエストを構造化し、最適なコンテンツを生成
13
- - 📚 **TENJIN GraphRAG連携** - 175+の教育理論に基づくエビデンス引用
13
+ - 📚 **175件の教育理論を内蔵** - FTS5 trigramで日本語全文検索対応(v0.3.0 NEW!)
14
14
  - 🔄 **スキルオーケストレーション** - 複数スキルの自動連携
15
+ - 🚀 **ゼロコンフィグ** - Docker不要、インストール即利用可能(v0.3.0 NEW!)
15
16
 
16
17
  ## 🚀 クイックスタート(3ステップ)
17
18
 
@@ -40,6 +41,39 @@ VS Codeでプロジェクトを開き、GitHub Copilot Chatで以下のように
40
41
  @workspace 中学2年生の数学で「一次関数」の授業計画を作成してください
41
42
  ```
42
43
 
44
+ ## 🆕 v0.3.0: 教育理論CLI
45
+
46
+ **175件の教育理論をSQLiteデータベースとして内蔵**。Docker/外部依存なしで即座に利用可能です。
47
+
48
+ ```bash
49
+ # カテゴリ一覧
50
+ npx shiden theories categories
51
+
52
+ # 理論を検索(日本語対応)
53
+ npx shiden theories search "社会的構成主義"
54
+
55
+ # 理論の詳細を取得
56
+ npx shiden theories get theory-003
57
+
58
+ # 関連理論をグラフ走査
59
+ npx shiden theories related theory-003 -d 2
60
+ ```
61
+
62
+ ### カテゴリ一覧
63
+
64
+ | カテゴリ | 件数 | 説明 |
65
+ |---------|------|------|
66
+ | `learning_theory` | 45 | 学習理論(構成主義、行動主義など) |
67
+ | `asian_education` | 27 | アジアの教育理論 |
68
+ | `instructional_design` | 19 | 授業設計・教授法 |
69
+ | `technology_enhanced` | 18 | 教育工学・ICT活用 |
70
+ | `modern_education` | 14 | 現代教育(21世紀型スキルなど) |
71
+ | `social_learning` | 11 | 社会的学習・協調学習 |
72
+ | `assessment` | 10 | 評価理論 |
73
+ | `curriculum` | 10 | カリキュラム設計 |
74
+ | `developmental` | 10 | 発達心理学 |
75
+ | `motivation` | 10 | 動機づけ理論 |
76
+
43
77
  ## 📖 6つのユースケーススキル
44
78
 
45
79
  | スキル | 説明 | 例 |
@@ -51,9 +85,41 @@ VS Codeでプロジェクトを開き、GitHub Copilot Chatで以下のように
51
85
  | **フィードバック** | Growth Mindsetに基づく振り返り支援 | 「この作文にフィードバックを」 |
52
86
  | **生活指導案** | 発達段階を考慮した指導案 | 「友人関係のトラブルへの対応を」 |
53
87
 
54
- ## 🔗 TENJIN GraphRAG連携
88
+ ## 🔗 TENJIN GraphRAG連携(オプション)
89
+
90
+ より高度な推薦・分析機能が必要な場合は、[TENJIN](https://github.com/nahisaho/TENJIN) MCP Serverと連携できます。
55
91
 
56
- SHIDENは[TENJIN](https://github.com/nahisaho/tenjin)と連携し、教育理論のエビデンスを自動引用します。
92
+ > **v0.3.0 Note**: 基本的な理論検索はSHIDEN内蔵のSQLiteデータベースで動作します。TENJINはオプションです。
93
+
94
+ ### TENJINセットアップ
95
+
96
+ ```bash
97
+ # TENJINリポジトリをクローン
98
+ git clone https://github.com/nahisaho/TENJIN.git
99
+ cd TENJIN
100
+
101
+ # Neo4j + ChromaDB + Redisを起動
102
+ docker-compose up -d
103
+
104
+ # TENJINインストール
105
+ uvx tenjin-server
106
+ ```
107
+
108
+ ### SHIDEN vs TENJIN 比較
109
+
110
+ | 機能 | SHIDEN (v0.3.0) | TENJIN MCP |
111
+ |------|-----------------|------------|
112
+ | セットアップ | `npx shiden init` | Docker + Neo4j + ChromaDB |
113
+ | 依存関係 | **なし** | Neo4j, ChromaDB, Ollama |
114
+ | 理論数 | 175 | 175+ |
115
+ | 検索方式 | FTS5 trigram | ベクトル検索 + GraphRAG |
116
+ | オフライン | ✅ | ❌ |
117
+ | 推薦機能 | ❌ | ✅(LLM利用) |
118
+ | 深層分析 | ❌ | ✅(LLM利用) |
119
+
120
+ **推奨**:
121
+ - **教育者・素早く始めたい方**: SHIDEN のみ
122
+ - **高度な推薦・分析が必要な方**: SHIDEN + TENJIN
57
123
 
58
124
  ### 連携される理論の例
59
125
 
@@ -69,6 +135,8 @@ SHIDENは[TENJIN](https://github.com/nahisaho/tenjin)と連携し、教育理論
69
135
  ```
70
136
  your-project/
71
137
  ├── AGENTS.md # エントリーポイント
138
+ ├── .vscode/
139
+ │ └── mcp.json # TENJIN MCP設定
72
140
  ├── .github/
73
141
  │ ├── prompts/ # スキル定義
74
142
  │ │ ├── meta-prompt.md # メタプロンプト生成
@@ -91,11 +159,12 @@ your-project/
91
159
  # Agent Skillsファイルをプロジェクトにコピー
92
160
  npx shiden init
93
161
 
94
- # 上書き確認なしで初期化
95
- npx shiden init --force
96
-
97
- # コピー対象のプレビュー(実行なし)
98
- npx shiden init --dry-run
162
+ # 教育理論CLI
163
+ npx shiden theories categories # カテゴリ一覧
164
+ npx shiden theories search "キーワード" # 検索
165
+ npx shiden theories get <id> # 詳細取得
166
+ npx shiden theories list # 一覧
167
+ npx shiden theories related <id> # 関連理論
99
168
 
100
169
  # バージョン表示
101
170
  npx shiden -v
@@ -110,7 +179,6 @@ npx shiden -h
110
179
 
111
180
  - Node.js >= 20.0.0
112
181
  - VS Code + GitHub Copilot拡張機能
113
- - (推奨)TENJIN MCP Server(教育理論連携用)
114
182
 
115
183
  ## 📄 ライセンス
116
184