教材の対話解説

教材の対話解説

このスキルの責務は、material が作った教材mdを読み解いてユーザーに伝えること。教材本体は触らず、解説のリズムを管理する。出てきたQ&Aは reference に渡す。

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

本処理に入る前に、必ず Skill ツールで learning-flow:learning-flow-rules を呼び出して適用状態にする。特に:

• ルール1（解説 → 確認 → 実装 → 振り返り → 次へ のサイクル厳守）
• ルール3（Q&Aは reference 側へ）

起動タイミング

• ユーザーが「解説して」「次のトピック」「lesson」「教えて」等で要求した時
• material 完了直後にユーザーが「進めて」「OK」等で続行を示した時
• 明示: /learning-flow:lesson [<NN-name>]

実行フロー

ステップ1: 解説対象の特定

A. 引数で <NN-name> 指定あり

そのままその教材を対象にする。

B. 引数なし

現Taskの docs/learning/phase{N}/task{M}/ を Glob で [0-9][0-9]-*.md 列挙。

「次の未解説教材」を判定する優先順:

1. main.md 目次の各エントリに [done] マーカーが付いていれば、付いていない最小番号を選ぶ
2. マーカーが無い場合、会話履歴から既に lesson 済みのものを推測。判別不能なら AskUserQuestion で:

このTaskには {N} 枚の教材があります。どれから解説しますか？

(a) 01-{{title1}}
(b) 02-{{title2}}
(c) 続きから（最新番号: {{NN}}）

ステップ2: 教材の読み込みと事前確認

Read で対象教材を読み込み、ユーザーに「これから扱う章」を1〜2行で伝える:

📖 これから {{NN}}-{{topic}}.md（{{TITLE}}）を解説します。
   公式docs出典: {{docs_url}}
   章構成: {{章タイトル1}} / {{章タイトル2}} / ...

進めてよいですか？（y/n、または「{{特定章}}から始めて」）

ユーザーの「y」「OK」「進めて」を受けてから本格的な解説へ。

ステップ3: 章ごとの対話解説

教材の ## 公式docsに沿った解説 配下の各サブセクションを順に扱う。1サブセクションごとに:

1. 解説: 教材本文を読み上げるのではなく、要点を噛み砕いて伝える。図やコード例があれば一緒に提示
2. 確認: 「ここまでで疑問はありますか？」と短く問いかける
3. 質問対応: ユーザーから質問が来たら丁寧に答える
4. 次のサブセクションへ: ユーザーの「OK」「進めて」を受けてから次へ

禁止:

• 教材mdをそのままチャットに丸ごとコピペする
• ユーザー確認なしに全章を一気に喋る
• 教材mdの内容を勝手に書き換える（誤りを発見した場合は material 再生成を提案）

ステップ4: Q&A発生時の reference 連携

ユーザーから質問・議論が発生し、その質問群が一区切りついた時に、Skill ツールで learning-flow:reference を発動して Q&A を保存する。

判定基準（一区切り）:

• 1つの論点について 2 往復以上の対話があった
• ユーザーが「なるほど」「理解した」「次へ」で締めくくった
• 別のサブセクションに移ろうとしている

reference 発動時の theme 命名は、議論された論点を kebab-case で表現する（例: dynamodb-pk-vs-sk-design-tradeoff）。reference 側で Q&A 形式に整形して保存される。

reference 完了後、教材mdの「## 関連」セクションに Edit でリンクを追加:

## 関連

- 議論・Q&A: [reference/{{theme}}.md](reference/{{theme}}.md)

ステップ5: 教材完了の記録

教材1枚分の解説が全章完了したら、main.md の目次該当行に [done] マーカーを Edit で付ける:

- [01-foo.md](01-foo.md) - Foo解説 [done]

そしてユーザーに次の選択肢を提示:

✅ {{NN}}-{{topic}}.md の解説を完了しました。

次のステップ:
  (a) 次の教材へ → /learning-flow:lesson  （引数なしで自動的に次へ）
  (b) 一旦休憩・別作業
  (c) このTaskは全教材終わったので振り返りクイズへ → /learning-flow:quiz

判定: 全教材に [done] が付いていれば (c) を強く推奨。

重要な注意点

教材mdには触らない（除く: 関連リンクと[done]マーカー）

教材本文は material の責務。lesson は読むだけ。本文に誤り・古さを見つけた場合:

教材 {NN}-{topic}.md に修正点を見つけました:
  - {{誤り箇所}}: 公式docsの最新では {{正しい内容}}

/learning-flow:material で該当章を再生成しますか？

Q&Aを教材本体に混ぜない

ユーザーから質問が出ても、それを教材mdの本文に追記しない。必ず reference 側のmdに分離する。

解説の粒度

教材mdは公式docsの写しなので、読み上げではなく噛み砕きを意識する:

• 専門用語は具体例で補足
• 抽象的な仕様は最小コード例で示す
• 図解できる箇所は mermaid 等を活用

中断・再開

長いTaskで途中中断した場合、再開時は [done] マーカーから自動判定して続きから始められる。ユーザーの明示的な再開指示を待たなくてよい（受動性の延長）。

全教材完了時

全教材が [done] になったタイミングで、/learning-flow:quiz を強めに推奨する。ユーザーが承認すれば quiz を発動。