wendy

wendy skill の概要

wendy skill は何のためのものか

wendy skill は、wendy CLI を使って WendyOS のエッジデバイスを扱うための skill です。初期セットアップからデプロイ、リモート管理までをカバーし、プロジェクト作成、アプリ実行、デバイス探索、対応ハードウェアへの変更反映といった作業を、実務的に進めたい開発者に向いています。

どんな人に向いているか

NVIDIA Jetson や Raspberry Pi 4/5 を対象にしている場合、または WendyOS ハードウェアへデプロイする前に ARM64/AMD64 の VM 上で開発している場合に wendy skill を使ってください。エッジデバイス向けの Swift アプリのデプロイ手順が必要で、適切な CLI コマンドを手探りで判断したくないときにも有効です。

何が違うのか

一般的な組み込みデプロイのプロンプトと違い、wendy skill は wendy ツールチェーンと JSON ベースのコマンドスタイルに軸足があります。構造化された出力がほしい、対話プロンプトを減らしたい、ローカル開発からデバイス配備までを自然につなげたい、という場合にこの違いが効いてきます。

wendy skill の使い方

まず適切なインストール文脈で使う

WendyOS、デバイスセットアップ、またはアプリ配備が明確にテーマになっているリポジトリでこの skill を使ってください。skill manager を使っている場合は、skill フォルダを指す repository path で wendy をインストールし、その後でコマンド、デバイス手順、デプロイ方針を尋ねる前に skill を読み込んでおきます。精度を上げるには、wendy install、wendy usage、wendy for Deployment のように、1つの目的に絞ってプロンプトを保つのが有効です。

wendy に必要な入力を渡す

wendy skill は、対象デバイス、アプリの種類、そして現在の作業段階を伝えると最もよく機能します。例えば「WendyOS 上の Raspberry Pi 5 向け Swift アプリがあります。必要な wendy コマンド、想定される wendy.json のフィールド、安全なデプロイ手順を示してください」のような依頼がよい例です。逆に「デプロイを手伝って」とだけ書くと、ハードウェア構成、プロジェクトの形、出力形式まで推測させることになり、精度が落ちます。

まず中核ファイルを読む

コマンドを試す前に、SKILL.md を起点に読み、リンクされている wendy.json.md の参照があればそれも確認してください。ローカルコピーに skill ファイルしかない場合は、それをサポート対象ワークフローの唯一の根拠として扱います。対象は wendy init、wendy run、wendy discover、デバイスの WiFi 設定、agent update、OS install です。使い方の明確さを優先するなら、タスクが JSON 出力を前提にしているかも確認してください。この skill は、対話ダイアログを避けるために構造化されたコマンド出力を明確に好みます。

デプロイに合ったワークフローを使う

信頼しやすい流れは、まずデバイス対象を定義し、discovery を実行し、デバイス状態を確認してから wendy.json を作成または検証し、最後に JSON 出力を有効にして該当コマンドを実行する、というものです。デプロイ計画を尋ねる場合は、初回セットアップなのか、CI 風に繰り返し実行するデプロイなのか、ARM64 上でのリモートデバッグなのかを明示してください。この違いによって、必要なコマンド順序も事前準備の量も変わります。

wendy skill の FAQ

wendy は WendyOS 専用ですか？

はい、wendy skill は WendyOS とそのデバイスワークフロー専用です。プロジェクトが WendyOS を対象にしていないなら、汎用のデプロイプロンプトか、別のプラットフォーム特化 skill のほうが適しています。

wendy CLI をすでに知っている必要がありますか？

いいえ。ただし、対象ハードウェアとやりたいことは把握しておくべきです。wendy skill は、ざっくりした目的を正確な wendy usage 手順に落とし込むのに役立ちます。特に、対話的なコマンド挙動やフラグ周りの推測を避けたいときに有効です。

いつ wendy skill を使わないべきですか？

WendyOS と無関係な一般的な組み込み Linux の話題や、wendy CLI を使わないデプロイ基盤には使わないでください。高レベルの概念整理だけが欲しく、実際にはコマンドを実行するつもりがない場合にも、あまり向いていません。

初心者にも向いていますか？

はい、すでに WendyOS の対象が決まっている初心者なら向いています。この skill は実用的ですが、対象デバイスの種類、プロジェクト言語、デプロイ目標を言語化できることを前提にしています。そのほうが、出力を汎用的ではなく具体的にできます。

wendy skill をどう改善するか

具体的なデプロイ対象を伝える

出力を最も早く改善する方法は、対象デバイスと環境を正確に指定することです。たとえば、Jetson の本番機、Raspberry Pi のテスト機、開発用 VM などです。そうすれば wendy skill はワークフローを絞り込み、不要な手順を外し、適切な install または deploy 経路に集中できます。

プロジェクトの形と制約を含める

ゼロから始めるのか、既存の Wendy Lite プロジェクトを更新するのか、Swift アプリに Wendy を組み込むのかを伝えてください。あわせて、「非対話必須」「JSON 出力が必要」「ARM64 でのリモートデバッグ経由で動作する必要がある」といった制約も書き添えます。こうした情報はコマンドに直接影響し、wendy guide が危険な推測を避ける助けになります。

コマンドだけでなく、足りない情報も尋ねる

最初の結果が広すぎるなら、正確な wendy.json のフィールド、最小構成の有効な wendy init フロー、あるいは対象デバイス向けの wendy run シーケンスを求めてください。デプロイ作業では、前提条件、デバイス探索、アプリパッケージや entitlement 設定の調整が必要かどうかを確認する追質問が、たいてい最も役立ちます。

1つの失敗ごとに段階的に改善する

wendy の出力がうまく動かない場合は、実行した正確なコマンド、デバイスの種類、エラーテキストを報告してください。そのうえで、修正版のコマンドか、最小限の再現手順を求めます。これは全体を書き直してもらうより効果的です。なぜなら、skill が WendyOS 全体を説明し直すのではなく、詰まっている箇所だけに焦点を当てられるからです。