shiden 0.4.3 → 0.5.0

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

@@ -0,0 +1,28 @@
+# Meta Prompt Output Template
+
+以下の構造で、収集済み条件を整理する。
+
+```markdown
+## 強化リクエスト
+
+### 元の依頼
+{original_request}
+
+### 確認済みの理解
+{refined_request}
+
+### 収集した条件
+- 対象: {grade_or_audience}
+- 教科: {subject}
+- トピック: {topic}
+- 成果物: {artifact_type}
+- 目標: {learning_goal}
+- 制約: {constraints}
+- 配慮事項: {considerations}
+
+### 未確定または推測
+- {assumption_1}
+
+### 次に実行する prompt
+{next_prompt}
+```

package/.github/prompts/feedback.md

@@ -1,333 +1,77 @@
-# フィードバック生成スキル
-
-> Growth Mindsetに基づいた、建設的で行動可能なフィードバックを生成します。
-
-## 概要
-
-このスキルは、学習成果や課題に対して、成長を促進する効果的なフィードバックを作成します。Carol Dweck の Growth Mindset 理論を基盤とし、具体的で行動につながるフィードバックを提供します。
-
-## 入力要件
-
-メタプロンプトから以下の情報を受け取ります：
-
-- **必須**: フィードバック対象（課題、作品、発表等）
-- **推奨**: 学習目標、評価基準、学習者情報
-- **任意**: 過去のフィードバック履歴、学習者の特性
-
-## Growth Mindset 原則
-
-### 基本原則
-
-| Fixed Mindset（避ける） | Growth Mindset（推奨） |
-|------------------------|----------------------|
-| 「頭がいいね」 | 「よく考えたね」 |
-| 「才能があるね」 | 「努力が実を結んだね」 |
-| 「簡単だったでしょ」 | 「挑戦したね」 |
-| 「できないね」 | 「まだできていないね」 |
-
-### フィードバックの3原則
-
-1. **努力と戦略を称える** - 結果ではなくプロセスに注目
-2. **具体的に指摘する** - 何が良く、何を改善すべきか明確に
-3. **次のステップを示す** - 行動可能な改善策を提案
-
-## 出力構造
-
-### 基本フィードバック
-
-```markdown
-# フィードバック
-
-## 対象
-- **課題**: {課題名}
-- **学習目標**: {関連する学習目標}
-- **日付**: {日付}
-
----
-
-## ✨ 良い点（Strengths）
-
-### 1. {良い点1の見出し}
-{具体的な説明と、なぜそれが良いのかの理由}
-
-> 「{具体的な引用や例}」の部分が特に{良い理由}です。
-
-### 2. {良い点2の見出し}
-{具体的な説明}
-
-### 3. {良い点3の見出し}
-{具体的な説明}
-
 ---
-
-## 🔧 改善点（Areas for Growth）
-
-### 1. {改善点1の見出し}
-
-**現状**: {現在の状態の客観的記述}
-
-**提案**: {具体的な改善方法}
-
-**例**: {改善例や参考例}
-
-### 2. {改善点2の見出し}
-
-**現状**: {現在の状態}
-
-**提案**: {具体的な改善方法}
-
----
-
-## 🚀 次のステップ（Next Steps）
-
-すぐに取り組める具体的なアクション：
-
-1. **{アクション1}**
-   - 何を: {具体的な内容}
-   - いつまで: {期限}
-   - どのように: {方法}
-
-2. **{アクション2}**
-   - 何を: {具体的な内容}
-   - いつまで: {期限}
-   - どのように: {方法}
-
----
-
-## 💭 振り返りの問いかけ
-
-以下の質問について考えてみましょう：
-
-1. {メタ認知を促す質問1}
-2. {メタ認知を促す質問2}
-3. {成長を促す質問}
-
----
-
-## 📈 成長の記録
-
-{過去からの成長ポイントがあれば}
-
-> 前回と比べて{成長したポイント}が見られます。{努力/戦略}の成果ですね。
-```
-
-### 作文・レポートへのフィードバック
-
-```markdown
-# 作文フィードバック
-
-## 作品情報
-- **タイトル**: {タイトル}
-- **種類**: {作文/レポート/エッセイ}
-- **テーマ**: {テーマ}
-
----
-
-## 全体的な印象
-
-{肯定的な全体評価から始める}
-
+name: feedback
+description: >
+  Generate actionable feedback comments, reflection prompts, and growth-oriented
+  responses for student work. Use when the user asks for feedback, comments,
+  reflection support, return notes, or response wording to learners.
+metadata:
+  author: nahisaho
+  version: "0.5.0"
 ---
 
-## 評価観点別フィードバック
-
-### 内容・主題 ⭐⭐⭐⭐☆
-
-**良い点**:
-- {具体的な良い点}
-
-**改善点**:
-- {具体的な改善点}
-
-**コメント**:
-「{引用}」の部分は{評価}です。{理由}。
-
-### 構成・論理展開 ⭐⭐⭐☆☆
-
-**良い点**:
-- {具体的な良い点}
-
-**改善点**:
-- {具体的な改善点}
-
-**提案**:
-{構成の改善提案}
-
-### 表現・語彙 ⭐⭐⭐⭐☆
-
-**良い点**:
-- {良い表現の例}
-
-**改善点**:
-- {改善できる表現の例}
-
----
-
-## 具体的な修正提案
-
-| 箇所 | 原文 | 提案 | 理由 |
-|------|------|------|------|
-| 第{n}段落 | {原文} | {修正案} | {理由} |
-
----
-
-## 次に書くときのポイント
-
-1. {次回に向けたアドバイス1}
-2. {次回に向けたアドバイス2}
-```
-
-### 発表・プレゼンへのフィードバック
-
-```markdown
-# プレゼンテーションフィードバック
-
-## 発表情報
-- **テーマ**: {テーマ}
-- **時間**: {発表時間}
-- **形式**: {個人/グループ}
-
----
-
-## 評価観点別フィードバック
-
-### 内容の充実度 ⭐⭐⭐⭐☆
-{具体的なコメント}
-
-### 構成・流れ ⭐⭐⭐⭐☆
-{具体的なコメント}
-
-### 話し方・声 ⭐⭐⭐☆☆
-{具体的なコメント}
-
-### 視覚資料 ⭐⭐⭐⭐☆
-{具体的なコメント}
-
-### アイコンタクト・態度 ⭐⭐⭐☆☆
-{具体的なコメント}
-
----
-
-## 印象的だったポイント
-
-> 「{引用/場面}」が特に{良かった点}でした。
-
----
-
-## 改善のための具体的提案
-
-1. **{提案1}**
-   - {詳細}
-   
-2. **{提案2}**
-   - {詳細}
-
----
-
-## 次回に向けて練習できること
-
-- {練習方法1}
-- {練習方法2}
-```
-
-## 自己評価・振り返り支援
-
-### メタ認知促進の問いかけ
-
-学習者自身の振り返りを促す質問：
-
-```markdown
-## 振り返りの問いかけ
-
-### 学習プロセスについて
-- この課題で一番時間をかけたのはどの部分ですか？
-- 難しいと感じたとき、どんな方法で乗り越えましたか？
-- もう一度やるとしたら、何を変えますか？
-
-### 理解度について
-- この課題で一番学んだことは何ですか？
-- まだよくわからない点はありますか？
-- 他の場面でどう使えそうですか？
-
-### 成長について
-- 以前の自分と比べて、どこが成長しましたか？
-- 次に挑戦したいことは何ですか？
-- 目標に対して、今どのくらいの位置にいると思いますか？
-```
-
-### 自己評価ルーブリック
-
-```markdown
-## 自己評価
-
-以下の項目について、自分で評価してみましょう。
-
-| 項目 | 4 | 3 | 2 | 1 |
-|------|---|---|---|---|
-| 課題への取り組み | 最後まで粘り強く取り組んだ | 概ね取り組めた | 途中で諦めそうになった | あまり取り組めなかった |
-| 目標の達成度 | 目標を超えた | 目標を達成した | もう少しで達成 | まだ遠い |
-| 工夫・挑戦 | 新しい工夫をした | いくつか工夫した | 少し工夫した | 特に工夫なし |
-
-### 自分へのフィードバック
-{自分自身への言葉}
-```
+# Feedback
 
-## バランスの取り方
+成長を促す、具体的で実行可能なフィードバックを作成する。
 
-### 良い点と改善点の比率
+## Use This Prompt When
 
-推奨比率: **良い点3 : 改善点2 : 次のステップ1**
+- レポート、作文、発表、ポートフォリオへのコメントを求められたとき。
+- テスト返却時の声かけや振り返り支援が必要なとき。
+- 改善点と次の一歩を、学習者が受け取りやすい形で示したいとき。
 
-- まず良い点を3つ以上見つける
-- 改善点は2つ程度に絞る（優先度高いもの）
-- 次のステップは1-2つの具体的アクション
+## Required Inputs
 
-### サンドイッチ法を超えて
+- 対象課題または学習成果。
+- 良い点、改善点、関連目標または評価観点。
+- 伝えたいトーンや対象学年。
 
-従来の「褒める→指摘→褒める」よりも、以下を推奨：
+## Workflow
 
-1. **全体的な肯定から始める**
-2. **良い点を具体的に説明**
-3. **改善点を建設的に提案**
-4. **次のステップで締める**
-5. **成長の可能性を伝える**
+1. 条件不足があればmeta-promptを使って補完する。
+2. references/common-theory-selection.mdを読み、Growth Mindsetと原因帰属の観点で表現方針を決める。
+3. assets/feedback-template.mdを再利用し、強み、改善点、次のアクション、振り返り質問をまとめる。
+4. 既存ルーブリックや評価観点がある場合は、それに沿って表現を合わせる。
+5. 学習者が次に取るべき行動を、1〜3件の具体策へ落とし込む。
+6. プロセス全体（表現方針の決定理由、理論適用箇所、トーン選定理由）を表示し、成果物とともにファイルへ保存する。
 
-## 教育理論データベースの活用
+## Conditional References
 
-### 理論検索コマンド
+- Read references/common-theory-selection.md when choosing tone or theoretical framing.
+- Reuse assets/feedback-template.md when drafting the final output.
 
-フィードバックに関する教育理論を検索するには、以下のコマンドを使用します：
+## Deliverables
 
-```bash
-# フィードバック・動機づけに関する理論を検索
-npx shiden theories search "フィードバック"
-npx shiden theories search "動機づけ"
-npx shiden theories search "マインドセット"
+- 良い点と改善点を含むフィードバック本文。
+- 次の学習行動。
+- 振り返りを促す問い。
+- プロセスログ（理論選定理由、表現方針、トーン判断の根拠）。
 
-# 特定の理論の詳細を取得
-npx shiden theories get growth_mindset
-npx shiden theories get effective_feedback
-npx shiden theories get self_regulated_learning
+## Quality Gates
 
-# 関連する理論を取得
-npx shiden theories related growth_mindset
+- [ ] 結果だけでなく、努力や戦略にも言及している。
+- [ ] 改善点が具体的行動へ変換されている。
+- [ ] 対象年齢に合った言葉づかいになっている。
+- [ ] 否定的断定や人格評価になっていない。
+- [ ] プロセスが表示され、ファイルに保存されている。
 
-# カテゴリ一覧から選択
-npx shiden theories categories
-npx shiden theories list --category "動機づけ"
-```
+## Data Handling & Safety
 
-### 主要なフィードバック理論
+- 実名やセンシティブ属性は不要なら削る。
+- 心理的危機を示唆する内容がある場合は、一般フィードバックに矮小化しない。
+- 学習成果の評価と人格評価を混同しない。
 
-| 理論ID | 理論名 | 用途 |
-|--------|--------|------|
-| `growth_mindset` | Growth Mindset | 成長志向のフィードバック |
-| `effective_feedback` | 効果的なフィードバック | フィードバックの原則 |
-| `self_regulated_learning` | 自己調整学習 | 自律的学習の促進 |
+## Gotchas
 
-## 次のステップ
+- 「すごい」「頑張った」だけでは再現可能性がなく、学習者が次の行動に移れない。
+- 改善点を多く出しすぎると実行可能性が落ちるため、優先度の高いものに絞る。
+- 低得点時の声かけで能力固定の表現を使うと、成長志向の設計が崩れる。
 
-フィードバック生成後、以下の連携が可能です：
+## Validation Loop
 
-- `individual.md` → フィードバックに基づく個別支援計画を作成
-- `materials.md` → 改善のための追加教材を作成
+1. フィードバック案を生成する。
+2. 確認する。
+   - 強み、改善点、次の一歩がそろっているか。
+   - 行動可能な提案になっているか。
+   - 否定的断定表現がないか。
+3. 不合格なら、表現トーンと具体性を修正して再生成する。
+4. 学習者が受け取って行動できる状態になったら完了とする。