wendy

Visão geral da skill wendy

Para que serve a skill wendy

A skill wendy ajuda você a trabalhar com dispositivos de borda do WendyOS por meio da CLI wendy, desde a configuração inicial até a implantação e o gerenciamento remoto. Ela é mais indicada para desenvolvedores que precisam de um guia prático de Wendy para criar projetos, executar apps, descobrir dispositivos e enviar alterações para hardware compatível.

Quem deve usar

Use a skill wendy se você estiver mirando dispositivos NVIDIA Jetson ou Raspberry Pi 4/5, ou se estiver desenvolvendo em VMs ARM64/AMD64 antes de implantar em hardware com WendyOS. Ela também é útil quando você precisa de um fluxo de implantação para apps Swift em dispositivos de borda e quer menos incerteza sobre os comandos CLI corretos.

O que a diferencia

Ao contrário de um prompt genérico sobre implantação em sistemas embarcados, a skill wendy é centrada na toolchain wendy e no estilo de comandos orientado a JSON. Isso faz diferença se você quer saída estruturada, menos prompts interativos e um fluxo que vai de forma limpa do desenvolvimento local à implantação no dispositivo.

Como usar a skill wendy

Comece com o contexto certo de instalação

Use a skill em um repositório em que a tarefa esteja claramente relacionada ao WendyOS, à configuração do dispositivo ou à implantação do app. Se você estiver usando um gerenciador de skills, instale a wendy com o caminho do repositório que aponta para a pasta da skill e, depois, carregue a skill antes de pedir comandos, passos de dispositivo ou orientação de implantação. Para melhores resultados, mantenha o prompt focado em um único objetivo, como wendy install, wendy usage ou wendy for Deployment.

Dê à wendy as entradas de que ela precisa

A skill wendy funciona melhor quando você informa o dispositivo de destino, o tipo de app e a etapa atual do processo. Um pedido forte seria: “Tenho um app Swift para um Raspberry Pi 5 com WendyOS. Mostre os comandos wendy de que preciso, os campos esperados do wendy.json e o fluxo de implantação mais seguro.” Um pedido fraco seria apenas “me ajuda a implantar”, porque isso deixa a skill livre para inferir hardware, formato do projeto e padrão de saída.

Leia os arquivos centrais primeiro

Comece com SKILL.md e depois consulte qualquer referência vinculada de wendy.json.md antes de tentar comandos. Se sua cópia local incluir apenas o arquivo da skill, trate isso como a fonte de verdade para os fluxos suportados: wendy init, wendy run, wendy discover, configuração de WiFi do dispositivo, atualização do agent e instalação do sistema operacional. Para deixar o uso mais claro, confirme se a tarefa espera saída em JSON, já que a skill prefere explicitamente saída estruturada de comandos para evitar diálogos interativos.

Use um fluxo que combine com a implantação

Um padrão confiável é: definir o dispositivo de destino, executar a descoberta, confirmar o estado do dispositivo, criar ou validar wendy.json e então executar o comando relevante com a saída em JSON ativada. Se você estiver pedindo um plano de implantação, diga se precisa de configuração inicial, implantação repetível no estilo CI ou depuração remota em ARM64. Essa distinção muda a sequência de comandos e o nível de preparação necessário no dispositivo.

Perguntas frequentes sobre a skill wendy

A wendy é só para WendyOS?

Sim, a skill wendy é específica para WendyOS e para o fluxo de trabalho dos seus dispositivos. Se o seu projeto não estiver mirando WendyOS, um prompt genérico de implantação ou outra skill específica da plataforma normalmente vai se encaixar melhor.

Preciso já conhecer a CLI wendy?

Não, mas você deve saber qual é o hardware de destino e o que quer fazer. A skill wendy é útil para transformar uma meta aproximada em etapas exatas de wendy usage, especialmente quando você precisa evitar o comportamento interativo dos comandos ou suposições sobre flags.

Quando não devo usar a skill wendy?

Não use para aconselhamento geral sobre Linux embarcado que não tenha relação com WendyOS, nem para sistemas de implantação que não usam a CLI wendy. Ela também não é uma boa opção se você só precisa de uma visão conceitual de alto nível e não pretende executar comandos.

Ela é boa para iniciantes?

Sim, desde que o iniciante já tenha em mente um alvo com WendyOS. A skill é prática, mas pressupõe que você consiga nomear a classe do dispositivo, a linguagem do projeto e o objetivo da implantação para que a resposta seja específica, e não genérica.

Como melhorar a skill wendy

Dê à skill um alvo de implantação concreto

A forma mais rápida de melhorar a saída é especificar exatamente o dispositivo e o ambiente: dispositivo de produção Jetson, unidade de teste Raspberry Pi ou VM usada para desenvolvimento. Assim, a skill wendy consegue afunilar o fluxo, evitar etapas irrelevantes e focar no caminho certo de instalação ou implantação.

Inclua a forma do seu projeto e as restrições

Diga à skill se você está começando do zero, atualizando um projeto Wendy Lite existente ou integrando Wendy a um app Swift. Também mencione restrições como “precisa ser não interativo”, “exige saída em JSON” ou “tem que funcionar com depuração remota em ARM64”. Esses detalhes mudam materialmente os comandos e ajudam o guia wendy a evitar suposições inseguras.

Peça as partes que faltam, não só os comandos

Se a primeira resposta vier ampla demais, peça os campos exatos do wendy.json, o fluxo mínimo válido de wendy init ou a sequência de wendy run para o seu dispositivo. Para tarefas de implantação, o melhor acompanhamento costuma ser uma checagem de pré-requisitos, descoberta do dispositivo e confirmação de se o pacote do app ou as definições de entitlement precisam de ajuste.

Itere resolvendo um erro por vez

Quando a saída da wendy não funcionar, informe o comando exato, o tipo de dispositivo e a mensagem de erro. Depois peça um comando corrigido ou um caminho mínimo de reprodução. Isso produz resultados melhores do que pedir uma reescrita completa, porque a skill consegue atacar o passo que está bloqueando em vez de reexplicar todo o processo do WendyOS.