shiden 0.5.2 → 0.6.0

package/AGENTS.md

@@ -143,6 +143,7 @@ npx shiden curriculum grade "第3学年"
 | オーケストレーション | `orchestrator.md` | スキル選択・連携制御 |
 | 理論検索 | `theory-lookup.md` | 内蔵教育理論データベース連携 |
 | コンテキスト管理 | `context-manager.md` | セッション情報保持 |
+| 設計プロセスログ | `design-process-log.md` | 授業設計の判断プロセス可視化・記録 |
 
 ## スキルルーティング
 
@@ -156,6 +157,7 @@ npx shiden curriculum grade "第3学年"
 | 個別指導, 配慮, 支援 | `individual.md` |
 | フィードバック, 振り返り, コメント | `feedback.md` |
 | 生活指導, 行動, 相談 | `guidance.md` |
+| 設計記録, プロセス可視化, 設計ログ, 判断記録 | `design-process-log.md` |
 
 ### 意図が不明な場合
 
@@ -169,6 +171,7 @@ npx shiden curriculum grade "第3学年"
 4. 👤 個別指導計画
 5. 💬 フィードバック・振り返り
 6. 🤝 生活指導案
+7. 📋 設計プロセスの記録・可視化
 
 番号または内容でお答えください。
 ```

package/package.json

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

package/templates/.github/skills/assets/design-log-template.md

@@ -0,0 +1,224 @@
+---
+date: {ISO-8601日付}
+artifact_type: design-log
+subject: {教科}
+topic: {単元/トピック名}
+grade: {学年}
+theories_used: [{採用理論のリスト}]
+theories_rejected: [{不採用理論のリスト}]
+---
+
+# 授業設計記録: {トピック名}
+
+> 本ドキュメントは、授業設計のプロセスを第三者が再現・検証可能な形式で記録したものです。
+
+---
+
+## 1. 設計概要
+
+### 1.1 学習目標
+
+**主目標**:
+{生徒を主語にした具体的な学習目標}
+
+**副目標**:
+- {副目標1}
+- {副目標2}
+
+### 1.2 対象学習者
+
+| 項目 | 内容 | 情報源 |
+|------|------|--------|
+| 学年 | {学年} | 確定 |
+| 人数 | {人数} | {確定/推測} |
+| 学習者の特性 | {特性の記述} | {確定/推測} |
+| 前提知識 | {前提となる知識} | {確定/推測} |
+
+### 1.3 制約条件
+
+| 項目 | 内容 | 情報源 | 設計への影響 |
+|------|------|--------|-------------|
+| 時間 | {授業時間} | {確定/推測} | {時間制約がどう設計に影響するか} |
+| 環境 | {教室環境} | {確定/推測} | {環境がどう設計に影響するか} |
+| リソース | {使用可能リソース} | {確定/推測} | {リソースがどう設計に影響するか} |
+
+---
+
+## 2. 学習指導要領との関連
+
+> ⚠️ 小中高の授業設計では必須セクション
+
+### 検索コマンド
+
+```bash
+npx shiden curriculum search "{検索キーワード}"
+npx shiden curriculum subject {教科}
+```
+
+### 参照箇所
+
+**学校種**: {小学校/中学校/高等学校}学習指導要領  
+**章・節**: 第{章}章 第{節}節 {教科}  
+**学年**: {対象学年}
+
+**目標**:
+> 「{学習指導要領の目標を引用}」
+
+**内容**:
+> 「{当該単元の内容を引用}」
+
+**本設計との対応**:
+{本授業設計が学習指導要領のどの部分にどう対応するかの説明}
+
+---
+
+## 3. 参照した理論・モデルの採否一覧
+
+### 3.1 採用した理論
+
+| # | 理論・モデル名 | 適用箇所 | 採用理由 |
+|---|---------------|---------|---------|
+| 1 | {理論名1} | {展開部、導入など} | {具体的な採用理由 — 省略禁止} |
+| 2 | {理論名2} | {どこに適用} | {具体的な採用理由 — 省略禁止} |
+| 3 | {理論名3} | {どこに適用} | {具体的な採用理由 — 省略禁止} |
+
+### 3.2 検討したが不採用とした理論
+
+| # | 理論・モデル名 | 不採用理由 |
+|---|---------------|-----------|
+| 1 | {理論名A} | {具体的な不採用理由 — 「同様の理由」禁止} |
+| 2 | {理論名B} | {具体的な不採用理由 — 「同様の理由」禁止} |
+| 3 | {理論名C} | {具体的な不採用理由 — 「同様の理由」禁止} |
+
+---
+
+## 4. 設計判断ログ
+
+### Step 1: {決定項目名}
+
+**決定内容**:
+{何を決定したかを具体的に記述}
+
+**根拠・エビデンス**:
+{なぜその判断をしたか — 理論、研究、経験則、制約条件など}
+
+**却下した選択肢**:
+
+| 選択肢 | 却下理由 |
+|--------|---------|
+| {選択肢A} | {具体的な却下理由} |
+| {選択肢B} | {具体的な却下理由} |
+
+---
+
+### Step 2: {決定項目名}
+
+**決定内容**:
+{何を決定したかを具体的に記述}
+
+**根拠・エビデンス**:
+{なぜその判断をしたか}
+
+**却下した選択肢**:
+
+| 選択肢 | 却下理由 |
+|--------|---------|
+| {選択肢A} | {具体的な却下理由} |
+| {選択肢B} | {具体的な却下理由} |
+
+---
+
+### Step 3: {決定項目名}
+
+**決定内容**:
+{何を決定したかを具体的に記述}
+
+**根拠・エビデンス**:
+{なぜその判断をしたか}
+
+**却下した選択肢**:
+
+| 選択肢 | 却下理由 |
+|--------|---------|
+| {選択肢A} | {具体的な却下理由} |
+| {選択肢B} | {具体的な却下理由} |
+
+---
+
+## 5. 設計フロー図
+
+### 5.1 学習フロー
+
+```mermaid
+flowchart TD
+    A[導入: {導入内容}] --> B[展開1: {展開1内容}]
+    B --> C[展開2: {展開2内容}]
+    C --> D[まとめ: {まとめ内容}]
+    
+    A -.-> |理論: {適用理論}| A
+    B -.-> |理論: {適用理論}| B
+    C -.-> |理論: {適用理論}| C
+```
+
+### 5.2 設計判断フロー（該当する場合のみ）
+
+```mermaid
+stateDiagram-v2
+    [*] --> 条件整理
+    条件整理 --> 理論選定
+    理論選定 --> 構造設計
+    構造設計 --> 活動設計
+    活動設計 --> 評価設計
+    評価設計 --> 品質確認
+    品質確認 --> [*]
+```
+
+---
+
+## 6. 品質チェック
+
+### 6.1 完了チェックリスト
+
+| # | チェック項目 | 状態 |
+|---|-------------|------|
+| 1 | 全ての判断に根拠が記載されている | [ ] |
+| 2 | 採用理論と不採用理論の両方が記録されている | [ ] |
+| 3 | 推測と確定情報が区別されている | [ ] |
+| 4 | 省略表現（「詳細は省略」「同様の理由で」）がない | [ ] |
+| 5 | 学習指導要領の参照が含まれている（小中高の場合） | [ ] |
+| 6 | 複雑なフローには Mermaid 図が挿入されている | [ ] |
+| 7 | 却下した選択肢とその理由が全ステップで記載されている | [ ] |
+
+### 6.2 省略表現チェック
+
+以下の表現が含まれている場合、個別記述に展開すること:
+- 「詳細は省略」
+- 「同様の理由で」
+- 「前述の通り」
+- 「上記参照」
+
+---
+
+## 7. 付録
+
+### 7.1 使用した SHIDEN コマンド
+
+```bash
+# 学習指導要領検索
+npx shiden curriculum search "{検索語}"
+npx shiden curriculum subject {教科}
+
+# 教育理論検索
+npx shiden theories search "{検索語}"
+npx shiden theories get {theory-id}
+npx shiden theories related {theory-id}
+```
+
+### 7.2 参考文献
+
+- {参考文献1}
+- {参考文献2}
+
+---
+
+*本ドキュメントは SHIDEN design-process-log スキルにより生成されました。*

package/templates/.github/skills/design-process-log.md

@@ -0,0 +1,302 @@
+---
+name: design-process-log
+description: >
+  授業設計（Instructional Design）のプロセスを第三者が再現・検証可能なレベルで記録し、
+  設計判断ログを `instructional_design_log.md` に可視化・保存する。
+  Use when documenting lesson design decisions, visualizing theory selection rationale,
+  creating reproducible instructional design records, or generating Mermaid-based
+  design flow diagrams.
+metadata:
+  author: coreclaw
+  version: "1.0"
+---
+
+# Design Process Log
+
+授業設計のプロセス全体を、再現・検証可能な形式で詳細に記録するスキル。
+
+## Use This Skill When
+
+- 授業設計の判断プロセスを記録・可視化したい
+- 理論・モデルの採否を根拠とともに残したい
+- 設計判断を後から振り返り・検証したい
+- 複雑な設計フローをMermaid図で可視化したい
+
+## 役割定義
+
+このスキルを実行するAIは**授業設計（Instructional Design）の専門家**として振る舞う。  
+設計プロセスは、第三者が**再現・検証できるレベル**で詳細に記録すること。
+
+---
+
+## Workflow
+
+### Phase 1: 設計条件の整理
+
+1. **確定情報の抽出**
+   - 学習目標 / 対象学習者 / 時間・環境・リソース制約
+   - 明示的に指定された内容のみを「確定」として記録
+
+2. **推測情報の明示**
+   - ユーザーが明示していないが推測した情報を「推測」セクションに分離
+   - 必ず「〜と推測」「検討中: 〇〇」と表記
+
+3. **不足情報の確認**（省略可能な場合のみスキップ）
+   - 最低限必要: 対象学習者、学習目標、時間制約
+
+### Phase 2: 学習指導要領の参照
+
+> ⚠️ 小中高の授業設計では**必須ステップ**
+
+```bash
+npx shiden curriculum search "<単元・キーワード>"
+npx shiden curriculum subject <教科>
+```
+
+- 検索コマンドと結果IDを記録に含める
+- 該当する目標・内容を「確定情報」として追記
+
+### Phase 3: 教育理論の検索・採否決定
+
+```bash
+npx shiden theories search "<キーワード>"
+npx shiden theories categories
+npx shiden theories get <theory-id>
+```
+
+#### 採否判断の記録ルール
+
+| 区分 | 記録内容 |
+|------|---------|
+| **採用理論** | 理論名 / どこに適用 / 採用理由（具体的） |
+| **不採用理論** | 理論名 / 不採用理由（具体的） |
+
+> ❌ 「同様の理由で採用」「詳細は省略」などの省略表現は**禁止**
+
+### Phase 4: 設計判断ログの作成
+
+各設計ステップで以下の3項目を**必ず**記録:
+
+1. **決定内容** — 何を決定したか
+2. **根拠・エビデンス** — なぜその判断をしたか
+3. **却下した選択肢と理由** — 他に何を検討し、なぜ採用しなかったか
+
+### Phase 5: Mermaid図の挿入（必要時）
+
+以下の条件に該当する場合、適切な箇所にMermaid図を挿入:
+
+- 学習フローが複雑（3段階以上の分岐）
+- フェーズ遷移が複数存在
+- モジュール間の依存関係がある
+- 意思決定ツリーが必要
+
+#### Mermaid図の種類選択ガイド
+
+| 用途 | 図の種類 | コード例 |
+|------|---------|---------|
+| 学習フロー | flowchart TD | `A[導入] --> B[展開] --> C[まとめ]` |
+| フェーズ遷移 | stateDiagram-v2 | `[*] --> 導入 --> 展開` |
+| 時間軸 | timeline | `title 授業フロー` |
+| 概念関係 | mindmap | `root((中心概念))` |
+
+### Phase 6: ファイル出力
+
+成果物を `instructional_design_log.md` として保存:
+- ファイル名形式: `instructional_design_log.md` または `SHIDEN_design-log_{日付}_{トピック}.md`
+- YAML frontmatter を含める
+
+---
+
+## Deliverables
+
+### 出力ファイル構造
+
+```markdown
+---
+date: {生成日}
+artifact_type: design-log
+subject: {教科}
+topic: {単元名}
+theories_used: [{採用理論リスト}]
+---
+
+# 授業設計記録: {トピック名}
+
+## 1. 設計概要
+
+### 1.1 学習目標
+{具体的な学習目標}
+
+### 1.2 対象学習者
+- 学年: {学年}
+- 人数: {人数}（推測の場合は明記）
+- 特性: {学習者の特性}
+
+### 1.3 制約条件
+| 項目 | 内容 | 情報源 |
+|------|------|--------|
+| 時間 | {時間} | {確定/推測} |
+| 環境 | {環境} | {確定/推測} |
+| リソース | {リソース} | {確定/推測} |
+
+---
+
+## 2. 参照した理論・モデルの採否一覧
+
+### 2.1 採用した理論
+
+| 理論・モデル名 | 適用箇所 | 採用理由 |
+|---------------|---------|---------|
+| {理論名} | {どこに適用} | {具体的な採用理由} |
+
+### 2.2 検討したが不採用とした理論
+
+| 理論・モデル名 | 不採用理由 |
+|---------------|-----------|
+| {理論名} | {具体的な不採用理由} |
+
+---
+
+## 3. 設計判断ログ
+
+### Step 1: {決定項目名}
+
+**決定内容**:
+{何を決定したか}
+
+**根拠・エビデンス**:
+{なぜその判断をしたか — 理論、経験則、制約条件など}
+
+**却下した選択肢**:
+| 選択肢 | 却下理由 |
+|--------|---------|
+| {選択肢A} | {具体的な却下理由} |
+| {選択肢B} | {具体的な却下理由} |
+
+### Step 2: {決定項目名}
+...
+
+---
+
+## 4. 設計フロー図
+
+{Mermaid図を挿入}
+
+---
+
+## 5. 品質チェック
+
+- [ ] 全ての判断に根拠が記載されている
+- [ ] 採用理論と不採用理論の両方が記録されている
+- [ ] 推測と確定情報が区別されている
+- [ ] 省略表現（「詳細は省略」「同様の理由で」）がない
+- [ ] 学習指導要領の参照が含まれている（小中高の場合）
+```
+
+---
+
+## Quality Gates
+
+出力完了前に以下を**必ず**確認:
+
+| # | チェック項目 | 合格基準 |
+|---|-------------|---------|
+| 1 | 判断根拠の完全性 | 全ステップに「根拠」が記載されている |
+| 2 | 理論採否の記録 | 採用・不採用の両方に理由が明示されている |
+| 3 | 情報源の明示 | 確定/推測が区別されている |
+| 4 | 省略禁止の遵守 | 「詳細は省略」「同様の理由で」がない |
+| 5 | 学習指導要領参照 | 小中高の場合、参照箇所が明記されている |
+| 6 | Mermaid図の適切性 | 複雑なフローには図が挿入されている |
+
+### 失敗時のリカバリ
+
+| 失敗パターン | リカバリアクション |
+|-------------|------------------|
+| 理由が「同様」「省略」 | 各項目を個別に再記述 |
+| 不採用理論の記録漏れ | 検討した理論を遡って追記 |
+| 確定/推測の混同 | 情報源カラムを追加して再整理 |
+| Mermaid構文エラー | コードブロックを修正し再描画 |
+
+---
+
+## Gotchas
+
+### 1. 「不採用理由」の記録漏れ
+**問題**: 採用した理論だけ記録し、検討したが不採用にした理論を忘れる  
+**対策**: Phase 3で検索した理論を**すべて**テーブルに列挙し、採否を埋める
+
+### 2. 省略表現の無意識な使用
+**問題**: 「同様の理由で」「詳細は省略」と書いてしまう  
+**対策**: 品質チェックで「省略」「同様」をgrepし、該当箇所を個別記述に展開
+
+### 3. 推測を確定として記載
+**問題**: ユーザーが明示していない情報を確定として扱う  
+**対策**: 情報源カラム（確定/推測）を設け、推測には「〜と推測」を明記
+
+### 4. Mermaid図の過剰挿入
+**問題**: 不要な箇所にも図を入れ、可読性が低下  
+**対策**: 「分岐3つ以上」「フェーズ遷移複数」の基準で挿入判断
+
+### 5. 学習指導要領の参照漏れ
+**問題**: 小中高の授業設計で学習指導要領を検索・引用しない  
+**対策**: Phase 2を**必須ステップ**として実行、検索コマンドを記録に含める
+
+---
+
+## Validation Loop
+
+```
+┌─────────────────────────────────────────────────┐
+│  1. 設計ログ生成                                 │
+├─────────────────────────────────────────────────┤
+│  2. Quality Gates チェック                       │
+│     └─ 1つでも ❌ → 該当箇所を修正して再チェック  │
+├─────────────────────────────────────────────────┤
+│  3. 省略表現の検出                               │
+│     grep: "省略" "同様の理由" "詳細は"            │
+│     └─ 検出あり → 個別記述に展開                 │
+├─────────────────────────────────────────────────┤
+│  4. 不採用理論のカウント                         │
+│     └─ 0件 → 検討した理論を遡って追記            │
+├─────────────────────────────────────────────────┤
+│  5. ファイル保存                                 │
+│     └─ 成功 → 完了                              │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+## 禁止事項
+
+- ❌ 「詳細は省略」「同様の理由で」などの省略表現の使用
+- ❌ 採用理論のみの記録（不採用理論とその理由も必須）
+- ❌ 推測を確定として記載（情報源を必ず明示）
+- ❌ 設計判断の根拠を省略
+- ❌ 小中高対象で学習指導要領を参照しない
+
+---
+
+## Integration with Other Skills
+
+### lesson-plan.md との連携
+
+授業計画生成後、本スキルを呼び出して設計プロセスを記録:
+
+```
+1. lesson-plan.md で授業計画を生成
+2. design-process-log.md で設計判断を記録
+3. 両方をユーザーに提示（成果物 → プロセスログの順）
+```
+
+### theory-lookup.md との連携
+
+理論検索結果を本スキルの採否テーブルに統合:
+
+```bash
+# 検索実行
+npx shiden theories search "動機づけ"
+
+# 結果をdesign-process-logの表に記録
+| ARCS Model | 導入・まとめ | 注意維持と達成感の設計に適合 |
+| Self-Determination Theory | - | 本単元の短時間設計には具体性不足 |
+```