shiden 0.4.2 → 0.5.0

package/.github/prompts/materials.md

@@ -1,349 +1,79 @@
-# 教材作成スキル
-
-> 教授設計原則に基づいた、効果的な教材（ワークシート、スライド、クイズ等）を生成します。
-
-## 概要
-
-このスキルは、メタプロンプトで収集したコンテキストを基に、学習目標に適した教材を作成します。Gagné's Nine Events of InstructionやARCS Modelを適用し、学習効果を最大化します。
-
-## 入力要件
-
-メタプロンプトから以下の情報を受け取ります：
-
-- **必須**: 学年、教科、単元/トピック、教材形式
-- **推奨**: 学習目標、難易度、時間配分
-- **任意**: デザイン要件、差別化対応
-
-## 対応する教材形式
-
-| 形式 | 説明 | 適した場面 |
-|------|------|-----------|
-| `worksheet` | ワークシート・プリント | 演習、確認、宿題 |
-| `slide` | プレゼンテーションスライド | 説明、講義、まとめ |
-| `quiz` | クイズ・小テスト | 形成的評価、復習 |
-| `handout` | 配布資料・参考資料 | 補足説明、自習用 |
-
-## 出力構造
-
-### ワークシート（worksheet）
-
-```markdown
-# {単元名} ワークシート
-
-**学年**: {学年} | **教科**: {教科} | **日付**: ___年___月___日
-**名前**: _________________
-
----
-
-## 学習目標
-{このワークシートで達成する目標}
-
----
-
-## 1. ウォーミングアップ（{時間}分）
-
-{前提知識の確認や興味喚起のための簡単な問題・活動}
-
----
-
-## 2. 基本問題（{時間}分）
-
-### 問題1
-{問題文}
-
-【解答欄】
-
-
-### 問題2
-{問題文}
-
-【解答欄】
-
-
----
-
-## 3. 発展問題（{時間}分）
-
-{応用・発展的な問題}
-
-【解答欄】
-
-
----
-
-## 4. 振り返り
-
-今日の学習で...
-- わかったこと: _______________________
-- もっと知りたいこと: _______________________
-- 自己評価: ⭐⭐⭐⭐⭐（塗りつぶしてください）
-
----
-
-📚 **今日のポイント**
-{重要事項のまとめボックス}
-```
-
-### スライド（slide）
-
-```markdown
-# {単元名} スライド構成
-
-## スライド1: タイトル
-- タイトル: {単元名}
-- サブタイトル: {学年} {教科}
-- 視覚要素: {イメージの説明}
-
-## スライド2: 本時の目標
-- 今日の目標: {学習目標}
-- キーワード: {重要語句}
-
-## スライド3-5: 導入
-- {興味を引く問いかけ/事例}
-- {前提知識の確認}
-- {本時の流れ}
-
-## スライド6-12: 展開
-- {核心的な内容1}
-- {具体例・図解}
-- {核心的な内容2}
-- {演習への橋渡し}
-
-## スライド13-14: まとめ
-- {要点の整理}
-- {次回予告}
-
-## スライド15: 振り返り
-- 今日のキーポイント
-- 質問タイム
-
----
-
-### スライドデザインガイドライン
-- フォント: ゴシック体、本文24pt以上
-- 色使い: 最大3色、コントラストを確保
-- 1スライド1メッセージの原則
-- 視覚的アンカー（図、アイコン）を活用
-```
-
-### クイズ（quiz）
-
-```markdown
-# {単元名} 確認クイズ
-
-**学年**: {学年} | **教科**: {教科}
-**制限時間**: {時間}分 | **配点**: {点}点満点
-
----
-
-## Part 1: 基礎知識（各{点}点 × {問}問 = {点}点）
-
-### Q1. {記憶レベルの問題}
-- [ ] A. {選択肢}
-- [ ] B. {選択肢}
-- [ ] C. {選択肢}
-- [ ] D. {選択肢}
-
-### Q2. {理解レベルの問題}
-{記述式の問題}
-
-【解答欄】
-
-
----
-
-## Part 2: 応用問題（各{点}点 × {問}問 = {点}点）
-
-### Q3. {応用レベルの問題}
-{問題文}
-
-【解答欄】
-
-
----
-
-## Part 3: 発展問題（{点}点）
-
-### Q4. {分析/評価レベルの問題}
-{問題文}
-
-【解答欄】
-
-
----
-
-### 採点基準
-- Part 1: {基準}
-- Part 2: {基準}
-- Part 3: {基準}
-
-### 解答・解説（教師用）
-{各問題の解答と解説}
-```
-
-### 配布資料（handout）
-
-```markdown
-# {単元名} 参考資料
-
-## 1. 概要
-{単元の全体像を簡潔に説明}
-
-## 2. 重要用語
-| 用語 | 定義 | 例 |
-|------|------|-----|
-| {用語1} | {定義} | {例} |
-| {用語2} | {定義} | {例} |
-
-## 3. 要点まとめ
-### ポイント1: {見出し}
-{説明}
-
-### ポイント2: {見出し}
-{説明}
-
-## 4. 図解
-{概念図や流れ図の説明}
-
-## 5. 参考リソース
-- {参考書籍/ウェブサイト}
-- {関連動画}
-
-## 6. 練習問題
-{自習用の追加問題}
-```
-
-## 教授設計原則の適用
-
-### Gagné's Nine Events of Instruction
-
-教材設計時に以下の9事象を考慮：
-
-1. **注意の獲得** - 興味を引く導入
-2. **目標の提示** - 学習目標の明示
-3. **前提条件の想起** - 既習事項の確認
-4. **学習内容の提示** - 新しい情報の提示
-5. **学習の案内** - ガイダンス・ヒント
-6. **練習の誘発** - 演習機会の提供
-7. **フィードバックの提供** - 正誤の確認
-8. **評価の実施** - 習得度の確認
-9. **保持と転移の促進** - 応用・発展
-
-### ARCS Model
-
-動機づけの4要素を教材に組み込み：
-
-- **A (Attention)**: 興味を引く要素
-- **R (Relevance)**: 学習者との関連性
-- **C (Confidence)**: 達成可能な難易度
-- **S (Satisfaction)**: 達成感を得られる構成
-
-## 差別化対応（UDL原則）
-
-Universal Design for Learningに基づき、多様な学習者に対応：
-
-### 提示の多様化（Multiple Means of Representation）
-- テキスト + 図解 + 音声説明
-- 複数の具体例
-- 用語の定義を明示
-
-### 表現の多様化（Multiple Means of Action & Expression）
-- 選択式 + 記述式の組み合わせ
-- 図や絵で回答可能な問題
-- 段階的なヒント
-
-### 取り組みの多様化（Multiple Means of Engagement）
-- 興味関心に応じた例題
-- 選択可能な発展課題
-- 自己評価セクション
-
-## TENJIN連携
-
-### 推奨される理論検索
-
-```
-get_theory(id="gagnes_nine_events")
-→ Gagné's Nine Events の詳細と適用例
-
-get_theory(id="arcs_model")
-→ ARCS Model の詳細と動機づけ戦略
-
-search_theories(category="instructional_materials")
-→ 教材設計に関する理論を検索
-```
-
-## 出力例
-
-（ワークシートの例）
-
-```markdown
-# 一次関数 ワークシート
-
-**学年**: 中学2年生 | **教科**: 数学 | **日付**: ___年___月___日
-**名前**: _________________
-
 ---
-
-## 学習目標
-2点を通る直線の式を求め、グラフに表すことができる。
-
+name: materials
+description: >
+  Generate instructional materials such as worksheets, slides, quizzes, and
+  handouts aligned to goals and curriculum. Use when the user asks for a worksheet,
+  slide deck, quiz sheet, handout, or lesson material package.
+metadata:
+  author: nahisaho
+  version: "0.5.0"
 ---
 
-## 1. ウォーミングアップ（5分）
+# Materials
 
-次の一次関数のグラフを見て、傾きと切片を答えましょう。
+学習目標に対応した教材を、形式別テンプレートで生成する。
 
-[グラフ図]
+## Use This Prompt When
 
-傾き: _______ 切片: _______
+- ワークシート、スライド、小テスト、配布資料を求められたとき。
+- 授業計画に合わせた教材一式を作りたいとき。
+- 難易度や配慮事項を反映した教材差分が必要なとき。
 
----
+## Required Inputs
 
-## 2. 基本問題（15分）
+- 学年、教科、単元。
+- 教材形式。
+- 学習目標または教材の用途。
 
-### 問題1
-点(1, 3)と点(3, 7)を通る直線の式を求めなさい。
+## Workflow
 
-【解答欄】
-傾き = (_____ - _____) ÷ (_____ - _____) = _____
+1. 条件不足があればmeta-promptを使って補完する。
+2. 小中高が対象ならreferences/common-curriculum.mdを読み、学習指導要領との対応を確認する。
+3. references/common-theory-selection.mdを読み、注意喚起・練習・振り返りの設計原則を選定する。
+4. 要求形式に応じてassets/materials-template.mdを再利用し、教材構造を決める。
+5. 必要に応じて授業計画の目標や時間配分と整合させる。
+6. プロセス全体（指導要領参照結果、理論選定理由、形式選定理由）を表示し、成果物とともにファイルへ保存する。
 
-式: y = _____ x + _____
+## Conditional References
 
-### 問題2
-点(-2, 5)と点(4, -1)を通る直線の式を求めなさい。
+- Read references/common-curriculum.md when the target is Japanese K-12 education.
+- Read references/common-theory-selection.md when material design needs theory justification.
+- Reuse assets/materials-template.md when drafting the final output.
 
-【解答欄】
+## Deliverables
 
+- 教材本体。
+- 学習目標または用途との対応。
+- 学習指導要領との関連。
+- 教育理論の適用メモ。
+- プロセスログ（指導要領参照結果、理論比較、形式決定の根拠）。
 
----
+## Quality Gates
 
-## 3. 発展問題（10分）
+- [ ] 教材形式が依頼内容と一致している。
+- [ ] 導入、学習活動、確認、振り返りの流れがある。
+- [ ] 学習指導要領参照が必要な対象で対応箇所が明記されている。
+- [ ] 印刷または提示時にそのまま使える粒度になっている。
+- [ ] プロセスが表示され、ファイルに保存されている。
 
-ある携帯電話の料金プランは、基本料金が1000円、通話1分あたり30円です。
-通話時間をx分、料金をy円として、yをxの式で表しなさい。
-また、通話時間が20分のときの料金を求めなさい。
+## Data Handling & Safety
 
-【解答欄】
-
-
----
-
-## 4. 振り返り
-
-今日の学習で...
-- わかったこと: _______________________
-- もっと知りたいこと: _______________________
-- 自己評価: ⭐⭐⭐⭐⭐
-
----
+- 個別支援用教材でも、不要な個人情報は出さない。
+- 画像指示や外部資料指示は著作権不明な固有素材に依存しない。
+- 危険な実験や活動を含む場合は安全上の注意を入れる。
 
-📚 **今日のポイント**
-2点を通る直線の式は、傾き = (y₂-y₁)÷(x₂-x₁) で求められる！
-```
+## Gotchas
 
-## 次のステップ
+- 教材形式が未確定のまま生成すると、出力が冗長になり再利用性が落ちる。
+- スライド教材は説明文だけでなく、各枚の役割を分けないと実運用しづらい。
+- ワークシートは問題だけで終わらせず、振り返り欄か教師用解答方針を最低1つ入れる。
 
-教材作成後、以下の連携が可能です：
+## Validation Loop
 
-- `assessment.md` → 教材に対応した評価ツールを作成
-- `feedback.md` → 生徒の回答にフィードバックを生成
+1. 教材案を生成する。
+2. 確認する。
+   - 形式別要件を満たしているか。
+   - 学習目標と問題・活動が一致しているか。
+   - 学習指導要領参照が必要なケースで漏れがないか。
+3. 不合格なら、形式・難易度・構成を修正して再生成する。
+4. 実用可能な体裁になったら完了とする。

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

@@ -1,218 +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に基づいた具体的な学習目標}
-
-### 【参照すべき教育理論】
-以下の理論をTENJINから検索し、適用を検討してください：
-- {推奨理論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. 合格後のみ後続スキルへ引き継ぐ。