shiden 0.4.3 → 0.5.0

package/.github/prompts/materials.md

@@ -1,427 +1,79 @@
-# 教材作成スキル
-
-> 教授設計原則に基づいた、効果的な教材（ワークシート、スライド、クイズ等）を生成します。
-
-## 概要
-
-このスキルは、メタプロンプトで収集したコンテキストを基に、学習目標に適した教材を作成します。Gagné's Nine Events of InstructionやARCS Modelを適用し、学習効果を最大化します。
-
-## 入力要件
-
-メタプロンプトから以下の情報を受け取ります：
-
-- **必須**: 学年、教科、単元/トピック、教材形式
-- **推奨**: 学習目標、難易度、時間配分
-- **任意**: デザイン要件、差別化対応
-
-## ⚠️ 必須: 学習指導要領参照
-
-> **小中高の教材作成時は、必ず学習指導要領を参照すること。**
-
-### 参照手順
-
-```bash
-# 1. 教科で検索
-npx shiden curriculum subject 理科
-
-# 2. 単元・キーワードで検索
-npx shiden curriculum search "電気の流れ"
-
-# 3. 学年で絞り込み
-npx shiden curriculum grade "第4学年"
-```
-
-### 必須出力セクション
-
-教材には必ず以下のセクションを含める：
-
-```markdown
-### 学習指導要領との関連
-
-**参照箇所**: {学校種}学習指導要領 第{章}章 第{節}節 {教科} {学年}
-**目標**: 「{学習指導要領の目標を引用}」
-**内容**: 「{当該単元の内容を引用}」
-**本教材との対応**: {教材内容が学習指導要領のどの部分に対応するか}
-```
-
-## 対応する教材形式
-
-| 形式 | 説明 | 適した場面 |
-|------|------|-----------|
-| `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）
-- 興味関心に応じた例題
-- 選択可能な発展課題
-- 自己評価セクション
-
-## 教育理論データベースの活用
-
-### 理論検索コマンド
-
-教材設計に適した教育理論を検索するには、以下のコマンドを使用します：
-
-```bash
-# 授業設計・教材に関する理論を検索
-npx shiden theories search "教授設計"
-npx shiden theories search "動機づけ"
-
-# 特定の理論の詳細を取得
-npx shiden theories get gagnes_nine_events
-npx shiden theories get arcs_model
-
-# 関連する理論を取得
-npx shiden theories related gagnes_nine_events
-
-# カテゴリ一覧から選択
-npx shiden theories categories
-npx shiden theories list --category "授業設計"
-```
-
-### 主要な教材設計理論
-
-| 理論ID | 理論名 | 用途 |
-|--------|--------|------|
-| `gagnes_nine_events` | Gagné's Nine Events | 9つの教授事象に基づく教材構成 |
-| `arcs_model` | ARCS Model | 動機づけを高める教材設計 |
-| `udl` | Universal Design for Learning | 多様な学習者への対応 |
-
-## 学習指導要領データベースの活用（必須）
-
-### 学習指導要領の参照手順
-
-> ⚠️ **必須**: 教材作成時は、**必ず**学習指導要領を参照して内容の妥当性を確認します。
-
-```bash
-# 教科で検索
-npx shiden curriculum subject 理科
-npx shiden curriculum subject 算数
-
-# キーワードで検索
-npx shiden curriculum search "電気の流れ"
-npx shiden curriculum search "図形の面積"
-
-# 学年で検索
-npx shiden curriculum grade "第4学年"
-```
-
-### 教材への反映
-
-1. **学習内容の範囲確認**
-   - 当該学年で扱うべき内容を確認
-   - 前学年との系統性を把握
-
-2. **用語の正確性**
-   - 学習指導要領で使用されている用語を確認
-   - 学年に応じた表現を使用
-
-3. **評価の観点**
-   - 知識・技能、思考・判断・表現を意識した問題設計
-
-## 出力例
-
-（ワークシートの例）
-
-```markdown
-# 一次関数 ワークシート
-
-**学年**: 中学2年生 | **教科**: 数学 | **日付**: ___年___月___日
-**名前**: _________________
-
----
-
-## 学習目標
-2点を通る直線の式を求め、グラフに表すことができる。
-
 ---
-
-## 1. ウォーミングアップ（5分）
-
-次の一次関数のグラフを見て、傾きと切片を答えましょう。
-
-[グラフ図]
-
-傾き: _______ 切片: _______
-
+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"
 ---
 
-## 2. 基本問題（15分）
+# Materials
 
-### 問題1
-点(1, 3)と点(3, 7)を通る直線の式を求めなさい。
+学習目標に対応した教材を、形式別テンプレートで生成する。
 
-【解答欄】
-傾き = (_____ - _____) ÷ (_____ - _____) = _____
+## Use This Prompt When
 
-式: y = _____ x + _____
+- ワークシート、スライド、小テスト、配布資料を求められたとき。
+- 授業計画に合わせた教材一式を作りたいとき。
+- 難易度や配慮事項を反映した教材差分が必要なとき。
 
-### 問題2
-点(-2, 5)と点(4, -1)を通る直線の式を求めなさい。
+## Required Inputs
 
-【解答欄】
+- 学年、教科、単元。
+- 教材形式。
+- 学習目標または教材の用途。
 
+## Workflow
 
----
+1. 条件不足があればmeta-promptを使って補完する。
+2. 小中高が対象ならreferences/common-curriculum.mdを読み、学習指導要領との対応を確認する。
+3. references/common-theory-selection.mdを読み、注意喚起・練習・振り返りの設計原則を選定する。
+4. 要求形式に応じてassets/materials-template.mdを再利用し、教材構造を決める。
+5. 必要に応じて授業計画の目標や時間配分と整合させる。
+6. プロセス全体（指導要領参照結果、理論選定理由、形式選定理由）を表示し、成果物とともにファイルへ保存する。
 
-## 3. 発展問題（10分）
+## Conditional References
 
-ある携帯電話の料金プランは、基本料金が1000円、通話1分あたり30円です。
-通話時間をx分、料金をy円として、yをxの式で表しなさい。
-また、通話時間が20分のときの料金を求めなさい。
+- 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
 
-## 4. 振り返り
+- [ ] 教材形式が依頼内容と一致している。
+- [ ] 導入、学習活動、確認、振り返りの流れがある。
+- [ ] 学習指導要領参照が必要な対象で対応箇所が明記されている。
+- [ ] 印刷または提示時にそのまま使える粒度になっている。
+- [ ] プロセスが表示され、ファイルに保存されている。
 
-今日の学習で...
-- わかったこと: _______________________
-- もっと知りたいこと: _______________________
-- 自己評価: ⭐⭐⭐⭐⭐
+## Data Handling & Safety
 
----
+- 個別支援用教材でも、不要な個人情報は出さない。
+- 画像指示や外部資料指示は著作権不明な固有素材に依存しない。
+- 危険な実験や活動を含む場合は安全上の注意を入れる。
 
-📚 **今日のポイント**
-2点を通る直線の式は、傾き = (y₂-y₁)÷(x₂-x₁) で求められる！
-```
+## Gotchas
 
-## 次のステップ
+- 教材形式が未確定のまま生成すると、出力が冗長になり再利用性が落ちる。
+- スライド教材は説明文だけでなく、各枚の役割を分けないと実運用しづらい。
+- ワークシートは問題だけで終わらせず、振り返り欄か教師用解答方針を最低1つ入れる。
 
-教材作成後、以下の連携が可能です：
+## Validation Loop
 
-- `assessment.md` → 教材に対応した評価ツールを作成
-- `feedback.md` → 生徒の回答にフィードバックを生成
+1. 教材案を生成する。
+2. 確認する。
+   - 形式別要件を満たしているか。
+   - 学習目標と問題・活動が一致しているか。
+   - 学習指導要領参照が必要なケースで漏れがないか。
+3. 不合格なら、形式・難易度・構成を修正して再生成する。
+4. 実用可能な体裁になったら完了とする。