Skip to content

docs(studuino): Studuino リニューアルの方針(名前・選択肢・ロボットカー・Ruby・練習用の基板・記録)を docs に書く #2187

Closed

Description

@smalruby3-editor-bot

なにをするか

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 モード」は epic(studuino): Studuino モード(プログラムを hex にして Studuino 単体で動かす) #2163 で設計する。
  • E4: センサー名は教科書の一般的な名前を先に、部品名をかっこで(「光センサー (A6)」「赤外線センサー(フォトリフレクタ)(A4)」「タッチセンサー (A2)」「音センサー (A7)」)。
  • E5: 通常モードにはできる限りブロックを足さない。選択肢だけ増やす(「左のセンサー」も「赤外線センサー(フォトリフレクタ)(A4)」もある)。新しいブロックは基本的に Studuino モード(epic(studuino): Studuino モード(プログラムを hex にして Studuino 単体で動かす) #2163)用。
  • E6: ロボットのブロック(前進させる・アームを曲げる等)は残したまま、パレットの後ろの方に「ロボットカー」の見出しをつけてまとめる。名前は「車を前進させる」など一般的に。
  • E7: 練習用の基板は、ステージの下(または横)のたためるパネル。値は数字と簡単な印、センサーはスライダーとボタン。
  • E8: 実機がつながっていなければ自動で練習用の基板。つながったら実機(パネルに「いまは練習用の基板」と出す)。
  • E9: Ruby は書き出しを全部 studuino. に、読みこみは smalrubot_s1. も受けつける。
  • feat(lessons): 中学 3 年「計測・制御」のコース(ワークシート・教科書連動) #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 モード(epic(studuino): Studuino モード(プログラムを hex にして Studuino 単体で動かす) #2163)との境目。
  • 既存の README の古い記述(「Ruby Generator は要追加調査」や、実際とちがう Ruby の例 action(:forward, 100) など)も現在のコードに合わせて直す。

テスト

docs のみ。npm run lint(prettier の対象なら format)。

DoD

親 EPIC: #2162 。設計のページ: https://claude.ai/artifact/RGmK1RHWRRu1whrgmmeNGN 。

Activity

  1. smalruby3-editor-bot commented on Nov 18, 2026

    @smalruby3-editor-bot
    Author

    PR #2195 を topic/studuino-2162 にマージしました。docs は sub-issue の実装にあわせて topic の中で更新していきます。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions