feat(tutorial): Phase 3 - Block チュートリアル 4 シリーズ (書籍プロモーション)

[takaokouji]

概要

Phase 3: Block 軸チュートリアルを 書籍「キラキラRuby」(藤村健吾 著、仮称) の抜粋プロモーションとして 4 シリーズ × 4 deck = 16 deck 追加する。書籍購入と組み合わせて使う前提の設計。

設計詳細: docs/tutorial/improvement-plan.md Phase 3 セクション参照。

位置づけ (重要)

• 書籍プロモーション: チュートリアルは書籍の代替ではなく「試食」。書籍販売数の増加を目的の 1 つとする
• 理想形: 先生が書籍を購入 → 児童に配布 → 書籍とチュートリアルを並行
• 書籍引用: 各 deck の冒頭で書誌情報、末尾で書籍購入リンクを表示

スコープ削減ルール

各章のチュートリアル対象は 書籍の「前半部分の一部」だけ に絞る:

• 【基本】 セクションの 最初の数小節 のみを Lv0 / Lv2 / Lv3 で扱い、途中で「続きは書籍の第n章で」と打ち切る
• 【発展】 セクションは Lv0 のみ (= 完成コードを動かして見せるだけ、Lv2/Lv3 解説なし)

Lv 体系 (Mesh とは別の番号付け)

書籍シリーズは意図的に Lv0 / Lv2 / Lv3 で運用し、Lv1 を「書籍を読んで理解する段階」として明示的に空ける:

Lv	場所	内容
Lv0	チュートリアル	コード挿入で動くものを体験
Lv1	(書籍)	コードの意味・なぜ動くかの解説
Lv2	チュートリアル	ブロックを自分で組み立てる (書籍を読んだ前提)
Lv3	チュートリアル	Ruby で書く (書籍を読んだ前提)

4 シリーズ deck マッピング

カテゴリ	章	基本 Lv0	基本 Lv2	基本 Lv3	発展 Lv0	題材
blockBasics	第1章	block-basics-lv0	block-basics-lv2	block-basics-lv3	block-basics-advanced	ネコからにげるゲーム冒頭 / ネズミ追加
blockGames	第4章	block-shooting-lv0	block-shooting-lv2	block-shooting-lv3	block-shooting-advanced	シューティング冒頭 / クローン拡張
blockMath	第5章	block-math-lv0	block-math-lv2	block-math-lv3	block-math-advanced	正多角形 / 幾何学模様 (ペン拡張)
blockScience	第6章	block-science-lv0	block-science-lv2	block-science-lv3	block-science-advanced	文字表示・加速度 / だるまさんが転んだ (microbitMore)

拡張機能セットアップ

Phase 2 で導入する setup プロパティを活用:

• blockMath: setup: { tab: 'code', extensions: ['pen'] }
• blockScience: setup: { tab: 'code', extensions: ['microbitMore'] }
• 全 Lv3: setup: { tab: 'ruby', rubyMode: 'ruby' }

書籍引用と購入導線

• オープニングステップ: 「📖『キラキラRuby』(藤村健吾 著) 第n章 より」
• クロージングステップ (基本 Lv0/Lv2/Lv3): 「ここまで体験したのは本書 第n章の最初の数ページの内容です。続きは書籍を」+ 購入リンク
• クロージング (発展 Lv0): 「このプログラムをゼロから作る手順は書籍を」+ 購入リンク

事前確認事項 (実装着手前に解決すべき)

• 書籍の正式タイトル・出版社・ISBN・購入リンク (藤村氏に確認)
• 書籍コード・章タイトル引用の許諾 (藤村氏に確認)
• 書籍リンクの保守ポリシー (定数化)

画像戦略

• 基本 Lv0: 4 deck × ~5 ステップ = 20 枚
• 基本 Lv2: 4 deck × ~6 ステップ = 24 枚 (ブロック画像)
• 基本 Lv3: 4 deck × ~5 ステップ = 20 枚 (Ruby エディタ)
• 発展 Lv0: 4 deck × ~3 ステップ = 12 枚
• 合計 約 76 枚

DoD

• 書誌情報・引用許諾の確認 (前提)
• 4 カテゴリ × 4 deck = 16 deck 追加
• 各 deck 冒頭・末尾の書籍引用ステップ
• ペン / microbitMore 拡張の自動ロード動作
• 全 step 画像 (~76 枚)
• locale 3 ファイル更新
• npm run lint 緑
• Playwright で全 deck の起動・進行を確認

規模見積もり

1 章 (4 deck) で 1 PR、合計 4 PR、3〜5 週間規模。

親 issue

このタスクは チュートリアル全体拡充 の一環。親 issue は別途作成。

関連資料

• 全体設計: docs/tutorial/improvement-plan.md
• 書籍ドラフト: tmp/kirakiraruby/0[1456]_*.docx (公開リポジトリには含まれない)