wendy-contributing

wendy-contributing 技能概覽

wendy-contributing 是一份聚焦的指南，專門給那些在 WendyOS 與其周邊工具鏈上做貢獻的人，特別適用於會碰到 Yocto builds、wendy-agent、E2E tests，或平台特定 OS 行為的任務。它能幫你從「我需要改 WendyOS 的某個地方」一路對應到實際要看的 repo 區塊、build 流程，以及真正重要的驗證步驟。

這個 wendy-contributing 技能適合誰

如果你在處理 WendyOS images、meta-wendyos layers、bitbake recipes、bbappend 變更、agent 內部機制，或像 mDNS/Avahi、device identity 這類 service 行為，就很適合使用 wendy-contributing skill。當 backend work 會依賴 OS 如何打包、執行或對外提供服務時，wendy-contributing 對 Backend Development 也特別有關聯。

它能幫你完成什麼

它真正要解決的不是一般 Linux 問題，而是在受限制的 embedded OS stack 裡做出安全、可審查的變更。這個 skill 會幫你理解 WendyOS 是怎麼組裝起來的、wendy-agent 的行為模式，以及在假設改動正確之前，該怎麼先驗證它。

它和一般做法有什麼不同

不同於泛用型 prompt，wendy-contributing 會提供一條帶有明確判斷的工作路徑：先看架構，再看 build system，最後做測試。這點很重要，因為 Yocto 和 agent 相關變更常常不是你一開始碰到的那段 code 出問題，而是卡在看不見的相依關係或建置條件上。

如何使用 wendy-contributing 技能

安裝並指向正確的任務

用 npx skills add Joannis/claude-skills --skill wendy-contributing 安裝 wendy-contributing skill。接著，只有在你的需求可以明確描述成 WendyOS 的貢獻任務時再使用它，而不是拿來問很泛的「解釋 Linux」。

提供正確的輸入格式

好的輸入會清楚描述目標區域、裝置類型，以及你想達成的結果。例如：「請更新 meta-wendyos-rpi recipe，讓 wendy-agent 在 Raspberry Pi 5 上用新的環境變數啟動，並告訴我這個 image 需要測哪些項目。」這會比「修好啟動」有效得多。

依正確順序閱讀來源內容

先從 SKILL.md 開始，再視 skill package 內是否有對應檔案，去看 yocto-meta-layers.md、system-internals.md 和 raspberry-pi.md。這些路徑會告訴你，這次變更到底是關於 layer 選擇、runtime 行為，還是裝置特定限制。

採用 WendyOS-aware 的工作流程

一個好的 wendy-contributing 使用流程是：先辨識子系統，再確認目標 layer 或 service，接著寫出最小變更，最後再請求對應的 build 或 E2E 檢查。若是和 backend 相鄰的工作，請一併說明 OS 端行為應該如何影響 API calls、container lifecycle，或 service discovery，這樣輸出才會貼近真實 runtime。

wendy-contributing 技能 FAQ

wendy-contributing 只適合 OS 工程師嗎？

不是。對於需要理解 WendyOS runtime 行為，或需要知道自己的 service 如何依賴 OS packaging 的 backend、platform、infrastructure 開發者來說，它同樣有用。如果你的變更同時跨到 app code 與 device 行為，這個 skill 會很合適。

什麼情況下不該用它？

不要把 wendy-contributing 用在一般 Yocto 教學、不相關的 Linux 管理工作，或是沒有 WendyOS 依賴的普通應用除錯上。如果問題不在 WendyOS 的 build、agent 或 device stack 之內，通常用一般 prompt 就夠了。

這比直接問模型更好嗎？

如果任務依賴 WendyOS 的特定慣例，那答案是肯定的。wendy-contributing 指南能降低你對 image targets、agent 行為、驗證預期的猜測，而這些正是一般 prompt 最常說得含糊或不完整的地方。

這個 skill 對新手友善嗎？

如果你能清楚描述一個具體變更需求，而且願意在修改前先讀相關的連結 context files，那它對新手是友善的。若你需要從零開始的完整 embedded Linux 入門，它就沒那麼有幫助。

如何改進 wendy-contributing 技能

提供精確的目標與平台

當你把平台說清楚，例如 Jetson、Raspberry Pi 4/5，或 ARM64 VM，再加上預期要動到的 layer 或 component，效果最好。像「修正 edgeos-rpi-image 的 service 啟動」就比「讓 WendyOS 可以正常運作」更有可操作性。

加上可觀察的成功標準

告訴 skill 什麼才算完成：boot 成功、agent 在 50051 port 對外提供 gRPC、E2E test 通過，或某個 package 出現在 image 裡。這能幫助 wendy-contributing 優先聚焦在驗證，而不是只給你 code edit 建議。

盡早說明限制條件

如果你的 build 環境有限、沒有硬體可測，或必須避免 image size 增加，請一開始就講清楚。這些限制會實質影響最佳的 wendy-contributing 使用路徑，以及建議的測試策略。

從 build 一路迭代到 runtime

拿到第一個答案後，可以再補上 build logs、失敗的 test output，或你實際修改的檔案。最有用的追問，通常是請它指出下一步診斷方向、最可能的原因，或最小修正方式，而不是再把整個系統重講一遍。