grade

クイズ採点と進捗更新

このスキルの責務は、回答済みクイズの採点 → 復習キュー追記 → 進捗更新 → 次Taskの土台作成。教材作成や次Taskの解説着手は別スキル（material / lesson）に委ねる。

最初にやること: 学習フロー基本ルールの読み込み

本処理に入る前に、必ず Skill ツールで learning-flow:learning-flow-rules を呼び出して適用状態にする。特にルール7（復習キュー運用）を意識。

起動タイミング

• ユーザーが /learning-flow:grade を明示
• ユーザーが「採点して」「振り返り終わった」「クイズの答え書いた」等で要求
• quiz 後にユーザーが回答済み main.md を提示した時

実行フロー

ステップ1: 現Taskと回答状態の確認

• docs/LEARNING_CONTEXT.md から進行中Phase/Task特定
• main.md の ## 振り返り（クイズ形式） セクションを Read

前提チェック:

• セクションが未生成 → 「先に /learning-flow:quiz を実行してください」と案内して中断
• 各問の **回答**: 行の下が空 or 「未回答」のみ → 「回答を main.md に記入してから再度 /learning-flow:grade してください。部分的でも『分からない』と書けば採点対象にします」と案内して中断

ステップ2: 採点

各問について、回答を読んで判定:

• 正解 → ✅ 正解 + 1行コメント（深掘りが有益なら補足）
• 部分正解 → ⚠️ 一部正解 + 不足観点
• 誤答 → ❌ 正確には... + 正しい考え方
• 「分からない」「要復習」 → 採点せず解説してフォローに回す

採点結果はチャットに出力する。main.md への書き込みは任意（書く場合は各問の下に **採点**: ブロックを Edit で追加）。

ステップ3: 復習キューへの追記

❌誤答 / ⚠️一部正解 / 「要復習」とされた問題を docs/learning/review-queue.md の「待機中」セクションに追記する。

ファイルが存在しない場合は新規作成（先頭に運用コメントを置く）:

<!-- 復習キュー: 学習セッション開始時に「待機中」を確認・再出題する。
正解した問題は「習得済み」セクションに移動。 -->

# 復習キュー

## 待機中

（ここに追記）

## 習得済み

（正解した問題は日付更新してここに移動）

各エントリのフォーマット:

### [YYYY-MM-DD] Phase {N} / Task {M} — Q{番号} {短いタイトル}

**問題**: ...
**当時の回答**: ...
**模範解答の要点**:
- ...
**参考**:
- [{{title}}]({{url}})
**関連ノート**: [{{path}}]({{path}})

ルール:

• 日付は採点日（今日）
• ✅ 正解の問題はキューに追加しない
• 参考URLは main.md の Qn の **参考**: をそのまま転記。（要確認） のままなら、この時点で改めて WebSearch で1件以上埋める
• 関連ノート（教材mdへの相対パス）も併記

ステップ4: ユーザー承認

採点完了:
  ✅ {正解数}問 / ⚠️ {部分正解}問 / ❌ {誤答}問 / ❓ {要復習}問

復習キューに {K}件 追記しました（次回学習セッション開始時に再出題）。

このまま Task {M} を完了として Task {M+1} へ進みますか？
(a) はい、進む
(b) いいえ、もう少し復習したい  → どの問題を深掘りしますか？

ユーザーが (b) を選んだ場合は、該当問題を lesson 風に再解説して、満足したらもう一度 (a) を提示する。

ステップ5: 進捗更新（ユーザー承認後）

A. LEARNING_CONTEXT.md の進捗テーブル

Edit で更新:

• 現Task が Phase 最後のTask → 該当Phase行の「進行中」を「完了」、次Phase行の「未着手」を「進行中」に
• Phase内の進行 → 「現在の進捗」セクションを次Task記述に書き換え

## 現在の進捗

**Phase {N} / Task {M+1}**: {{次Taskのタイトル}} の学習段階。

B. 次Taskディレクトリの準備

docs/learning/phase{N}/task{M+1}/ を mkdir -p で作成し、main.md テンプレを Write:

# Phase {N} / Task {M+1}: {{次Taskのタイトル}}

## 目次

（教材は /learning-flow:material で自動生成されます）

## 振り返り

（Task完了時に /learning-flow:quiz で生成）

C. Phase完了時の特別扱い

現Taskが Phase最後のTaskで完了する場合:

1. Phase行の状態を「完了」
2. ユーザーに Phase全体の振り返りを促す:

Phase {N} 完了。

次Phaseに進む前に、Phase全体の振り返りを LEARNING_CONTEXT.md に残しませんか？
- このPhaseで習得した概念
- 当初の想定との差異
- 次Phaseに活かせる学び

書きますか？（y/n）

3. 承認後、Phase {N+1} の最初のTaskへ進む

ステップ6: 完了案内（次のアクション提示）

✅ Phase {N} / Task {M} 完了。Task {M+1} の土台を作成しました。

次のアクション:
  1. 公式docs/一次資料を提示  → /learning-flow:material で教材を自動生成
  2. すでに資料があるなら     → /learning-flow:material <URL> を直接実行
  3. /learning-flow:lesson    → 教材生成後、解説に進む

次Taskの解説そのものはこのスキルでは開始しない。material → lesson の流れでユーザーから着手させる。

重要な注意点

教材生成・次Task解説に踏み込まない

旧 next は採点後に次Taskの解説まで一気に始めていたが、本スキルは「進捗更新と土台作成」までに留める。教材作成は material、解説は lesson の責務。責務分離を保つ。

全Phase完了時

最後のPhaseの最後のTaskを完了した場合:

🎉 全 {PHASE_COUNT} Phase 完了。お疲れさまでした。

総仕上げとして以下を提案します:
- LEARNING_CONTEXT.md に全体振り返りセクションを追加
- 最初の想定と実際の学びのギャップを書き出す
- 次に学びたいテーマの洗い出し

冪等性

ユーザーが誤って2回実行した場合:

• 2回目の実行で「進行中」Taskが既に次Taskになっている → 「進捗は既に更新済みです。再採点しますか？」と確認
• 同じTaskで採点を複数回する場合、復習キューへの重複追記を避ける（同日付・同Q番号のエントリがあればスキップ）

復習キューの参考URL必須

復習キューのエントリには必ず **参考**: URL を1件以上入れる。これは将来再出題時にユーザーが自分で復習できるようにするため。