教材作成（公式docs駆動・自動生成）

教材作成（公式docs駆動・自動生成）

このスキルの責務は、公式ドキュメントの構造をそのまま教材mdに写し取ること。1回の発動で、現Taskで扱う docs 範囲を章単位の複数mdに一気に分解・保存する。ユーザーは結果を受け取るだけ。

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

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

• ルール2（教材は公式docs粒度で逐次保存）
• ルール3（Q&Aは reference 側）
• ルール4（1md = docsの1章相当）

起動タイミング（Claude側の自動判断）

1. ユーザーが docs URL（公式ドキュメントへのリンク）を提示した直後
2. 新しいTaskを開始する時、まだ教材mdが1つもない場合
3. ユーザーが /learning-flow:material [<source>] を明示的に叩いた時

逆に、対話による解説や Q&A は本スキルの守備範囲外（→ lesson / reference）。

実行フロー

ステップ1: 一次資料（source）の取得

引数や直前の会話から source を確定する。

• URL: WebFetch で本文を取得し、章立て構造を解析
• ローカルファイル: Read で読み込み
• "current" または引数なし: 直前の会話で示された URL / ファイルを再利用
• 複数URL: 1つずつ処理してまとめて教材化（ただし Task をまたぐ範囲は分割提案）

source が見つからない場合のみ、AskUserQuestion で1度だけ確認:

公式ドキュメントの URL を提示してください。
（URL を持たない場合は "なし" と答えてください。会話ベースで章を切ります）

ステップ2: 現在のPhase/Taskを特定

• docs/LEARNING_CONTEXT.md から進行中Phaseを取得
• docs/learning/phase{N}/task*/ で進行中Task（main.md の振り返り未記入）を特定
• 該当Taskが未作成なら mkdir -p で作成し、main.md テンプレを置く

ステップ3: docsの章立てを解析・チャンク計画

source の見出し構造（H1/H2/H3）を抽出し、1md = docsの1章 or 1セクションとなる単位に分割する。粒度の目安:

• docsのH2見出し1つ ≈ 教材1枚
• H2が長すぎる場合は H3 単位に分ける
• H2が薄すぎる（数段落のみ）場合は近接するH2を結合

分割が決まったら、ユーザーに1メッセージで簡潔にチャンク計画を提示:

公式docsを以下{N}枚の教材に分けて生成します（自動保存）:

01-{topic-name-1}.md  ← {{docs section title 1}}
02-{topic-name-2}.md  ← {{docs section title 2}}
...

開始します。

ユーザーの承認は待たない（受動性を保つ）。極端に大きい範囲（10枚超）の時のみ確認を入れる。

ステップ4: 教材mdの一括生成

各チャンクについて、以下のテンプレで Write する。番号はTask内既存ファイルの最大値+1から開始（Glob で [0-9][0-9]-*.md を取得）。

# {{TOPIC_TITLE}}

> 出典: [{{docs_section_title}}]({{docs_url}}#{{anchor}})（閲覧日 {{date}}）
> このノートは公式ドキュメントの「{{section_path}}」を起点に、Claudeが自動生成した教材です。

## 概要

{{docsのリード文 / 章導入を1〜2段落で要約}}

## 公式docsに沿った解説

### {{docsサブセクション1}}

{{該当箇所の解説。元の構造・用語をできるだけ尊重}}

### {{docsサブセクション2}}

...

## 重要ポイント

- {{箇条書きで要点。docsで強調されている事項を中心に}}
- ...

## コード例 / 図

{{docsに含まれる例、または最小再現例}}

## 関連

- 議論・Q&A: （`lesson` 中に発生したら `reference/` 配下にリンクが追加されます）
- 次の教材: {{NN+1}}-{{next-topic}}.md（連続生成時）

---

_Auto-generated at {{date}} via /learning-flow:material（公式docs駆動）_

生成時の指針:

• 構造を勝手に再編成しない: docs の章立て順をそのまま踏襲
• {{TOPIC_TITLE}}: docsの見出しを日本語で自然に表現（元英語見出しを併記してよい）
• 出典は必須: 必ず URL とアンカー、閲覧日を入れる
• Q&Aは含めない: lesson 中に発生する Q&A は reference 側
• 推測補足は最小限: 公式docsに無い内容は基本入れない。入れる場合は > 補足（公式docsには記載なし）: と明示

ステップ5: main.md の目次を一括更新

Task の main.md の目次セクションに、生成した全教材へのリンクを順番に追加する。

## 目次

- [01-{{topic-1}}.md](01-{{topic-1}}.md) - {{TITLE_1}}
- [02-{{topic-2}}.md](02-{{topic-2}}.md) - {{TITLE_2}}
...

main.md が無い場合は新規作成（既存の learning-flow-rules のテンプレに準拠）。

ステップ6: 完了案内（簡潔）

📚 教材を{N}枚自動生成しました:
  docs/learning/phase{N}/task{M}/01-... 〜 {NN}-...

次のステップ:
  /learning-flow:lesson [01-...]  ← 1枚目から対話形式で解説を始めます

重要な注意点

受動性の徹底

教材1枚ごとに「保存しますか？」と確認しない。チャンク計画を1回出した後は、生成は無言で進める。失敗（WebFetch 不能等）の時のみユーザーに伝える。

Q&A・議論は含めない

ユーザーから事前に渡された質問や、会話中の議論があっても、教材mdには入れない。それらは reference 側で別ファイルとして保存する。

一次資料がない場合の振る舞い

ユーザーが「公式docsはない、自分の知識で進めたい」と言った場合、Claudeは以下を1度提案:

公式docsがあると教材の粒度が安定しますが、ない場合は以下のいずれかで進められます:
(a) Claudeの一般知識から章立てを推定して教材化する
(b) 教材作成はスキップし、`lesson` で対話ベースのみで進める

どちらにしますか？

冪等性

同じ Task で再度発動された場合、既存教材を尊重する:

• 既存ファイル名と重複する topic-name → 末尾に -v2 を付けるか、上書き確認
• docs の同じ章を再生成 → AskUserQuestion で「上書き(o)/別名で追加(a)/中止(c)」

スキルチェーン

material 完了後に自然と lesson に流れる導線を出すが、自動発動はしない。ユーザーの「解説して」「次へ」を待つ。