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。为了获得最佳效果，把提问聚焦在单一目标上，例如 wendy install、wendy usage 或 wendy for Deployment。

提供 wendy 需要的输入

当你提供目标设备、应用类型和当前所处阶段时，wendy skill 的效果最好。一个好的请求可以这样写：“我有一个面向 WendyOS 上 Raspberry Pi 5 的 Swift 应用。请给出我需要的 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 应用。也请补充诸如“必须非交互式”“需要 JSON 输出”“必须通过 ARM64 远程调试工作”之类的限制。这些信息会实质性地改变命令，并帮助 wendy 指南避免不安全的假设。

追问缺失内容，而不只是要命令

如果第一次得到的结果太宽泛，就继续追问具体的 wendy.json 字段、最小可用的 wendy init 流程，或者适合你设备的 wendy run 顺序。对于部署工作，最有价值的后续问题通常是检查前置条件、设备发现，以及 app 包或 entitlement 设置是否需要调整。

一次只迭代一个失败点

当 wendy 的输出不可用时，请反馈准确的命令、设备类型和错误文本，然后再要求一个修正后的命令或最小复现路径。这样比要求整体重写更有效，因为 skill 可以直接定位阻塞步骤，而不是重新解释整个 WendyOS 流程。