shiden 0.4.2 → 0.5.0

package/.github/prompts/references/common-curriculum.md

@@ -0,0 +1,32 @@
+# Common Curriculum Reference
+
+日本の小学校・中学校・高等学校を対象とする成果物では、学習指導要領の参照を必須とする。
+
+## 参照が必須のケース
+
+- 授業計画、教材、評価設計、個別支援計画で学年と教科が日本の学校制度に属する場合。
+
+## 推奨コマンド
+
+```bash
+npx shiden curriculum subject {教科名}
+npx shiden curriculum search "{単元名またはキーワード}"
+npx shiden curriculum grade "{学年}"
+```
+
+## 出力へ入れる最小要件
+
+```markdown
+### 学習指導要領との関連
+
+**参照箇所**: {school_level}学習指導要領 {section}
+**目標**: 「{goal_quote}」
+**内容**: 「{content_quote}」
+**本成果物との対応**: {alignment_note}
+```
+
+## 判断ルール
+
+- 大学、研修、企業教育は原則として必須参照対象外。
+- 対象が曖昧なら、学習指導要領参照の要否を明示して確認する。
+- 参照箇所が見つからない場合は、無理に引用を捏造せず「要追加確認」とする。

package/.github/prompts/references/common-safety.md

@@ -0,0 +1,22 @@
+# Common Safety Reference
+
+危機対応やセンシティブ案件では、通常の教育支援フローより安全性を優先する。
+
+## 高リスクの例
+
+- 自傷、自殺念慮、自殺示唆
+- いじめ、虐待、ネグレクト
+- 暴力、触法、重大なハラスメント
+- 医療や心理の緊急支援が疑われる状態
+
+## 必須の扱い
+
+- AI提案は参考情報であり、専門家の判断に代わらないと明示する。
+- 校内の管理職、養護教諭、スクールカウンセラー等への連携を省略しない。
+- 事実未確認の内容は断定しない。
+
+## 推奨文言
+
+```markdown
+⚠️ 重要: この状況については、スクールカウンセラー、管理職、または専門機関への相談を強くお勧めします。AIの提案は参考情報であり、専門家の判断に代わるものではありません。
+```

package/.github/prompts/references/common-theory-selection.md

@@ -0,0 +1,27 @@
+# Common Theory Selection Reference
+
+成果物タイプごとに、優先度の高い教育理論を絞って適用する。
+
+## 推奨の当て方
+
+| 成果物 | 優先理論 | 主な用途 |
+|--------|----------|----------|
+| lesson-plan | Bloom's Taxonomy, Gagné, Constructive Alignment | 目標、展開、評価の整合 |
+| materials | Gagné, ARCS, UDL | 注意喚起、練習、アクセス性 |
+| assessment | Constructive Alignment, Bloom's Taxonomy | 観点設計、認知レベル配分 |
+| individual | ZPD, Scaffolding, UDL | 個別支援、足場かけ |
+| feedback | Growth Mindset, Attribution Theory | 声かけ、振り返り |
+| guidance | 発達理論、PBIS, キャリア理論 | 行動支援、進路面談 |
+
+## 理論引用の書き方
+
+- 理論名だけで終わらせず、「何の判断に使ったか」を1文で書く。
+- 2〜3件に絞り、配置箇所を明示する。
+- 検索結果にない理論を断定的に引用しない。
+
+## 例
+
+```markdown
+- Bloom's Taxonomy: 本時目標を「応用」レベルで定義するために採用。
+- ARCS Model: 導入で注意喚起し、振り返りで満足感を補強するために採用。
+```

package/.github/skills/context-manager.md

@@ -1,324 +1,63 @@
-# コンテキスト管理スキル
+---
+name: context-manager
+description: >
+  Preserve structured SHIDEN session context and hand off prior outputs between
+  prompts safely. Use when a later prompt must reuse a previous artifact, when
+  session defaults matter, or when generated outputs need consistent carry-over.
+metadata:
+  author: nahisaho
+  version: "0.5.0"
+---
 
-> セッション内の情報を保持し、スキル間のデータ受け渡しを管理します。
+# Context Manager
 
-## 概要
+セッション内で確定した条件と生成済み成果物を再利用可能な形で保持する。
 
-このスキルは、SHIDENのセッション全体を通じてコンテキスト（文脈情報）を管理します。会話履歴、前回のスキル実行結果、ユーザー設定などを保持し、スキル間の連携を円滑にします。
+## Use This Skill When
 
-## 主な機能
+- 直前の授業計画を基に教材や評価を作る。
+- 学年、教科、単元などの既知条件を再入力させたくない。
+- 生成済み成果物の観点や目標を次工程へ渡したい。
 
-### 1. セッションコンテキストの保持
+## Workflow
 
-会話セッション中に以下の情報を保持します：
+1. 会話から確定情報と未確定情報を分ける。
+2. 学年、教科、単元、目標、配慮事項、成果物IDを構造化して保存する。
+3. 後続promptが参照するときは、必要最小限の要素だけ引き渡す。
+4. 古い条件と新しい条件が競合したら、最新の明示入力を優先する。
+5. セッション要約が必要なら、再利用価値の高い成果物だけを列挙する。
+6. 各promptで生成されたプロセスログのファイルパスも保持し、後続参照に使う。
 
-- **会話履歴**: ユーザーとの対話履歴
-- **スキル実行結果**: 各スキルが生成したコンテンツ
-- **メタプロンプト**: 収集したコンテキスト情報
-- **TENJIN検索結果**: 参照した教育理論
-- **ユーザー設定**: デフォルトの学年・教科など
+## Conditional References
 
-### 2. コンテキスト操作
+- Read references/session-schema.md when you need the canonical context keys or handoff shape.
 
-#### remember（記憶）
+## Quality Gates
 
-情報をセッションコンテキストに保存します。
+- [ ] 確定情報と推測情報を混同していない。
+- [ ] 後続promptに不要な情報を渡していない。
+- [ ] 最新のユーザー指定が古い保存値に勝っている。
+- [ ] 参照対象の成果物種別が識別できる。
+- [ ] プロセスログのファイルパスが保持されている。
 
-```
-remember(key, value, metadata?)
-```
+## Data Handling & Safety
 
-**使用例**:
-```
-remember("last_lesson_plan", {
-  subject: "数学",
-  grade: "中学2年",
-  topic: "一次関数",
-  content: "...",
-  theories: ["blooms_taxonomy", "gagnes_nine_events"]
-}, {
-  timestamp: "2026-01-21T10:30:00",
-  skill: "lesson-plan"
-})
-```
+- 保存するのは再利用に必要な条件のみとし、個人情報の持ち越しを最小化する。
+- センシティブ案件では、匿名化した要約だけを保持する。
+- 古い危機案件の文脈を新しい通常案件へ自動流用しない。
 
-#### recall（想起）
+## Gotchas
 
-保存された情報を取得します。
+- 「前の内容を使って」が何を指すか曖昧なまま引き継ぐと、誤った成果物を参照しやすい。
+- 目標だけでなく評価観点も保持しないと、assessmentやfeedbackへの接続が弱くなる。
+- すべての会話ログを保持するより、再利用キーに正規化した方が後続promptの精度が上がる。
 
-```
-recall(key)
-recall(query, type?)
-```
+## Validation Loop
 
-**使用例**:
-```
-recall("last_lesson_plan")
-→ 直前の授業計画を取得
-
-recall("前の授業計画", "lesson-plan")
-→ 自然言語クエリで関連情報を検索
-```
-
-#### clear（クリア）
-
-コンテキストをクリアします。
-
-```
-clear(key?)
-clear() // 全クリア
-```
-
-**使用例**:
-```
-clear("last_lesson_plan")
-→ 特定のキーをクリア
-
-clear()
-→ セッション全体をクリア
-```
-
-#### summarize（要約）
-
-セッションの要約を生成します。
-
-```
-summarize()
-```
-
-**出力例**:
-```markdown
-## セッションサマリー
-
-### 実行したスキル
-1. **メタプロンプト生成** - 中学2年数学「一次関数」
-2. **授業計画作成** - 50分、第3時/10時
-3. **ワークシート作成** - 練習問題10問
-
-### 参照した理論
-- Bloom's Taxonomy（学習目標設定）
-- Gagné's Nine Events（授業構成）
-
-### 生成したコンテンツ
-- 授業計画 1件
-- ワークシート 1件
-```
-
-## スキル間データ受け渡し
-
-### パターン1: 授業計画 → 教材作成
-
-```
-[lesson-plan.md]
-1. 授業計画を生成
-2. context-manager に保存: remember("current_lesson_plan", plan)
-
-[materials.md]
-1. コンテキストを取得: recall("current_lesson_plan")
-2. 授業計画の内容に基づいてワークシートを生成
-3. 整合性を確保
-```
-
-### パターン2: 授業計画 → 評価設計
-
-```
-[lesson-plan.md]
-1. 授業計画（学習目標含む）を生成
-2. context-manager に保存
-
-[assessment.md]
-1. コンテキストから学習目標を取得
-2. 構成的整合性を確保した評価を設計
-3. 目標との対応関係を明示
-```
-
-### パターン3: 評価結果 → フィードバック
-
-```
-[assessment.md]
-1. ルーブリックを生成
-2. context-manager に保存
-
-[feedback.md]
-1. ルーブリックの評価観点を参照
-2. 観点に沿ったフィードバックを生成
-```
-
-## ユーザー参照パターン
-
-ユーザーが自然言語で前の成果物を参照する場合の対応：
-
-| ユーザー発話 | 解釈 | アクション |
-|-------------|------|-----------|
-| 「前の授業計画を基に」 | 直前の lesson-plan 出力 | recall("lesson-plan", latest=true) |
-| 「さっきのルーブリックを修正」 | 直前の assessment 出力 | recall("assessment", latest=true) |
-| 「同じ単元で教材を」 | 直前のメタプロンプトコンテキスト | recall("meta-prompt-context") |
-| 「今日作ったものの一覧」 | セッション全体 | summarize() |
-
-## コンテキスト構造
-
-### セッションコンテキストの内部構造
-
-```typescript
-interface SessionContext {
-  // セッション識別子
-  sessionId: string;
-  startTime: string;
-  
-  // ユーザー設定（デフォルト値）
-  userDefaults: {
-    grade?: string;      // デフォルト学年
-    subject?: string;    // デフォルト教科
-    language?: string;   // 使用言語
-  };
-  
-  // メタプロンプトコンテキスト
-  metaPromptContext: {
-    grade?: string;
-    subject?: string;
-    topic?: string;
-    learningObjective?: string;
-    duration?: number;
-    specialConsiderations?: string[];
-    collectedAnswers: {
-      question: string;
-      answer: string;
-      timestamp: string;
-    }[];
-  };
-  
-  // スキル実行履歴
-  skillHistory: {
-    skill: string;
-    timestamp: string;
-    input: object;
-    output: object;
-    theories: string[];
-  }[];
-  
-  // 生成コンテンツ
-  generatedContent: {
-    type: 'lesson-plan' | 'materials' | 'assessment' | 
-          'individual' | 'feedback' | 'guidance';
-    content: string;
-    metadata: object;
-    timestamp: string;
-  }[];
-  
-  // TENJIN検索結果キャッシュ
-  theoryCache: {
-    theoryId: string;
-    data: object;
-    timestamp: string;
-  }[];
-}
-```
-
-## マルチスキルオーケストレーション
-
-### 実行順序の最適化
-
-複合リクエスト時の実行順序を管理：
-
-```
-1. meta-prompt（コンテキスト収集）
-   ↓ コンテキストを保存
-2. lesson-plan（授業計画）
-   ↓ 授業計画を保存
-3. materials（教材）
-   ↓ 授業計画を参照しながら生成
-4. assessment（評価）
-   ↓ 目標・活動と整合性確保
-```
-
-### 依存関係の解決
-
-スキル間の依存関係を管理：
-
-| スキル | 依存先 | 依存内容 |
-|--------|--------|----------|
-| materials | lesson-plan | 授業の流れ、時間配分 |
-| assessment | lesson-plan | 学習目標、評価観点 |
-| feedback | assessment | 評価基準、観点 |
-| individual | assessment | 評価結果、課題 |
-
-### 整合性チェック
-
-スキル間の整合性を検証：
-
-```markdown
-## 整合性チェック結果
-
-✅ **学習目標の一貫性**
-- 授業計画の目標: {目標}
-- 評価の対象目標: {同一目標}
-- 結果: 一致
-
-✅ **認知レベルの整合性**
-- 目標レベル: 応用（Apply）
-- 評価レベル: 応用問題を含む
-- 結果: 整合
-
-⚠️ **時間配分の確認**
-- 授業計画: 50分
-- ワークシート所要時間: 60分（推定）
-- 結果: 調整を推奨
-```
-
-## 使用例
-
-### 例1: 連続したコンテンツ作成
-
-```
-ユーザー: 「中学2年の一次関数の授業計画を作成してください」
-
-[実行]
-1. meta-prompt でコンテキスト収集
-2. lesson-plan で授業計画生成
-3. context-manager に保存
-
-ユーザー: 「今の授業計画に合わせたワークシートも作って」
-
-[実行]
-1. context-manager から授業計画を recall
-2. materials で整合性のあるワークシート生成
-```
-
-### 例2: セッションのまとめ
-
-```
-ユーザー: 「今日作成したものを一覧で見せて」
-
-[実行]
-1. context-manager.summarize()
-2. 生成コンテンツの一覧を表示
-```
-
-### 例3: コンテキストの引き継ぎ
-
-```
-ユーザー: 「さっきと同じ学年・教科で、別の単元の授業計画を」
-
-[実行]
-1. recall("meta-prompt-context") で学年・教科を取得
-2. 新しい単元のみをヒアリング
-3. 既存コンテキストを活用して生成
-```
-
-## 注意事項
-
-### セッションの範囲
-
-- コンテキストは現在の会話セッション内でのみ有効
-- VS Codeを閉じるとリセットされます
-- 永続化が必要な場合はファイルに保存してください
-
-### プライバシー
-
-- 生徒の個人情報は保存しないでください
-- 機密性の高い情報は clear() でクリアしてください
-
-### 容量制限
-
-- 大量のコンテンツは要約して保存
-- 古いエントリは自動的に優先度が下がります
+1. 保存または再利用するコンテキストをまとめる。
+2. 確認する。
+   - 最新条件が反映されているか。
+   - 渡す情報が後続タスクに十分か。
+   - 不要な個人情報が混ざっていないか。
+3. 不合格なら、保持キーや参照対象を修正する。
+4. 妥当な引き継ぎ形に整えたら完了とする。

package/.github/skills/orchestrator.md

@@ -1,184 +1,73 @@
-# オーケストレーションスキル
+---
+name: orchestrator
+description: >
+  Route education requests to the correct SHIDEN prompt, detect multi-step flows,
+  and sequence supporting skills. Use when the request spans multiple artifact types,
+  the target prompt is unclear, or execution order must be coordinated.
+metadata:
+  author: nahisaho
+  version: "0.5.0"
+---
 
-> ユーザーのリクエストを分析し、適切なスキルにルーティングするオーケストレーターです。
+# Orchestrator
 
-## 概要
+SHIDENのprompt群と補助skill群を最小手順でつなぐ。
 
-このスキルは、SHIDENの中央制御として機能し、以下の役割を担います：
+## Use This Skill When
 
-1. **意図分析** - ユーザーリクエストの意図を特定
-2. **スキルルーティング** - 適切なスキルへの振り分け
-3. **マルチスキル連携** - 複合リクエストの分解と実行順序決定
-4. **フォールバック処理** - エラー時の代替アプローチ提案
+- 依頼が複数成果物にまたがる。
+- どのpromptを起動すべきか曖昧である。
+- 授業計画から教材、評価、フィードバックへ順番に展開したい。
 
-## 意図分析ロジック
+## Workflow
 
-### キーワードベースの意図検出
+1. 依頼の主目的を分類する。曖昧ならmeta-promptを優先する。
+2. 主要成果物を1つ選び、副次成果物があれば順序を決める。
+3. 小中高の成果物ではcurriculum参照を必須ステップとして差し込む。
+4. 理論根拠が必要な成果物ではtheory-lookupを併用する。
+5. 連続生成時はcontext-managerへ受け渡し対象を明示する。
+6. 各prompt実行時のプロセス（参照結果、理論選定、設計判断）が表示・保存されることを確認する。
 
-ユーザーのリクエストに含まれるキーワードを分析し、意図を特定します。
+## Routing Rules
 
-#### スキルルーティングテーブル
+- 授業計画、指導案、本時案 → lesson-plan
+- 教材、ワークシート、スライド、クイズ、配布資料 → materials
+- ルーブリック、テスト、採点基準、形成的評価 → assessment
+- 個別支援、合理的配慮、学習支援計画 → individual
+- コメント、振り返り、返却時の声かけ → feedback
+- 生活指導、保護者対応、危機対応、進路相談 → guidance
 
-| キーワード | スキル | 優先度 |
-|-----------|--------|--------|
-| 授業計画, 指導案, lesson plan, 単元計画 | `lesson-plan.md` | 高 |
-| 教材, ワークシート, スライド, クイズ, プリント, 配布資料 | `materials.md` | 高 |
-| 評価, ルーブリック, テスト, 採点基準, 成績 | `assessment.md` | 高 |
-| 個別指導, 配慮, 支援, 特別支援, 学習障害 | `individual.md` | 高 |
-| フィードバック, 振り返り, コメント, 添削 | `feedback.md` | 高 |
-| 生活指導, 行動, 相談, 問題行動, 保護者面談 | `guidance.md` | 高 |
+## Conditional References
 
-#### 複合キーワード判定
+- Read ../../AGENTS.md when suite-level routing or phase rules need confirmation.
+- Read references/session-schema.md when handing off structured context between prompts.
 
-複数のキーワードが含まれる場合の優先順位：
+## Quality Gates
 
-1. **明示的な動詞** を優先
-   - 「作成」「生成」→ 創作系スキル
-   - 「評価」「採点」→ 評価系スキル
-   - 「対応」「支援」→ 指導系スキル
+- [ ] 主成果物と副成果物の順序が妥当である。
+- [ ] 曖昧依頼でmeta-promptを飛ばしていない。
+- [ ] 小中高案件でcurriculum参照ステップを落としていない。
+- [ ] 危機案件を通常フローに混ぜていない。
+- [ ] 各promptのプロセスが表示・保存される構成になっている。
 
-2. **目的語** を次に考慮
-   - 「授業計画を評価」→ フィードバック（既存計画への評価）
-   - 「評価計画を作成」→ 評価設計（新規作成）
+## Data Handling & Safety
 
-### 意図不明時の確認フロー
+- 危機対応はguidanceを優先し、専門家連携を省略しない。
+- 同じ情報を複数promptに渡すときも、不要な個人情報は削る。
+- 実行順序が不明な場合は、直接生成より分類を優先する。
 
-キーワードから意図が特定できない場合：
+## Gotchas
 
-```
-🤔 どのような教育コンテンツを作成しますか？
+- lesson-planを作る前にmaterialsやassessmentを先行させると整合性が崩れやすい。
+- 曖昧依頼を即時に個別promptへ送ると、後続で条件不足が顕在化する。
+- guidance系の危機案件を通常のfeedbackやindividualに誤配すると安全性が落ちる。
 
-1. 📚 **授業計画・指導案** - 授業の流れ、学習活動の設計
-2. 📝 **教材** - ワークシート、スライド、クイズなど
-3. ✅ **評価** - ルーブリック、テスト問題、採点基準
-4. 👤 **個別指導計画** - 特定の学習者への対応策
-5. 💬 **フィードバック** - 学習成果へのコメント、振り返り支援
-6. 🤝 **生活指導案** - 行動面・生活面での指導計画
+## Validation Loop
 
-番号または内容でお答えください。
-```
-
-## マルチスキル連携
-
-### 複合リクエストの検出
-
-以下のパターンで複合リクエストを検出します：
-
-- 「○○と△△を作成」
-- 「○○した後に△△も」
-- 「○○に基づいて△△を」
-
-### 実行順序の決定
-
-複合リクエストの実行順序：
-
-```
-1. 授業計画 (lesson-plan)
-   ↓
-2. 教材 (materials)
-   ↓
-3. 評価 (assessment)
-   ↓
-4. フィードバック (feedback)
-```
-
-**理由**: 授業計画が他のスキルの基盤となるため、最初に実行。
-評価は授業計画・教材との整合性が必要なため、後で実行。
-
-### 連携例
-
-```
-ユーザー: 「一次関数の授業計画とワークシートを作成してください」
-
-処理:
-1. meta-prompt.md でコンテキスト収集
-2. lesson-plan.md で授業計画生成
-3. materials.md で授業計画に基づいたワークシート生成
-4. 両方の成果物を統合して提示
-```
-
-## フォールバック処理
-
-### スキル実行失敗時
-
-```
-申し訳ありません。{スキル名}の処理中にエラーが発生しました。
-
-代替アプローチとして、以下をご提案します：
-1. {代替案1}
-2. {代替案2}
-
-どちらで進めますか？または、別のリクエストをお聞かせください。
-```
-
-### TENJIN接続エラー時
-
-```
-📚 教育理論データベース（TENJIN）への接続に問題が発生しています。
-
-一般的な教授法を適用してコンテンツを生成しますが、
-特定の理論に基づいたエビデンスは含まれない場合があります。
-
-このまま続行しますか？
-```
-
-### 情報不足時
-
-```
-コンテンツを生成するために、もう少し情報が必要です。
-
-以下のいずれかをお試しください：
-1. より具体的なリクエストを入力
-2. 対象学年・教科を明記
-3. 期待する成果物の形式を指定
-
-例: 「中学2年生の数学で、一次関数のワークシートを作成してください」
-```
-
-## スキル間データ受け渡し
-
-### コンテキストの保持
-
-各スキル実行時に以下の情報を `context-manager.md` に保存：
-
-- 生成したコンテンツのID
-- 使用したメタプロンプト
-- 参照した教育理論
-- ユーザーのフィードバック
-
-### 参照パターン
-
-後続のスキルが前のスキルの成果を参照する場合：
-
-```
-「前の授業計画を基に」
-→ context-manager.md から直前の lesson-plan 出力を取得
-
-「さっきのルーブリックを修正して」
-→ context-manager.md から直前の assessment 出力を取得
-```
-
-## 出力テンプレート
-
-### スキル選択完了時
-
-```
-✅ リクエストを理解しました。
-
-**実行するスキル**: {スキル名}
-**処理内容**: {簡潔な説明}
-
-{スキル固有の処理を開始}
-```
-
-### マルチスキル実行開始時
-
-```
-✅ 複合リクエストを理解しました。
-
-**実行計画**:
-1. {スキル1} - {処理内容1}
-2. {スキル2} - {処理内容2}
-
-順番に処理を進めます。まず{スキル1}から始めます。
-```
+1. ルーティング案を決める。
+2. 確認する。
+  - 主要成果物が1つに定まっているか。
+  - 補助skillの必要性が明確か。
+  - 安全上の例外がないか。
+3. 不合格なら、分類か順序を修正して再判定する。
+4. 妥当な順序が決まったら実行へ進む。