## なにをするか EPIC #2162 で決まった「スモウルボットS1 の拡張機能を Studuino(スタディーノ)としてリニューアルし、練習用の基板を入れる」方針を docs に書く。**コードは変えない**(このあとの sub-issue が docs を正として実装する)。 ## 決まったこと(#2162 の「決まったこと(設計の相談・2026-11-19)」が正) - E1: 同じ拡張機能のまま、名前を「Studuino」にする。**拡張機能の ID(`smalrubotS1`)・opcode・メニューの名前と値・Ruby の読みこみは変えない**。前の作品(sb3・Ruby)はそのまま開ける。 - E2: 名前は「Studuino(スタディーノ)」。ライブラリの絵は自分たちで描いた基板の絵(アーテック社の写真・ロゴは使わない)。 - E3: ポートの配置はいまの S1 の配置のまま(A0/A1 LED、A2 タッチ、A4/A5 赤外線(フォトリフレクタ)、A6 光、A7 音、M1/M2 DC モーター、D10 サーボ)。名前だけ一般的にする。ポートの割り当てを変えられる「Studuino モード」は #2163 で設計する。 - E4: センサー名は教科書の一般的な名前を先に、部品名をかっこで(「光センサー (A6)」「赤外線センサー(フォトリフレクタ)(A4)」「タッチセンサー (A2)」「音センサー (A7)」)。 - E5: **通常モードにはできる限りブロックを足さない**。選択肢だけ増やす(「左のセンサー」も「赤外線センサー(フォトリフレクタ)(A4)」もある)。新しいブロックは基本的に Studuino モード(#2163)用。 - E6: ロボットのブロック(前進させる・アームを曲げる等)は残したまま、パレットの後ろの方に「ロボットカー」の見出しをつけてまとめる。名前は「車を前進させる」など一般的に。 - E7: 練習用の基板は、ステージの下(または横)のたためるパネル。値は数字と簡単な印、センサーはスライダーとボタン。 - E8: 実機がつながっていなければ自動で練習用の基板。つながったら実機(パネルに「いまは練習用の基板」と出す)。 - E9: Ruby は書き出しを全部 `studuino.` に、読みこみは `smalrubot_s1.` も受けつける。 - #2158 の Q5〜Q7: 拡張機能が出した命令(LED・モーター・サーボの角度)と読んだセンサーの値を記録し、実機でも練習用の基板でも同じ事実で判定する。手元に無いセンサーは代わりのセンサーでも「できた」。練習用の基板の見た目は重要でなく、各センサーの値・サーボのいまの角度・モーターの正転/逆転/停止がわかる程度でよい。 ## 変える場所 - `docs/extension-smalrubot-s1/README.md` を Studuino の docs にする。ディレクトリ名は、ID を変えない方針(E1)に合わせて **そのまま `docs/extension-smalrubot-s1/` に置く**か、`docs/extension-studuino/` に移すかを実装時に決める(移すなら、`docs/` 内のリンク(`docs/smalruby-language-spec-extensions*.md`・`docs/device-connection/`・`docs/maintenance/smalruby-markers-*.md` など)を全部直す)。 - 書くこと: 冒頭の 🆕 区分・ランタイム対応・デフォルト表示、名前の変更と互換の方針(変えないもの一覧: ID・opcode・メニュー名・メニューの値・`smalrubot_s1.` の読みこみ・ファームウェア)、ブロックと選択肢の一覧(一般的な名前とポート)、ロボットカーの見出し、Ruby の書き方(`studuino.`)、練習用の基板と自動切りかえ、命令とセンサーの値の記録(レッスンの判定用)、Studuino モード(#2163)との境目。 - 既存の README の古い記述(「Ruby Generator は要追加調査」や、実際とちがう Ruby の例 `action(:forward, 100)` など)も現在のコードに合わせて直す。 ## テスト docs のみ。`npm run lint`(prettier の対象なら format)。 ## DoD - 上の方針が docs に書かれ、このあとの sub-issue(名前 #2188・選択肢と見出し #2189・Ruby #2190・練習用の基板 #2191 #2192・記録 #2193)がこの docs を参照できる。 - スクリーンショットは変えない(UI の変更は後の sub-issue で撮り直す)。 親 EPIC: #2162 。設計のページ: https://claude.ai/artifact/RGmK1RHWRRu1whrgmmeNGN 。
Activity
smalruby3-editor-bot commentedon Nov 18, 2026
PR #2195 を topic/studuino-2162 にマージしました。docs は sub-issue の実装にあわせて topic の中で更新していきます。