メインコンテンツまでスキップ

ハンズオンの案内

CADL と SoS-DSL のハンズオン教材は、目的別に 2 つのトラックに分かれています。 自分に合うトラックから始めてください。

読み手やること進む順
学習者自分で CADL を書いて動かすコース A(テキストブック)(背景と全体構造も本文で説明しています) → B / D → C
研究者教材を自分の SoS の試作に流用するなぜ SoS-DSL なのか?を流し読み → コース C
リポジトリの公開状況

cadl-spec(本仕様・ハンズオンサイト)、cadl(コンパイラ / CLI)、cadl-explorer(可視化)、cadl-raspimouse-simulator(シミュレータ)は公開しています。コース A(テキストブック)は、すべての章を公開リポジトリだけで進められます。コース D で使う cadl-robot-town も公開しています。コース B で使う cadl-mobility-sos-exercise は、現時点では公開していません。

初めての人へ:3 段階の進め方​

初めて触る場合は、理解する、雛形で練習する、ゼロから作るの 3 段階で進めてください。最初の段階ではコードを書きません。

段階何をするか使う教材目安
① 理解する全体の構造(4 リポジトリ・仕様→IR→コード生成の流れ)と主要プログラムの役割を把握するテキストブックの第 1〜3 章(SoS の背景、ツールチェインと 4 つのリポジトリ、CADL 言語の要点)。背景をさらに知るにはなぜ SoS-DSL なのか?0.5〜1 日
② 雛形で練習する用意された雛形をコピーして書き足しながら、契約の記述 → 検査 → 可視化 → シミュレーション実行をひと通り行うコース A(テキストブック) 第 1〜8 章 → 第 4〜9 章の終わりの ★・★★ 演習1〜2 週間
③ ゼロから作る雛形なしで機能を追加する:新しい監視・状態の追加(★★★)、別ドメインのモデリング(コース C)、LLM による契約生成ループ(発展課題)テキストブックの ★★★ 演習と第 10 章 → コース C興味に応じて

学習者向けの 4 コース​

4 コースはどれも同じ CADL/SoS-DSL の文法を使い、扱う題材とランタイムだけが異なります。 まずコース A から始めてください。B と D はどちらも A を前提にした独立の応用コースで、片方だけでも両方でも進められます。 最後のコース C では、自分で選んだドメインを CADL で書きます。

B と D は互いに独立です。コース C には、A に加えて B か D のどちらかが必要です。

始める前に:なぜ SoS-DSL なのか?​

SoS とは何か、なぜ普通のプログラミング言語では書きにくいのか、CADL は何を補うのかを説明し、A〜D で前提となる用語をひと通り紹介する短い導入です。 コース A の前に読んでおくと、後の章を読み進めやすくなります。

→ なぜ SoS-DSL なのか?

コース A — ロボット配送(基礎)​

項目内容
題材倉庫内のロボット配送
ターゲットUnity C#
所要時間約 95 分(5 分のセットアップ + 15 分 × 6 ステップ)
前提なし。CADL に初めて触れる人向け
学べることactors / contracts / lifecycle / monitors の基本、cadl-explorer による可視化、Unity 連携

コース A は、ナビゲーションに独立したタブを持つ、単独で読めるテキストブックです。第 4〜9 章の終わりに、5 回の授業の演習(全 19 課題、★〜★★★)があります。

→ テキストブック — コース A:ロボット配送

コース B — 都市モビリティ(応用)​

項目内容
題材タクシー配車の System of Systems
ターゲットSUMO(交通シミュレータ)
所要時間60〜90 分(5 つの可視化チェックポイント付き)
前提コース A
学べること別ランタイムへのコード生成、契約の guarantee 節に対するシミュレーション結果の判定(deadline と monitor は一覧に出るが、SUMO 上では評価されない)、感度解析(CADL を書き換えて再評価する)

→ コース B — 都市モビリティ

コース A と同じ文法のまま、題材とコード生成のターゲットだけを差し替えます。コース A と比べて、何が同じで何が違うのかを確かめてください。

コース D — ロボットの街(応用)​

項目内容
題材ラズパイマウスのシミュレータと同じ道路網を共有する、3 社の配送ロボット
ターゲット小さな Python のシミュレーション。規範はコース A の参照ランタイムが判定する(Unity・SUMO は不要)
所要時間120〜150 分
前提コース A
学べることシステムが動いている間に、KPI に向けて規則・規制・契約を改正すること:人間が KPI を自然言語で書き、時間とともに変える。LLM が改正案を出し、自分で決めるべきでないこと(当事者の合意、顧客との約束、規制、安全、KPI どうしの衝突、確かでない改善)は、判断に必要な情報を添えて人間に判断を求める。人間の理由は自然言語と GSN で残る。改正案は検証・憲法・測った改善・投票を通る。代理指標の KPI、安全条件つきの運用モードの切替

→ コース D — ロボットの街

コース C — 自分の SoS をモデル化(発展)​

項目内容
題材受講者が選ぶ任意のドメイン(食事配達、緊急対応、電力グリッドなど)
ターゲット任意。標準の選択肢は SimPy のような軽量な Python の離散事象ハーネスで、Unity は不要
所要時間数時間〜数週間(受講者が自分で進めるミニプロジェクト相当)
前提コース A に加えて、コース B か D
学べること新しいドメインに対して actors / contracts / lifecycle / monitors を自力で設計し、ランタイムも自分で選ぶ

コース C は自由度を高くしてあり、課題は概要だけを示しています。細かい手順は書いていません。 → コース C — 自分の SoS


60 秒で動かしてみる(任意)​

まず動くところをターミナルだけで見たい場合は、次を実行します。

cd ~/program/cadl_repo
./scripts/sos_dsl_handson_e2e.sh

テキストブック 2.4 節のセットアップ(cadl リポジトリを ~/program/cadl_repo としてクローン)が済んでいることが前提です。 スクリプトは同梱の examples/sos_dsl_robot_delivery.cadl に対して parse → IR → codegen を一気に通し、続きの案内を出します。 最後の段階では、生成した C# を cadl-raspimouse-simulator(cadl_repo の隣にある想定)の Unity プロジェクトにコピーします。まだクローンしていない場合は、代わりに ./scripts/sos_dsl_handson_e2e.sh --unity "" を実行してください。コード生成までで終了します。 このあとは なぜ SoS-DSL なのか?、コース A(テキストブック) の順に進んでください。


教材一覧​

役割リンク
最初に読む背景の説明なぜ SoS-DSL なのか?
コース A — テキストブック(演習つき)ロボット配送
コース B — モビリティ都市モビリティ
コース D — KPI に向けて規則を直すロボットの街
コース C — 自分の SoS自分の SoS