shiden 0.4.3 → 0.5.0

package/.github/prompts/meta-prompt.md

@@ -1,225 +1,76 @@
-# メタプロンプト生成スキル
+---
+name: meta-prompt
+description: >
+  Structure ambiguous education requests into a validated prompt and run a
+  one-question-at-a-time intake flow. Use when the user's request is incomplete,
+  under-specified, or needs context collection before any education artifact is generated.
+metadata:
+  author: nahisaho
+  version: "0.5.0"
+---
 
-> ユーザーのリクエストを構造化し、質の高い教育コンテンツを生成するためのメタプロンプトを作成します。
+# Meta Prompt
 
-## 概要
+曖昧な依頼を、後続スキルに渡せる構造化プロンプトへ変換する。
 
-このスキルは、曖昧または不完全なリクエストを受け取り、以下のプロセスで最適化されたメタプロンプトを生成します：
+## Use This Prompt When
 
-1. プロンプト強化（暗黙の前提を明示化）
-2. 強化プロンプト確認（ユーザーへの確認）
-3. コンテキスト収集（1問1答形式）
-4. メタプロンプト生成
+- 学年、教科、単元、成果物形式のいずれかが欠けている。
+- ユーザーが「いい感じ」「わかりやすく」など主観語だけで依頼している。
+- 複数スキルにまたがる依頼を分解する前に、共通コンテキストが必要である。
 
-## Phase 1: プロンプト強化
+## Required Inputs
 
-ユーザーのリクエストを受け取ったら、以下の観点で分析・強化します：
+- 元のユーザー依頼。
+- すでに会話で判明している条件。
 
-### 分析観点
+## Workflow
 
-1. **曖昧な表現の特定**
-   - 「わかりやすい」「良い」などの主観的表現
-   - 具体的な基準が不明な表現
+1. 依頼を要約し、補った前提を明示して確認を取る。
+2. 不足情報がある場合だけ、質問を1回に1つずつ提示する。
+3. 5問以内で、学年・教科・トピック・目標・制約を優先収集する。
+4. 情報が十分にそろった時点で質問を打ち切り、構造化メタプロンプトを生成する。
+5. 後続スキルへ、確定情報と未確定情報を明示して引き継ぐ。
+6. 収集プロセス全体（質問意図、回答の解釈、判断理由）を表示し、成果物とともにファイルへ保存する。
 
-2. **暗黙の前提の明示化**
-   - 対象学年・教科の推測
-   - 想定される学習者像
-   - 期待される成果物の形式
+## Conditional References
 
-3. **欠落要素の特定**
-   - 時間・リソースの制約
-   - 評価基準
-   - 特別な配慮事項
+- Reuse assets/meta-prompt-template.md when drafting the final intake summary.
+- Read references/common-safety.md when the request mentions self-harm, abuse, bullying, violence, or crisis response.
 
-### 出力形式
+## Deliverables
 
-```
-📝 あなたのリクエストを以下のように理解しました：
+- 確認済みの強化リクエスト。
+- 1問1答で収集した条件一覧。
+- 後続スキルがそのまま使えるメタプロンプト。
+- プロセスログ（各質問の意図、回答の解釈、後続スキル選定理由）。
 
-【元のリクエスト】
-{ユーザーの元のリクエスト}
+## Quality Gates
 
-【強化されたリクエスト】
-{構造化・明確化されたリクエスト}
+- [ ] 確認前に推測を事実扱いしていない。
+- [ ] 質問は常に1件のみで、回答待ちを挟んでいる。
+- [ ] 収集結果に「確定」「未確定」「推測」を分けている。
+- [ ] 後続スキル名または依頼カテゴリが特定できている。
+- [ ] プロセスが表示され、ファイルに保存されている。
 
-【補足した要素】
-- {暗黙の前提1}
-- {暗黙の前提2}
+## Data Handling & Safety
 
-👉 この理解で正しいですか？修正があればお知らせください。
-```
+- 生徒名、学校名、病名などの個人特定情報は必要最小限にとどめる。
+- 危機対応が含まれる場合は、AI提案が専門判断の代替にならないと明示する。
+- センシティブ情報が不要なら、役割名や匿名表現へ置き換える。
 
-## Phase 2: コンテキスト収集（1問1答）
+## Gotchas
 
-強化プロンプトが確認されたら、不足している情報を1問1答形式で収集します。
+- 1回の返答で複数質問を並べると、SHIDENの対話品質が落ちて後続スキルも不安定になる。
+- 「早く作って」と言われた場合は、追加質問を止めて推測箇所を明記したまま生成へ進む。
+- 収集を続ける目的は情報量の最大化ではなく、生成に必要な最小十分条件の確保である。
 
-### 🚨 絶対ルール（必ず遵守）
+## Validation Loop
 
-```
-⛔ 禁止: 複数の質問を一度に提示すること
-✅ 必須: 1つの質問を提示 → ユーザーの回答を待つ → 次の質問
-```
-
-**AIエージェントへの指示:**
-1. 質問は**必ず1つだけ**提示すること
-2. ユーザーが回答するまで**次の質問を提示してはならない**
-3. 回答を受け取ったら、次の質問へ進むか終了判定を行う
-4. 「スキップ」と言われたら次の質問へ
-5. **最大5問まで**（所要時間目安: 2-3分）
-
-### 質問フォーマット
-
-各質問は以下の形式で提示：
-```
-📌 [Q{番号}/5] {質問内容}
-（例: {具体例}）
-
-💡 スキップする場合は「スキップ」とお伝えください。
-```
-
-### 質問バンク
-
-以下の質問から、コンテキストに応じて適切なものを選択します：
-
-#### Q1: 学習目標に関する質問
-```
-📌 この授業/教材で、生徒に達成してほしい具体的な目標は何ですか？
-（例: 「一次関数のグラフを正確に描けるようになる」「実験結果を論理的に説明できる」）
-
-💡 スキップする場合は「スキップ」とお伝えください。
-```
-
-#### Q2: 学習者レベルに関する質問
-```
-📌 対象の学習者について教えてください：
-- 学年・年齢
-- この分野の習熟度（初学者/基礎あり/発展）
-- クラスの特徴（人数、雰囲気など）
-
-💡 スキップする場合は「スキップ」とお伝えください。
-```
-
-#### Q3: 配慮事項に関する質問
-```
-📌 特別な配慮が必要な点はありますか？
-（例: 学習支援が必要な生徒、言語的背景、興味関心の偏りなど）
-
-💡 特にない場合は「特になし」または「スキップ」とお伝えください。
-```
-
-#### Q4: 時間・リソースに関する質問
-```
-📌 時間やリソースの制約を教えてください：
-- 授業時間（例: 45分、50分、90分）
-- 使用可能な機材・教材
-- 準備にかけられる時間
-
-💡 スキップする場合は「スキップ」とお伝えください。
-```
-
-#### Q5: 評価・成功基準に関する質問
-```
-📌 この授業/教材が「成功した」と言えるのは、どんな状態ですか？
-（例: 「全員が基本問題を解ける」「生徒が質問を3つ以上する」）
-
-💡 スキップする場合は「スキップ」とお伝えください。
-```
-
-### 真の目的探索質問（オプション）
-
-リクエストの背景にある真の目的を探るため、以下の質問を適宜使用します：
-
-```
-🎯 もう少し深くお聞きしてもよいですか？
-
-「この単元で生徒にどのような変化を期待していますか？」
-
-単に知識を得るだけでなく、考え方や態度の変化があれば教えてください。
-```
-
-```
-🎯 最後に1つだけ確認させてください：
-
-「この授業の成功をどのように判断しますか？」
-
-テストの点数以外で、どんな変化が見られたら嬉しいですか？
-```
-
-## Phase 3: メタプロンプト生成
-
-収集した情報を基に、構造化されたメタプロンプトを生成します。
-
-### メタプロンプト構造
-
-```markdown
-## 教育コンテンツ生成メタプロンプト
-
-### 【コンテキスト】
-- **対象学年**: {学年}
-- **教科**: {教科}
-- **単元/トピック**: {単元名}
-- **授業時間**: {時間}分
-- **生徒状況**: {学習者の特徴、習熟度}
-- **特別な配慮**: {配慮事項}
-
-### 【学習目標】
-{Bloom's Taxonomyに基づいた具体的な学習目標}
-
-### 【参照すべき教育理論】
-以下の理論を教育理論データベースから検索し、適用を検討してください：
-
-```bash
-# 推奨される理論を検索
-npx shiden theories search "{検索キーワード}"
-npx shiden theories get {理論ID}
-```
-
-- {推奨理論1}（{適用場面}）
-- {推奨理論2}（{適用場面}）
-
-### 【出力要件】
-- **形式**: {求められる成果物の形式}
-- **構成**: {含めるべきセクション}
-- **分量**: {目安となる分量}
-
-### 【品質基準】
-- {品質基準1}
-- {品質基準2}
-- {品質基準3}
-
-### 【成功の指標】
-{ユーザーが定義した成功基準}
-```
-
-## フロー制御
-
-### スキップ処理
-
-ユーザーが「スキップ」と言った場合：
-1. その質問の回答はデフォルト値または空欄とする
-2. 次の質問に進む
-3. メタプロンプト生成時に「情報不足」として明記
-
-### 早期終了
-
-ユーザーが「もう十分」「早く作って」と言った場合：
-1. 収集済みの情報でメタプロンプトを生成
-2. 不足情報は推測値を使用し、その旨を明記
-
-### 所要時間の目安
-
-コンテキスト収集全体で **2-3分** を目安とします。
-5問すべてに回答しても3分以内で完了できるよう、質問は簡潔にします。
-
-## 次のステップ
-
-メタプロンプト生成後、以下のスキルに引き継ぎます：
-
-- 授業計画 → `lesson-plan.md`
-- 教材作成 → `materials.md`
-- 評価設計 → `assessment.md`
-- 個別指導 → `individual.md`
-- フィードバック → `feedback.md`
-- 生活指導 → `guidance.md`
-
-引き継ぎ時は、生成したメタプロンプトを該当スキルに渡します。
+1. 強化リクエスト案を提示する。
+2. 確認する。
+   - 不足条件が残っていないか。
+   - 質問が1件ずつになっているか。
+   - 危機対応時の注意書きが必要か。
+3. 不合格なら、質問順序または推測の扱いを修正して再提示する。
+4. 合格後のみ後続スキルへ引き継ぐ。

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: 導入で注意喚起し、振り返りで満足感を補強するために採用。
+```