wendy-contributing

wendy-contributing skill の概要

wendy-contributing は、WendyOS とその周辺ツールに貢献する人向けの実践ガイドです。特に、Yocto ビルド、wendy-agent、E2E テスト、あるいはプラットフォーム固有の OS 挙動に関わる作業で力を発揮します。「WendyOS の何かを変えたい」から、実際に見るべき repo 領域、ビルドの流れ、検証手順までを素早くつなげてくれる skill です。

この skill が向いている人

WendyOS イメージ、meta-wendyos レイヤー、bitbake レシピ、bbappend の変更、wendy-agent の内部実装、または mDNS/Avahi やデバイス ID のようなサービス挙動を扱うなら、wendy-contributing skill を使う価値があります。特に、Backend Development における wendy-contributing は、バックエンド側の変更が OS のパッケージング、起動、サービス公開の仕組みに依存している場合に有効です。

何を助けてくれるのか

本当に解くべき課題は、一般的な Linux の説明ではありません。制約のある組み込み OS スタックの中で、安全にレビュー可能な変更を作ることです。この skill は、WendyOS がどう組み立てられているか、wendy-agent がどう動くか、そして「正しいはず」と思い込む前にどう検証するかを理解する助けになります。

何が違うのか

汎用的な prompt と違い、wendy-contributing は作業の進め方に明確な方針があります。まずアーキテクチャ、次にビルドシステム、最後にテスト、という順番です。Yocto や agent の変更は、最初に触ったコードからは見えない理由で失敗することが多いため、この順序が重要になります。

wendy-contributing skill の使い方

インストールして、適切なタスクに向ける

npx skills add Joannis/claude-skills --skill wendy-contributing で wendy-contributing skill をインストールします。そのうえで、依頼内容が「WendyOS の貢献タスク」として表現できるときに使ってください。漠然と「Linux を説明して」と頼む用途ではありません。

入力は具体的な形で渡す

良い入力には、対象領域、デバイス種別、望ましい結果が含まれます。たとえば「Raspberry Pi 5 で wendy-agent が新しい環境変数付きで起動するように meta-wendyos-rpi の recipe を更新し、イメージで何をテストすべきか教えてほしい」のように書くと効果的です。「起動を直して」だけより、はるかに実用的です。

ソースは正しい順序で読む

まず SKILL.md を読み、その後、skill パッケージ内にあれば yocto-meta-layers.md、system-internals.md、raspberry-pi.md を確認します。これらの path は、変更が layer 選定の話なのか、runtime の挙動なのか、デバイス固有の制約なのかを見分ける手がかりになります。

WendyOS を意識したワークフローで使う

wendy-contributing の良い使い方は、まずサブシステムを特定し、次に対象の layer か service を確認し、最小限の変更案を作り、それから該当する build か E2E チェックを依頼する流れです。バックエンド寄りの作業では、OS 側の挙動が API 呼び出し、container lifecycle、service discovery にどう影響すべきかも含めると、出力が実際の runtime にしっかり結びつきます。

wendy-contributing skill の FAQ

wendy-contributing は OS エンジニア専用ですか？

いいえ。runtime における WendyOS の挙動や、サービスが OS のパッケージングにどう依存するかを理解したい backend、platform、infrastructure 開発者にも役立ちます。アプリコードとデバイス挙動の両方にまたがる変更なら、この skill は特に相性が良いです。

どんなときは使わないほうがいいですか？

一般的な Yocto のチュートリアル、WendyOS と無関係な Linux 管理、あるいは WendyOS 依存のない通常のアプリ不具合調査には wendy-contributing を使わないでください。問題が WendyOS の build、agent、device stack の外にあるなら、通常の prompt で足ります。

モデルに直接聞くより良いのはなぜですか？

WendyOS 固有の慣例が関わる作業では、こちらのほうが有利です。wendy-contributing ガイドは、image target、agent の挙動、検証の期待値についての推測を減らしてくれます。汎用 prompt では、そこが曖昧になったり、抜け落ちたりしがちです。

初心者でも使えますか？

具体的な変更依頼を説明できて、編集前にリンクされた context files を読む意欲があるなら、初心者でも使いやすいです。組み込み Linux をゼロから体系的に学びたい段階では、やや補助的な位置づけになります。

wendy-contributing skill をどう改善するか

対象とプラットフォームを正確に伝える

最も良い結果が出るのは、Jetson、Raspberry Pi 4/5、ARM64 VM のようなプラットフォームに加えて、触る予定の layer や component まで指定したときです。「edgeos-rpi-image の service 起動を直して」より、「WendyOS 上で動く edgeos-rpi-image の service 起動を直して」といった具体性のほうが、実行可能な提案につながります。

成功条件を観測可能な形で示す

skill には、「boot が成功する」「agent が port 50051 で gRPC を公開する」「E2E test が通る」「package が image に入る」など、完了条件をはっきり伝えてください。そうすると wendy-contributing は、コード修正だけでなく検証を優先して考えやすくなります。

制約は早めに共有する

ビルド環境が限られている、hardware にアクセスできない、image サイズを増やせない、といった条件があるなら最初に伝えてください。そうした制約は、wendy-contributing の最適な進め方や推奨する test strategy を大きく変えます。

build から runtime へ段階的に詰める

最初の回答のあとには、build logs、失敗した test output、あるいは変更した exact file を使ってさらに絞り込んでください。次の診断手順、原因の見立て、最小修正を聞く形の follow-up prompt が、システム全体の再説明よりずっと役立ちます。