wendy

wendy skill 概覽

wendy skill 是做什麼的

wendy skill 會協助你透過 wendy CLI 來操作 WendyOS 邊緣裝置，涵蓋從初始設定、部署到遠端管理的完整流程。它最適合需要一份實用的 Wendy 指南、用來建立專案、執行應用程式、探索裝置，並把變更推送到受支援硬體的開發者。

適合哪些人使用

如果你的目標是 NVIDIA Jetson 或 Raspberry Pi 4/5 裝置，或是你正在 ARM64/AMD64 VM 上開發、之後才要部署到 WendyOS 硬體，就很適合使用 wendy skill。當你需要一套適用於邊緣裝置上的 Swift 應用部署流程，而且希望少一些對正確 CLI 指令的猜測時，它也很有幫助。

它有什麼不同

和那種泛用的嵌入式部署提示不同，wendy skill 是以 wendy 工具鏈與其 JSON 驅動的指令風格為核心。這一點很重要，因為你若想要結構化輸出、減少互動式提示，並讓本機開發到裝置部署的流程能自然銜接，這套方式會更合適。

如何使用 wendy skill

先選對安裝情境

請在任務明確與 WendyOS、裝置設定或應用部署相關的 repo 中使用這個 skill。若你是透過 skill manager 使用，請用指向 skill 資料夾的 repository path 來安裝 wendy，然後在詢問指令、裝置步驟或部署建議之前先載入 skill。為了得到最佳結果，請把 prompt 聚焦在單一目標上，例如 wendy install、wendy usage 或 wendy for Deployment。

提供 wendy 需要的輸入

wendy skill 最好搭配明確的目標裝置、應用類型，以及你目前所處的階段來使用。一個好的提問會像這樣：『我有一個要部署到 WendyOS 上 Raspberry Pi 5 的 Swift app。請列出我需要的 wendy 指令、預期的 wendy.json 欄位，以及最安全的部署流程。』如果只說『幫我部署』，效果就會比較差，因為 skill 必須自行推測硬體、專案樣貌與輸出格式。

先讀核心檔案

先從 SKILL.md 開始，再查看任何連結的 wendy.json.md 參考內容，然後再試著下指令。如果你的本機副本只有 skill 檔，就把它視為支援工作流程的權威來源：wendy init、wendy run、wendy discover、裝置 WiFi 設定、agent 更新，以及 OS 安裝。為了讓使用方式更清楚，請先確認任務是否預期輸出 JSON，因為這個 skill 明確偏好結構化的指令輸出，以避免互動式對話框。

使用符合部署情境的工作流程

一個可靠的流程是：先定義裝置目標、執行 discovery、確認裝置狀態、建立或驗證 wendy.json，再以啟用 JSON 輸出的方式執行對應指令。如果你是在詢問部署計畫，請說明你需要的是首次設定、可重複的 CI 風格部署，還是 ARM64 上的遠端除錯。這個差異會影響指令順序，以及需要多少裝置前置作業。

wendy skill 常見問題

wendy 只適用於 WendyOS 嗎？

是的，wendy skill 是專門給 WendyOS 與其裝置工作流程使用的。如果你的專案不是以 WendyOS 為目標，通常用泛用的部署提示或其他平台專屬 skill 會更合適。

我需要先會用 wendy CLI 嗎？

不需要，但你至少要知道目標硬體是什麼，以及你想完成什麼。wendy skill 很適合把模糊目標轉成精確的 wendy usage 步驟，尤其是在你想避開互動式指令行為，或不想自己猜 flags 的時候。

什麼情況下不該用 wendy skill？

如果是與 WendyOS 完全無關的一般嵌入式 Linux 建議，或是不使用 wendy CLI 的部署系統，就不適合使用它。如果你只需要高層次的概念性總覽，而且沒有打算真的執行指令，它也不是理想選擇。

初學者適合用嗎？

適合，只要初學者已經有明確的 WendyOS 目標裝置。這個 skill 很實用，但它預設你能說出裝置類型、專案語言與部署目標，這樣輸出才能具體，而不是停留在泛泛而談。

如何改進 wendy skill

給 skill 一個具體的部署目標

要最快改善輸出，最有效的方法就是指定精確的裝置與環境：Jetson 生產裝置、Raspberry Pi 測試機，或是拿來開發用的 VM。這樣 wendy skill 就能縮小工作流程範圍、避開無關步驟，並把重點放在正確的安裝或部署路徑上。

補充你的專案型態與限制

請告訴 skill 你是從零開始、在更新既有的 Wendy Lite 專案，還是要把 Wendy 整合進一個 Swift app。也請註明限制，例如「必須非互動式」、「需要 JSON 輸出」或「必須可透過 ARM64 遠端除錯」。這些細節會實質影響指令內容，也能幫助 wendy 指南避免做出不安全的假設。

要求缺少的內容，不只是指令

如果第一次得到的結果太寬泛，請進一步要求精確的 wendy.json 欄位、最小可行的 wendy init 流程，或適用於你裝置的 wendy run 序列。對部署工作來說，最好的追問通常是先檢查前置條件、裝置 discovery，以及 app package 或 entitlement 設定是否需要調整。

一次只修正一個失敗點來迭代

當 wendy 的輸出無法運作時，請回報確切的指令、裝置類型與錯誤訊息，然後要求修正後的指令或最小重現路徑。這樣通常比要求整份重寫更有效，因為 skill 可以直接針對卡住的步驟處理，而不是重新解釋整個 WendyOS 流程。