wendy-lite

wendy-lite skill の概要

wendy-lite の用途

wendy-lite は、ESP32-C6 向けの Wendy Lite firmware 上で動く WebAssembly アプリを作るための skill です。ざっくりした組み込みアイデアを、Wendy Lite の host imports を通じてハードウェアとやり取りできる実用的な WASM モジュールへ落とし込むときに、特に力を発揮します。

どんな人に向いているか

C、Rust、Swift、Zig、TypeScript、WAT で firmware に近いアプリを開発していて、デバイスアクセス、起動時ロード、コールバック駆動の動作が必要なら wendy-lite skill を使うべきです。wendy-lite for Backend Development にも関係しますが、ここでいう “backend” が MCU 上のデバイス側ロジック、ランタイム統合、アプリのオーケストレーションを指す場合に限って、特に有効です。

何が違うのか

汎用的な WASM プロンプトと違い、wendy-lite は実際の実行モデルに合わせて設計されています。ESP32-C6 上の WAMR、wendy モジュールの imports、flash に保存されるバイナリ、GPIO 割り込み・タイマー・BLE イベントのような非同期コールバックまで前提にしています。つまりこの skill は、「WASM の書き方」ではなく「このアプリを firmware の契約にどう合わせるか」が詰まりどころのときに、より役立ちます。

wendy-lite skill の使い方

インストールして、適切なファイルを確認する

まず対象ディレクトリで wendy-lite install のフローを実行し、その後に SKILL.md を最初に読みます。リポジトリを拡張しているなら、frontmatter で参照されている関連ファイルも確認してください。特に wasm-api.md、firmware-config.md、swift-sdk.md は重要です。実際のインターフェース詳細は、たいていそこにまとまっています。

デバイス前提のブリーフを渡す

最適な入力は「WASM アプリを作って」ではなく、制約のあるデバイス課題です。たとえば、対象言語、入出力となるハードウェア、起動時の挙動、コールバック対応の必要性まで含めます。例: 「ESP32-C6 向けに、GPIO のボタンを読み取り、NeoPixel を切り替え、再接続後も動き続ける Rust の WASM モジュールを作ってください。」 こうした依頼は、曖昧な wendy-lite usage よりずっと有効です。ランタイムの形を具体的に渡せるからです。

まずはランタイム契約から考える

wendy-lite usage を使うときは、まず「モジュールが何を export するか」「wendy から何を import するか」「コールバックをどう処理するか」「バイナリを flash 用にどうパッケージするか」の順で考えてください。迷うなら、先に最小構成のスケルトンを依頼し、そのあとでハードウェアアクセスやエラーハンドリングを足していくほうが安全です。

手戻りを減らす実践的な進め方

1. 言語名とターゲットボードを明示する。
2. 必要なハードウェア機能を具体的に書く: GPIO、I2C、SPI、UART、BLE、ネットワーク、LED 制御など。
3. 最小のスターターが欲しいのか、完成形のアプリが欲しいのか、既存コードの移植が欲しいのかを伝える。
4. 必要ならビルドに関する注意も求める。特に Swift や非標準ツールチェーンを使う場合は重要です。
   これが、一般的な WASM 例ではなく、すぐ役立つ wendy-lite guide の結果を得る最短ルートです。

wendy-lite skill の FAQ

wendy-lite は初心者向きですか？

はい。ただし、制約のあるデバイスアプリを作ることが目的で、ランタイム固有の手順に従う意思がある場合に限ります。幅広い WASM チュートリアルから始めたい人には、あまり初心者向きではありません。wendy-lite は、言語の文法そのものより firmware 統合を重視する前提だからです。

wendy-lite が向かないのはどんなときですか？

ESP32-C6 を対象にしていない、ハードウェアアクセスが不要、あるいは普通の Web 向け WASM アプリだけが欲しいなら、wendy-lite skill は避けてください。WASM バイナリを flash に保存できない、または WAMR ベースの実行モデルを使えないプロジェクトにも、あまり向いていません。

素のプロンプトと何が違いますか？

素のプロンプトでは、コードと firmware の間にある契約を取りこぼしがちです。wendy-lite が強いのは、正しい import/export の形、コールバック処理、デバイスのライフサイクルに関する案内が必要なときです。普通のプロンプトは、こうした部分を見落としやすいからです。

出力を信頼する前に何を確認すべきですか？

提案されたコードが、リポジトリ内の実際の host API、コールバックのエントリポイント、ビルド対象と一致しているかを確認してください。回答にそれらの要素が出てこない場合、技術的にはもっともらしくても、Wendy Lite としては間違っている可能性があります。

wendy-lite skill を改善するには

足りないハードウェア情報を補う

品質が最も大きく上がるのは、必要なハードウェア経路を具体的に伝えたときです。センサーやアクチュエータの種類、分かるならピン番号、イベントが割り込み駆動かどうか、再起動をまたいで状態を保持する必要があるかを明記してください。そうすれば wendy-lite が、ボードに合わない広すぎるデモを出すのを避けやすくなります。

欲しい出力の形をはっきり指定する

早く進めたいなら、出力を次の 3 つのどれかに絞って依頼してください。最小限で動くモジュール、実行可能なサンプルと説明付きのもの、既存の C/Rust/Swift/Zig プロジェクトからの移行計画。特に wendy-lite install の結果をすぐ試したいときは、長い説明より出力形式の明確さのほうが重要です。

よくある失敗パターンに注意する

ありがちなミスは、標準的な WASM のブラウザ API を前提にしてしまうこと、wendy の host import 層を飛ばすこと、非同期イベントのコールバック配線を見落とすことです。最初の回答が抽象的すぎると感じたら、実際の firmware ライフサイクルに沿って書き直すよう求め、未対応の前提があれば明示してもらってください。

compile-first のフィードバックで反復する

2 回目以降は、失敗内容をそのまま返すのが効果的です。たとえば、欠けている import、間違った target triple、誤った callback 名、ビルド手順の不一致などです。強い wendy-lite guide の改善は、「もっと詳しく」と頼むことではなく、1 つの具体的なエラー報告と絞り込んだ目標から生まれることが多いです。