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.
- package/.github/skills/theory-lookup.md +215 -210
- package/README.md +78 -10
- package/dist/cli/commands/theories.js +191 -0
- package/dist/cli/commands/theories.js.map +1 -0
- package/dist/cli/index.js +30 -59
- package/dist/cli/index.js.map +1 -1
- package/dist/theories/TheoryRepository.js +169 -0
- package/dist/theories/TheoryRepository.js.map +1 -0
- package/dist/theories/TheoryService.js +102 -0
- package/dist/theories/TheoryService.js.map +1 -0
- package/dist/theories/database.js +62 -0
- package/dist/theories/database.js.map +1 -0
- package/dist/theories/index.js +10 -0
- package/dist/theories/index.js.map +1 -0
- package/dist/theories/types.js +7 -0
- package/dist/theories/types.js.map +1 -0
- package/dist/types/cli/commands/theories.d.ts +12 -0
- package/dist/types/cli/commands/theories.d.ts.map +1 -0
- package/dist/types/theories/TheoryRepository.d.ts +52 -0
- package/dist/types/theories/TheoryRepository.d.ts.map +1 -0
- package/dist/types/theories/TheoryService.d.ts +48 -0
- package/dist/types/theories/TheoryService.d.ts.map +1 -0
- package/dist/types/theories/database.d.ts +20 -0
- package/dist/types/theories/database.d.ts.map +1 -0
- package/dist/types/theories/index.d.ts +8 -0
- package/dist/types/theories/index.d.ts.map +1 -0
- package/dist/types/theories/types.d.ts +132 -0
- package/dist/types/theories/types.d.ts.map +1 -0
- package/package.json +10 -3
- package/src/data/relations.json +464 -0
- package/src/data/theories.db +0 -0
- package/src/data/theories.db-shm +0 -0
- package/src/data/theories.db-wal +0 -0
- package/src/data/theories.json +6063 -0
- package/templates/.github/prompts/assessment.md +25 -11
- package/templates/.github/prompts/feedback.md +26 -11
- package/templates/.github/prompts/guidance.md +27 -13
- package/templates/.github/prompts/individual.md +28 -16
- package/templates/.github/prompts/lesson-plan.md +26 -18
- package/templates/.github/prompts/materials.md +25 -9
- package/templates/.github/prompts/meta-prompt.md +8 -1
- package/templates/.github/skills/context-manager.md +2 -2
- package/templates/.github/skills/orchestrator.md +14 -6
- package/templates/.github/skills/theory-lookup.md +215 -210
- package/templates/.vscode/mcp.json +35 -0
|
@@ -1,283 +1,288 @@
|
|
|
1
|
-
# 理論検索スキル(
|
|
1
|
+
# 理論検索スキル(SHIDEN SQLite統合)
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> SHIDEN内蔵のSQLite教育理論データベースから175+の教育理論を検索・取得・引用します。
|
|
4
4
|
|
|
5
5
|
## 概要
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
このスキルは、SHIDENに内蔵された175件の教育理論を検索・取得するための機能を提供します。FTS5 trigramによる日本語全文検索とWITH RECURSIVE CTEによるグラフ走査をサポートします。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
**v0.3.0の重要な変更**: TENJINのDocker依存を排除し、SQLiteデータベースを直接パッケージに同梱。`npx shiden init` だけでセットアップが完了します。
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
## CLI コマンド
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
VS Codeの設定でMCPサーバーとして登録されている必要があります。
|
|
13
|
+
### 基本的な使い方
|
|
15
14
|
|
|
16
|
-
|
|
15
|
+
```bash
|
|
16
|
+
# カテゴリ一覧を表示
|
|
17
|
+
npx shiden theories categories
|
|
17
18
|
|
|
18
|
-
|
|
19
|
+
# 理論を検索(FTS5 trigram - 3文字以上推奨)
|
|
20
|
+
npx shiden theories search "社会的構成主義"
|
|
21
|
+
npx shiden theories search "constructivism"
|
|
19
22
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
```
|
|
23
|
-
- **用途**: キーワードで教育理論を検索
|
|
24
|
-
- **パラメータ**:
|
|
25
|
-
- `query`: 検索キーワード(必須)
|
|
26
|
-
- `category`: カテゴリフィルタ(任意)
|
|
27
|
-
- `limit`: 結果数上限(任意、デフォルト: 5)
|
|
28
|
-
- **戻り値**: 理論リスト(ID、名前、概要、関連度スコア)
|
|
23
|
+
# 理論の詳細を取得
|
|
24
|
+
npx shiden theories get theory-003
|
|
29
25
|
|
|
30
|
-
|
|
31
|
-
|
|
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
|
-
|
|
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
|
-
|
|
68
|
-
```
|
|
69
|
-
- **用途**: 指定理論と組み合わせると効果的な理論を推薦
|
|
70
|
-
- **パラメータ**:
|
|
71
|
-
- `theory_id`: 基準となる理論ID
|
|
72
|
-
- **戻り値**: 補完的な理論リスト
|
|
39
|
+
```bash
|
|
40
|
+
$ npx shiden theories categories
|
|
73
41
|
|
|
74
|
-
|
|
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
|
-
|
|
61
|
+
**オプション**:
|
|
62
|
+
- `-c, --category <category>`: カテゴリでフィルタ
|
|
63
|
+
- `-l, --limit <number>`: 表示件数(デフォルト: 10)
|
|
64
|
+
- `-v, --verbose`: 詳細表示
|
|
103
65
|
|
|
104
|
-
```
|
|
105
|
-
|
|
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
|
-
|
|
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
|
-
|
|
150
|
-
|
|
151
|
-
|
|
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
|
-
|
|
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
|
-
|
|
168
|
-
|
|
169
|
-
|
|
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
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
| `kohlbergs_moral_development` | 道徳性発達 | Lawrence Kohlberg | 道徳教育 |
|
|
112
|
+
限界・制約:
|
|
113
|
+
✗ Complexity in measurement
|
|
114
|
+
✗ Cultural variations
|
|
115
|
+
```
|
|
180
116
|
|
|
181
|
-
|
|
117
|
+
#### `theories list`
|
|
182
118
|
|
|
183
|
-
|
|
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
|
-
|
|
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
|
-
|
|
205
|
-
この活動は**Vygotsky**の**最近接発達領域(ZPD)**理論に基づいています。
|
|
206
|
-
生徒が一人では難しいが、適切な支援があればできるレベルの課題を設定しました。
|
|
207
|
-
```
|
|
139
|
+
WITH RECURSIVE CTEによるグラフ走査で関連理論を取得します。
|
|
208
140
|
|
|
209
|
-
|
|
141
|
+
**オプション**:
|
|
142
|
+
- `-d, --depth <number>`: 走査深さ 1-3(デフォルト: 2)
|
|
210
143
|
|
|
211
|
-
```
|
|
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
|
-
|
|
219
|
-
|
|
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
|
-
|
|
159
|
+
TypeScript/JavaScriptからも直接利用可能です:
|
|
226
160
|
|
|
227
|
-
```
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
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
|
-
|
|
242
|
-
|
|
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
|
-
|
|
246
|
+
- **フォーマット**: SQLite 3(better-sqlite3使用)
|
|
247
|
+
- **サイズ**: 約1.5MB
|
|
248
|
+
- **理論数**: 175件
|
|
249
|
+
- **関係数**: 77件
|
|
250
|
+
- **FTS5インデックス**: trigram tokenizer(日本語対応)
|
|
251
|
+
- **データソース**: TENJIN Neo4jデータベースからエクスポート
|
|
250
252
|
|
|
251
|
-
|
|
252
|
-
- 学習目標の明確化
|
|
253
|
-
- 段階的な難易度設定
|
|
254
|
-
- フィードバックの提供
|
|
253
|
+
## TENJIN MCP Server との比較
|
|
255
254
|
|
|
256
|
-
|
|
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
|
-
|
|
260
|
-
|
|
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
|
-
|
|
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
|
[](https://opensource.org/licenses/MIT)
|
|
5
5
|
|
|
6
6
|
**SHIDEN**(紫電)は、教育者のためのGitHub Copilot Agent Skillsパッケージです。
|
|
7
|
-
|
|
7
|
+
**175件の教育理論を内蔵**し、エビデンスベースの教育コンテンツ作成を支援します。
|
|
8
8
|
|
|
9
9
|
## ✨ 特徴
|
|
10
10
|
|
|
11
11
|
- 🎯 **6つのユースケーススキル** - 授業計画、教材、評価、個別指導、フィードバック、生活指導
|
|
12
12
|
- 🧠 **メタプロンプト生成** - 曖昧なリクエストを構造化し、最適なコンテンツを生成
|
|
13
|
-
- 📚 **
|
|
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
|
|
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
|
|
96
|
-
|
|
97
|
-
#
|
|
98
|
-
npx shiden
|
|
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
|
|