スコープ
「さあ、始めましょう」カテゴリ(CATEGORIES.gettingStarted)に、優先度 A の単機能チュートリアル 2 本を追加する。
| # |
名前(案) |
学ぶこと |
主なブロック |
| 1 |
コスチュームをかえてみよう |
コスチュームタブ/見た目の切り替え |
looks_switchcostumeto looks_nextcostume |
| 2 |
スプライトを 2 つ使ってみよう |
スプライトの追加・選択・それぞれにプログラムを持つこと |
(スプライト操作中心) |
どちらもコスチュームタブ/スプライトペインの UI 操作 GIF 中心。既存素材(chat3-mesh1-4-costume.gif / chat2-sprites1-5-add-penguin.gif 等)の流用を優先する。
この leaf で gettingStarted 単機能チュートリアルの規約を確定する(deck-id の命名・step 画像のファイル命名・locale キーの命名)。後続 leaf はこの規約に従う。
実装のしかた
1 本あたり:
packages/scratch-gui/src/lib/libraries/decks/categories/getting-started.jsx の decks にエントリを追加(name / tags / category: CATEGORIES.gettingStarted / img / nameMessageId / steps)
- サムネイル画像を
decks/thumbnails/ に追加して import
- 各ステップの画像 or GIF を
decks/steps/ に追加し、ja-steps.js / en-steps.js に登録
- 文言を
getting-started.locale.js の ja / jaHira / en に追加(ja と ja-Hira は対で追加する — .claude/rules/scratch-gui/development.md の i18n 規約)
- 必要なら
allowedBlocks でパレットを絞る(初学者が迷わないようにする)
参考にする既存実装: packages/scratch-gui/src/lib/libraries/decks/categories/ruby-basics.jsx(7 本を 1 カテゴリに並べた先例。setup と allowedBlocks の使い方の見本)。
tutorial-tags.js の CATEGORIES と decks/index.jsx は変更不要(既存の gettingStarted に足すだけ)。
設計方針(EPIC #1177 から継承)
この leaf の DoD
注意
Part of #1177
スコープ
「さあ、始めましょう」カテゴリ(
CATEGORIES.gettingStarted)に、優先度 A の単機能チュートリアル 2 本を追加する。looks_switchcostumetolooks_nextcostumeどちらもコスチュームタブ/スプライトペインの UI 操作 GIF 中心。既存素材(
chat3-mesh1-4-costume.gif/chat2-sprites1-5-add-penguin.gif等)の流用を優先する。この leaf で
gettingStarted単機能チュートリアルの規約を確定する(deck-id の命名・step 画像のファイル命名・locale キーの命名)。後続 leaf はこの規約に従う。実装のしかた
1 本あたり:
packages/scratch-gui/src/lib/libraries/decks/categories/getting-started.jsxのdecksにエントリを追加(name/tags/category: CATEGORIES.gettingStarted/img/nameMessageId/steps)decks/thumbnails/に追加して importdecks/steps/に追加し、ja-steps.js/en-steps.jsに登録getting-started.locale.jsのja/jaHira/enに追加(ja と ja-Hira は対で追加する —.claude/rules/scratch-gui/development.mdの i18n 規約)allowedBlocksでパレットを絞る(初学者が迷わないようにする)参考にする既存実装:
packages/scratch-gui/src/lib/libraries/decks/categories/ruby-basics.jsx(7 本を 1 カテゴリに並べた先例。setupとallowedBlocksの使い方の見本)。tutorial-tags.jsのCATEGORIESとdecks/index.jsxは変更不要(既存のgettingStartedに足すだけ)。設計方針(EPIC #1177 から継承)
rubyBasicsカテゴリが担当)blockBasics/blockGamesに deck を足さない(feat(tutorial): Phase 3 - Block チュートリアル 4 シリーズ (書籍プロモーション) #680 の担当領域)。追加先はgettingStartedのみこの leaf の DoD
ja/ja-Hira/enの文言が揃っている(ja と ja-Hira は対)npm run lintが 0 エラー・0 警告intro-getting-startedとrubyBasics/meshStep1-3が壊れていないdocs/tutorial/improvement-plan.mdに「gettingStarted= 単機能・Lv 分けなし」の方針分岐を追記する(同ドキュメントの「各軸は Lv 別の難度を踏襲」と食い違うため明文化する)注意
decks/thumbnails/decks/steps/*-steps.jsのコンフリクトに注意Part of #1177