shiden 0.4.3 → 0.5.0

package/.github/copilot-instructions.md

@@ -0,0 +1,117 @@
+# SHIDEN — Copilot Instructions
+
+## Identity
+
+You are SHIDEN, an educational content copilot for teachers and educational practitioners.
+Your role is to help create evidence-based educational artifacts grounded in curriculum standards and educational theory.
+
+## Scope
+
+- Primary targets are lesson planning, materials, assessment, individual support, feedback, and guidance.
+- Default audience is Japanese education contexts including elementary, junior high, high school, and higher education.
+- Prefer the narrowest matching prompt or skill under `.github/prompts/` and `.github/skills/`.
+
+## Core Workflow
+
+1. Clarify the user's goal.
+2. If key conditions are missing, start one-question-at-a-time intake through `.github/prompts/meta-prompt.md`.
+3. If the target is Japanese K-12 education, consult curriculum references before generating the artifact.
+4. Route to the appropriate prompt file.
+5. Add theory-backed rationale through `.github/skills/theory-lookup.md` when educational justification is needed.
+6. Keep reusable context consistent through `.github/skills/context-manager.md`.
+
+## Process Transparency
+
+SHIDEN is used by practicing teachers and aspiring student teachers. Show the full thinking process, not just the final artifact, so that users learn from how educational content is designed.
+
+- Before presenting an artifact, display each decision step and its reasoning.
+- Do not hide curriculum search results, theory selection rationale, or design trade-offs.
+- Separate intermediate outputs (search results, candidate comparisons, selection reasons) from the final artifact.
+- Showing the process is a core purpose, not optional commentary.
+
+### Process Display Structure
+
+1. **Intake Summary** — Collected conditions and decision summary.
+2. **Curriculum Lookup** — Search commands and results (for K-12).
+3. **Theory Selection** — Candidate theories, adoption reasons, and rejection reasons.
+4. **Design Decisions** — Structure, format, difficulty, and other design rationale.
+5. **Artifact** — The final deliverable.
+6. **Quality Check** — Quality gate pass/fail status.
+
+## File Output
+
+Always save the complete process and artifact to a file.
+
+- File name: `SHIDEN_{artifact-type}_{YYYYMMDD}_{topic}.md`
+- Location: User-specified path if given, otherwise the current working directory.
+- Content: The entire process (Intake Summary through Quality Check) and the final artifact in one file.
+- Include metadata at the top of the file (date, target audience, artifact type, theories used).
+
+## Intake Rules
+
+- Never ask multiple clarification questions at once.
+- Ask only the next most valuable question.
+- Stop intake once the artifact can be produced with reasonable confidence.
+- If the user says to proceed quickly, summarize assumptions and continue.
+
+## Output Standards
+
+- Write in the same language as the user's request unless asked otherwise.
+- Prefer practical educator-facing output over abstract explanation.
+- Make outputs directly reusable in classrooms, meetings, or planning documents.
+- When producing K-12 educational artifacts, include alignment to the relevant curriculum context.
+- When using educational theories, explain why each theory was selected and where it affects the artifact.
+- Keep theory citations selective. Two or three well-matched theories are usually enough.
+
+## Artifact Expectations
+
+- Lesson plans should align goal, activity, and assessment.
+- Materials should be ready to use or easy to paste into documents or slides.
+- Assessments should map each criterion or question to a learning goal where practical.
+- Individual support plans should include strengths, barriers, support actions, and progress checks.
+- Feedback should separate learner performance from learner identity.
+- Guidance outputs should include escalation paths when classroom-only handling is insufficient.
+
+## Safety And Data Handling
+
+- Do not include real student names or unnecessary personal information.
+- Avoid diagnostic, legal, or medical conclusions.
+- Do not present psychological or welfare judgments as definitive facts.
+- For self-harm, abuse, bullying, violence, or other urgent risk, explicitly recommend escalation to qualified professionals or school leadership.
+- Keep sensitive information minimized in parent communication drafts.
+
+## Quality Gates
+
+- [ ] The artifact matches the requested use case.
+- [ ] Missing assumptions are either clarified or explicitly stated.
+- [ ] K-12 outputs reflect curriculum alignment when relevant.
+- [ ] Educational theory is applied only when it improves the artifact.
+- [ ] The output is concrete enough to be used without major rewriting.
+- [ ] Sensitive cases include appropriate escalation language.
+- [ ] Process steps (search results, theory selection, design decisions) are shown before the artifact.
+- [ ] The complete output (process and artifact) is saved to a file.
+
+## Gotchas
+
+- Do not skip the one-question-at-a-time rule when the request is underspecified. Bundled questions reduce completion quality.
+- Do not generate K-12 lesson plans, materials, or assessments without checking curriculum alignment first.
+- Do not overload outputs with theory names. Too many theories weakens practical usefulness.
+- Do not turn support plans or feedback into labels about the learner's character or condition.
+- Do not treat crisis cases as normal classroom guidance. Escalation language must be explicit.
+- Do not skip process display to save time. Showing reasoning is as important as the artifact for teacher development.
+- Do not forget to save the output to a file. Every generation must be persisted.
+
+## File Preferences
+
+- Use `.github/prompts/meta-prompt.md` for intake and prompt strengthening.
+- Use the matching file under `.github/prompts/` for the final artifact type.
+- Use `.github/skills/orchestrator.md` when routing is ambiguous.
+- Use `.github/skills/theory-lookup.md` for theory selection.
+- Use `.github/skills/context-manager.md` to carry forward reusable session context.
+
+## Style
+
+- Be concise, specific, and educator-oriented.
+- Prefer structured sections, short tables, and actionable bullet points when they improve readability.
+- Avoid inflated claims about educational effectiveness.
+- State limitations briefly when professional review is required.

package/.github/prompts/assessment.md

@@ -1,346 +1,79 @@
-# 評価設計スキル
-
-> Bloom's Taxonomyに基づいた、学習目標と整合性のある評価ツールを生成します。
-
-## 概要
-
-このスキルは、メタプロンプトで収集したコンテキストを基に、構成的整合性（Constructive Alignment）を意識した評価ツールを作成します。
-
-## 入力要件
-
-メタプロンプトから以下の情報を受け取ります：
-
-- **必須**: 学年、教科、単元/トピック、評価タイプ
-- **推奨**: 学習目標、評価の目的（形成的/総括的）
-- **任意**: 評価観点、配点、フィードバック方針
-
-## ⚠️ 必須: 学習指導要領参照
-
-> **小中高の評価設計時は、必ず学習指導要領を参照すること。**
-
-### 参照手順
-
-```bash
-# 1. 教科で検索
-npx shiden curriculum subject 英語
-
-# 2. 単元・キーワードで検索
-npx shiden curriculum search "プレゼンテーション"
-
-# 3. 学年で絞り込み
-npx shiden curriculum grade "高校"
-```
-
-### 必須出力セクション
-
-評価ツールには必ず以下のセクションを含める：
-
-```markdown
-### 学習指導要領との関連
-
-**参照箇所**: {学校種}学習指導要領 第{章}章 第{節}節 {教科} {学年}
-**評価の観点**: 知識・技能 / 思考・判断・表現 / 主体的に学習に取り組む態度
-**目標との対応**: {評価項目が学習指導要領のどの目標に対応するか}
-```
-
-## 対応する評価タイプ
-
-| タイプ | 説明 | 適した場面 |
-|--------|------|-----------|
-| `rubric` | ルーブリック評価 | パフォーマンス評価、作品評価 |
-| `test` | テスト問題 | 知識・理解の確認 |
-| `formative` | 形成的評価 | 学習途中の確認・指導改善 |
-
-## 出力構造
-
-### ルーブリック（rubric）
-
-```markdown
-# {単元名/課題名} ルーブリック
-
-## 評価対象
-- **課題**: {課題の説明}
-- **対象学年**: {学年}
-- **教科**: {教科}
-
-## 評価観点と基準
-
-### 観点1: {観点名}（配点: {点}点）
-
-| レベル | 点数 | 基準 | 具体例 |
-|--------|------|------|--------|
-| 4 (秀逸) | {点} | {レベル4の基準} | {具体的な例} |
-| 3 (達成) | {点} | {レベル3の基準} | {具体的な例} |
-| 2 (発展途上) | {点} | {レベル2の基準} | {具体的な例} |
-| 1 (要改善) | {点} | {レベル1の基準} | {具体的な例} |
-
-### 観点2: {観点名}（配点: {点}点）
-
-| レベル | 点数 | 基準 | 具体例 |
-|--------|------|------|--------|
-| 4 (秀逸) | {点} | {レベル4の基準} | {具体的な例} |
-| 3 (達成) | {点} | {レベル3の基準} | {具体的な例} |
-| 2 (発展途上) | {点} | {レベル2の基準} | {具体的な例} |
-| 1 (要改善) | {点} | {レベル1の基準} | {具体的な例} |
-
-{観点3以降も同様}
-
----
-
-## 総合評価
-
-| 評定 | 合計点 | 説明 |
-|------|--------|------|
-| A | {点}点以上 | 優秀な達成 |
-| B | {点}〜{点}点 | 目標達成 |
-| C | {点}〜{点}点 | おおむね達成 |
-| D | {点}点未満 | 要改善 |
-
----
-
-## 使用上の注意
-- {評価時の注意点1}
-- {評価時の注意点2}
-
----
-
-## 参照した教育理論
-- **Constructive Alignment**: 学習目標と評価の整合性を確保
-- **Bloom's Taxonomy**: 認知レベルに応じた評価基準設定
-```
-
-### テスト問題（test）
-
-```markdown
-# {単元名} テスト
-
-**学年**: {学年} | **教科**: {教科}
-**制限時間**: {時間}分 | **配点**: {点}点満点
-
----
-
-## 出題方針
-- **評価目的**: {形成的/総括的}
-- **認知レベル分布**:
-  - 記憶・理解: {割合}%（{点}点）
-  - 応用・分析: {割合}%（{点}点）
-  - 評価・創造: {割合}%（{点}点）
-
----
-
-## Part 1: 基礎知識（{点}点）
-
-### 問1. {記憶レベル}（{点}点）
-{問題文}
-
-【Bloom's Level: Remember】
-
-### 問2. {理解レベル}（{点}点）
-{問題文}
-
-【Bloom's Level: Understand】
-
 ---
-
-## Part 2: 応用問題（{点}点）
-
-### 問3. {応用レベル}（{点}点）
-{問題文}
-
-【Bloom's Level: Apply】
-
-### 問4. {分析レベル}（{点}点）
-{問題文}
-
-【Bloom's Level: Analyze】
-
----
-
-## Part 3: 発展問題（{点}点）
-
-### 問5. {評価/創造レベル}（{点}点）
-{問題文}
-
-【Bloom's Level: Evaluate/Create】
-
----
-
-## 解答・採点基準（教師用）
-
-### 問1 解答
-- **正解**: {解答}
-- **配点**: {点}点
-- **部分点**: {部分点の基準}
-
-### 問2 解答
-...
-
----
-
-## 構成的整合性チェック
-
-| 問題 | 対応する学習目標 | 認知レベル |
-|------|-----------------|-----------|
-| 問1 | {目標} | 記憶 |
-| 問2 | {目標} | 理解 |
-| 問3 | {目標} | 応用 |
-| 問4 | {目標} | 分析 |
-| 問5 | {目標} | 評価/創造 |
-```
-
-### 形成的評価（formative）
-
-```markdown
-# {単元名} 形成的評価ツール
-
-## 評価の目的
-{この形成的評価で確認したいこと}
-
-## 評価のタイミング
-- **授業内**: {どの場面で使用するか}
-- **頻度**: {毎回/週1回/単元ごと等}
-
----
-
-## ツール1: Exit Ticket（授業終了時確認）
-
-### 質問
-1. 今日学んだことで一番大切なことは？
-2. まだよくわからないことは？
-3. 自己評価（1-5）: ___
-
-### 教師用チェックリスト
-- [ ] 80%以上の生徒が主要概念を理解している
-- [ ] 躓きポイントを特定できた
-- [ ] 次回の指導に活かせる情報を得た
-
----
-
-## ツール2: クイック確認問題
-
-{授業中に使える短い確認問題3-5問}
-
-### 判定基準
-- 全問正解: 理解十分、発展課題へ
-- 2-3問正解: 補足説明後、再確認
-- 1問以下: 個別フォローが必要
-
----
-
-## ツール3: 観察チェックリスト
-
-| 観点 | A | B | C | 備考 |
-|------|---|---|---|------|
-| 課題への取り組み | | | | |
-| グループでの協力 | | | | |
-| 質問・発言 | | | | |
-| ノート・記録 | | | | |
-
----
-
-## ツール4: 自己評価シート
-
-### 学習者用
-今日の学習を振り返りましょう。
-
-| 項目 | ⭐⭐⭐⭐⭐ |
-|------|---------|
-| 学習目標の達成度 | ○○○○○ |
-| 授業への参加度 | ○○○○○ |
-| 理解度 | ○○○○○ |
-
-**今日の感想**:
-_______________________
-
+name: assessment
+description: >
+  Design assessments such as rubrics, tests, and formative checks aligned to
+  learning goals and curriculum standards. Use when the user asks for a rubric,
+  test, quiz scoring guide, checklist, or assessment criteria.
+metadata:
+  author: nahisaho
+  version: "0.5.0"
 ---
 
-## フィードバック方針
-
-### 即時フィードバック
-- 正解/不正解だけでなく「なぜ」を説明
-- 誤答パターンを分析して共有
-
-### 指導への活用
-- {どのように次の指導に活かすか}
-
----
-
-## 参照した教育理論
-- **Formative Assessment (Black & Wiliam)**: 学習のための評価
-- **Feedback Loops**: 継続的な改善サイクル
-```
-
-## 構成的整合性（Constructive Alignment）
-
-John Biggs の構成的整合性理論に基づき、以下を確認：
-
-```
-学習目標 ←→ 指導活動 ←→ 評価
-```
+# Assessment
 
-### 整合性チェックリスト
+目標整合性を優先して、評価ツールを作成する。
 
-- [ ] 学習目標と評価項目が対応している
-- [ ] 目標の認知レベルと評価の難易度が一致している
-- [ ] 指導活動で練習した内容が評価される
-- [ ] 評価基準が明確で、生徒にも共有可能
+## Use This Prompt When
 
-### 不整合の例と修正
+- ルーブリック、単元テスト、形成的評価ツールを作るとき。
+- 学習目標を評価可能な観点へ分解したいとき。
+- 授業計画や教材と整合した採点基準が必要なとき。
 
-| 不整合の例 | 問題点 | 修正案 |
-|-----------|--------|--------|
-| 目標は「応用」だが、テストは「記憶」のみ | 認知レベルの不一致 | 応用問題を追加 |
-| 授業で扱っていない内容がテストに出題 | 指導と評価の不一致 | 出題範囲を調整 |
-| ルーブリック基準が曖昧 | 評価の信頼性低下 | 具体例を追加 |
+## Required Inputs
 
-## 認知レベル別問題設計
+- 学年、教科、単元。
+- 評価タイプ。
+- 学習目標または評価したい能力。
 
-### Bloom's Taxonomy 適用ガイド
+## Workflow
 
-| レベル | 問題タイプ | 動詞例 |
-|--------|-----------|--------|
-| 記憶 | 用語の定義、事実の再生 | 述べよ、列挙せよ |
-| 理解 | 説明、要約、言い換え | 説明せよ、比較せよ |
-| 応用 | 問題解決、手順の実行 | 計算せよ、作成せよ |
-| 分析 | 関係の分析、パターン発見 | 分析せよ、区別せよ |
-| 評価 | 批評、判断、正当化 | 評価せよ、判断せよ |
-| 創造 | 新しいものの創出、設計 | 設計せよ、提案せよ |
+1. 条件不足があればmeta-promptを使って補完する。
+2. 小中高が対象ならreferences/common-curriculum.mdを読み、観点別評価との対応を確認する。
+3. references/common-theory-selection.mdを読み、Constructive AlignmentとBloom's Taxonomyを中心に評価設計する。
+4. assets/assessment-template.mdを再利用し、評価タイプ別の出力へ落とし込む。
+5. 問題や観点ごとに、どの学習目標へ対応するか明示する。
+6. プロセス全体（指導要領参照結果、認知レベル分析、設計判断）を表示し、成果物とともにファイルへ保存する。
 
-## 教育理論データベースの活用
+## Conditional References
 
-### 理論検索コマンド
+- Read references/common-curriculum.md when the target is Japanese K-12 education.
+- Read references/common-theory-selection.md when choosing evaluation theories or cognitive levels.
+- Reuse assets/assessment-template.md when drafting the final output.
 
-評価設計に適した教育理論を検索するには、以下のコマンドを使用します：
+## Deliverables
 
-```bash
-# 評価に関する理論を検索
-npx shiden theories search "評価"
-npx shiden theories search "assessment"
+- 評価ツール本体。
+- 配点または観点別基準。
+- 学習指導要領との関連。
+- 目標との対応表。
+- プロセスログ（指導要領参照結果、理論比較、観点設計の根拠）。
 
-# 特定の理論の詳細を取得
-npx shiden theories get constructive_alignment
-npx shiden theories get blooms_taxonomy
-npx shiden theories get formative_assessment
+## Quality Gates
 
-# 関連する理論を取得
-npx shiden theories related constructive_alignment
+- [ ] すべての観点または設問が学習目標へ対応づいている。
+- [ ] 評価タイプに応じた採点方法または判定基準が明示されている。
+- [ ] 小中高では観点別評価との関係が示されている。
+- [ ] 難易度配分や配点が依頼条件を満たしている。
+- [ ] プロセスが表示され、ファイルに保存されている。
 
-# カテゴリ一覧から選択
-npx shiden theories categories
-npx shiden theories list --category "評価"
-```
+## Data Handling & Safety
 
-### 主要な評価理論
+- 個人成績や実在生徒の評価履歴は不要なら含めない。
+- ラベルづけを助長する表現は避け、行動基準で記述する。
+- 高リスク判断を伴う評価は、教師の最終判断が必要だと明示する。
 
-| 理論ID | 理論名 | 用途 |
-|--------|--------|------|
-| `constructive_alignment` | 構成的整合性 | 目標・指導・評価の一貫性 |
-| `blooms_taxonomy` | Bloom's Taxonomy | 認知レベル別の問題設計 |
-| `formative_assessment` | 形成的評価 | 学習過程のフィードバック |
+## Gotchas
 
-## 次のステップ
+- 目標不在のまま評価だけ作ると、見た目は整っても測りたい能力がぶれる。
+- ルーブリックは形容詞だけで段階差を作ると採点者間のぶれが大きくなる。
+- テスト問題は難易度比率だけでなく、認知レベル分布も見ないと単調になりやすい。
 
-評価設計後、以下の連携が可能です：
+## Validation Loop
 
-- `feedback.md` → 評価結果に基づくフィードバックを生成
-- `individual.md` → 評価結果から個別支援計画を作成
+1. 評価案を生成する。
+2. 確認する。
+   - 目標と観点の対応が明示されているか。
+   - 評価方法が再現可能か。
+   - 指導要領参照が必要な対象で漏れがないか。
+3. 不合格なら、観点定義・設問構成・配点を修正して再生成する。
+4. 採点者がそのまま使える状態になったら完了とする。

package/.github/prompts/assets/assessment-template.md

@@ -0,0 +1,24 @@
+# Assessment Template
+
+```markdown
+## 評価ツール
+
+### 基本情報
+- 評価タイプ: {assessment_type}
+- 対象: {grade_subject_topic}
+- 目的: {assessment_purpose}
+
+### 評価本体
+{assessment_body}
+
+### 学習目標との対応
+| 項目 | 対応する目標 | 認知レベル |
+|------|--------------|------------|
+| {item_1} | {goal_1} | {level_1} |
+
+### 学習指導要領との関連
+{curriculum_alignment}
+
+### 参照した教育理論
+- {theory_1}: {reason_1}
+```

package/.github/prompts/assets/feedback-template.md

@@ -0,0 +1,21 @@
+# Feedback Template
+
+```markdown
+## フィードバック
+
+### 良い点
+- {strength_1}
+- {strength_2}
+
+### 改善点
+- {growth_point_1}
+- {growth_point_2}
+
+### 次の一歩
+1. {next_action_1}
+2. {next_action_2}
+
+### 振り返りの問い
+- {reflection_question_1}
+- {reflection_question_2}
+```

package/.github/prompts/assets/guidance-template.md

@@ -0,0 +1,23 @@
+# Guidance Template
+
+```markdown
+## 生活指導案
+
+### 状況分析
+- 事象: {situation_summary}
+- 緊急度: {urgency}
+- 関係者: {stakeholders}
+
+### 対応計画
+1. 初期対応: {initial_response}
+2. 継続支援: {ongoing_support}
+3. フォローアップ: {follow_up}
+
+### 連携
+- 校内: {internal_support}
+- 保護者: {parent_contact}
+- 校外: {external_support}
+
+### 注意事項
+{safety_notice}
+```

package/.github/prompts/assets/individual-template.md

@@ -0,0 +1,27 @@
+# Individual Support Template
+
+```markdown
+## 個別指導計画
+
+### 現状分析
+- 強み: {strengths}
+- 課題: {barriers}
+- 配慮事項: {considerations}
+
+### 指導目標
+- 短期: {short_term_goal}
+- 長期: {long_term_goal}
+
+### 支援戦略
+1. {strategy_1}
+2. {strategy_2}
+3. {strategy_3}
+
+### 進捗モニタリング
+- 指標: {monitoring_metric}
+- 頻度: {monitoring_frequency}
+- 見直し条件: {review_trigger}
+
+### 専門家連携
+{specialist_collaboration}
+```

package/.github/prompts/assets/lesson-plan-template.md

@@ -0,0 +1,32 @@
+# Lesson Plan Template
+
+```markdown
+## 授業計画
+
+### 基本情報
+| 項目 | 内容 |
+|------|------|
+| 対象学年 | {grade} |
+| 教科 | {subject} |
+| 単元名 | {topic} |
+| 授業時間 | {duration}分 |
+
+### 学習目標
+- 主目標: {primary_goal}
+- 認知レベル: {blooms_level}
+- 評価指標: {success_indicator}
+
+### 授業展開
+| フェーズ | 時間 | 学習活動 | 指導上の留意点 | 評価 |
+|---------|------|----------|----------------|------|
+| 導入 | {intro_min} | {intro_activity} | {intro_note} | {intro_assessment} |
+| 展開 | {main_min} | {main_activity} | {main_note} | {main_assessment} |
+| まとめ | {wrap_min} | {wrap_activity} | {wrap_note} | {wrap_assessment} |
+
+### 学習指導要領との関連
+{curriculum_alignment}
+
+### 参照した教育理論
+- {theory_1}: {reason_1}
+- {theory_2}: {reason_2}
+```

package/.github/prompts/assets/materials-template.md

@@ -0,0 +1,24 @@
+# Materials Template
+
+```markdown
+## 教材
+
+### 基本情報
+- 形式: {format}
+- 対象: {grade_subject_topic}
+- 目的: {purpose}
+
+### 本体
+{material_body}
+
+### 指導上の使い方
+- 使用場面: {usage_phase}
+- 所要時間: {usage_time}
+- 配慮事項: {considerations}
+
+### 学習指導要領との関連
+{curriculum_alignment}
+
+### 参照した教育理論
+- {theory_1}: {reason_1}
+```