wendy-contributing

Visão geral do skill wendy-contributing

O wendy-contributing é um guia focado para quem contribui para o WendyOS e seu ecossistema de ferramentas, especialmente quando a tarefa envolve builds Yocto, wendy-agent, testes E2E ou comportamento do sistema operacional específico da plataforma. Ele ajuda você a sair de “preciso mudar alguma coisa no WendyOS” para os caminhos exatos do repositório, o fluxo de build e as etapas de validação que realmente importam.

Para quem este skill foi feito

Use o skill wendy-contributing se você estiver trabalhando em imagens do WendyOS, camadas meta-wendyos, receitas bitbake, mudanças em bbappend, internals do agente ou comportamento de serviços como mDNS/Avahi e identidade do dispositivo. Ele é especialmente relevante para wendy-contributing for Backend Development quando o trabalho de backend depende de como o sistema operacional empacota, executa ou expõe serviços.

O que ele ajuda você a fazer

A tarefa real não é obter ajuda genérica de Linux; é fazer mudanças seguras e revisáveis em uma stack de sistema embarcado com restrições. O skill ajuda você a entender como o WendyOS é montado, como o wendy-agent se comporta e como validar mudanças antes de assumir que estão corretas.

O que o torna diferente

Diferentemente de um prompt genérico, o wendy-contributing oferece um caminho opinativo pelo trabalho: primeiro arquitetura, depois sistema de build, depois testes. Isso importa porque mudanças em Yocto e no agente muitas vezes falham por motivos que não aparecem no trecho de código que você tocou inicialmente.

Como usar o skill wendy-contributing

Instale e aponte para a tarefa certa

Instale o skill wendy-contributing com npx skills add Joannis/claude-skills --skill wendy-contributing. Depois, use-o quando sua solicitação puder ser expressa como uma tarefa de contribuição para o WendyOS, e não como um pedido amplo para “explicar Linux”.

Dê a entrada no formato certo

Uma boa entrada descreve a área de destino, a classe do dispositivo e o resultado desejado. Por exemplo: “Atualize a receita em meta-wendyos-rpi para que o wendy-agent inicie com uma nova variável de ambiente no Raspberry Pi 5 e me diga o que testar na imagem.” Isso é muito melhor do que “conserte a inicialização”.

Leia a fonte na ordem certa

Comece com SKILL.md e, em seguida, examine os arquivos yocto-meta-layers.md, system-internals.md e raspberry-pi.md referenciados, se estiverem presentes no pacote do skill. Esses caminhos mostram se a mudança é sobre seleção de layer, comportamento em runtime ou restrições específicas do dispositivo.

Use um fluxo de trabalho consciente do WendyOS

Um bom fluxo de uso do wendy-contributing é: identificar o subsistema, confirmar a layer ou o serviço de destino, rascunhar a menor mudança possível e então pedir a verificação de build ou E2E relevante. Para trabalho próximo ao backend, inclua como o comportamento do lado do sistema operacional deve afetar chamadas de API, ciclo de vida de containers ou descoberta de serviços, para que a resposta fique ancorada no runtime real.

FAQ do skill wendy-contributing

O wendy-contributing é só para engenheiros de OS?

Não. Ele é útil para desenvolvedores de backend, plataforma e infraestrutura que precisam entender como o WendyOS se comporta em runtime ou como seu serviço depende do empacotamento do sistema operacional. Se sua mudança cruza código de aplicação e comportamento do dispositivo, este skill é uma boa escolha.

Quando não devo usá-lo?

Não use o wendy-contributing para tutoriais genéricos de Yocto, administração Linux sem relação com o projeto ou depuração comum de aplicações que não dependem do WendyOS. Se o problema estiver fora do build, do agente ou da stack de dispositivos do WendyOS, um prompt geral costuma bastar.

Isso é melhor do que perguntar diretamente a um modelo?

Sim, quando a tarefa depende de convenções específicas do WendyOS. O guia wendy-contributing reduz o chute sobre targets de imagem, comportamento do agente e expectativas de validação, que é justamente onde prompts genéricos costumam ficar vagos ou incompletos.

É amigável para iniciantes?

É amigável para iniciantes se você conseguir descrever uma mudança concreta e estiver disposto a ler os arquivos de contexto vinculados antes de editar. Ele é menos útil se você precisar de uma introdução completa a Linux embarcado do zero.

Como melhorar o skill wendy-contributing

Forneça o target e a plataforma exatos

Os melhores resultados aparecem quando você especifica a plataforma, como Jetson, Raspberry Pi 4/5 ou VM ARM64, além da layer ou do componente que espera tocar. “Corrija a inicialização do serviço em edgeos-rpi-image” é mais acionável do que “faça funcionar no WendyOS”.

Inclua critérios observáveis de sucesso

Diga ao skill como “pronto” se parece: o boot funciona, o agente expõe gRPC na porta 50051, um teste E2E passa ou um pacote aparece na imagem. Isso ajuda o wendy-contributing a priorizar validação em vez de sugerir apenas edições de código.

Compartilhe as restrições logo no início

Se você tem um ambiente de build limitado, sem acesso a hardware ou uma exigência de não aumentar o tamanho da imagem, diga isso logo de cara. Essas restrições mudam de forma relevante o melhor caminho de uso do wendy-contributing e a estratégia de teste recomendada.

Itere do build ao runtime

Depois da primeira resposta, refine com logs de build, saída de teste com falha ou o arquivo exato que você alterou. Os prompts de acompanhamento mais úteis pedem a próxima etapa de diagnóstico, a causa provável ou a correção mínima — não uma reexplicação ampla de todo o sistema.