wendy-contributing

Panorama general de wendy-contributing

wendy-contributing es una guía enfocada para personas que contribuyen a WendyOS y a su tooling alrededor, especialmente cuando la tarea toca compilaciones de Yocto, wendy-agent, pruebas E2E o comportamiento del sistema operativo específico de la plataforma. Te ayuda a pasar de “necesito cambiar algo en WendyOS” a las áreas exactas del repo, el flujo de build y los pasos de validación que importan.

Para quién es este skill

Usa el skill wendy-contributing si trabajas en imágenes de WendyOS, capas meta-wendyos, recetas de bitbake, cambios en bbappend, internals del agente o comportamiento de servicios como mDNS/Avahi y la identidad del dispositivo. Es especialmente relevante para wendy-contributing en Backend Development cuando el trabajo de backend depende de cómo el sistema operativo empaqueta, ejecuta o expone servicios.

Qué te ayuda a hacer

El trabajo real no es obtener ayuda general de Linux; es hacer cambios seguros y revisables en una pila de sistema embebido con restricciones. El skill te ayuda a entender cómo se ensambla WendyOS, cómo se comporta wendy-agent y cómo validar cambios antes de dar por hecho que son correctos.

Qué lo hace distinto

A diferencia de un prompt genérico, wendy-contributing te ofrece una ruta opinada por el trabajo: primero arquitectura, luego sistema de build y después pruebas. Eso importa porque los cambios en Yocto y en el agente a menudo fallan por razones que no se ven en el código que tocaste al principio.

Cómo usar el skill wendy-contributing

Instálalo y apúntalo a la tarea correcta

Instala el skill wendy-contributing con npx skills add Joannis/claude-skills --skill wendy-contributing. Luego úsalo cuando tu solicitud pueda expresarse como una tarea de contribución a WendyOS, no como una petición amplia de “explica Linux”.

Dale la forma de entrada correcta

Una buena entrada describe el área objetivo, la clase de dispositivo y el resultado deseado. Por ejemplo: “Actualiza la receta meta-wendyos-rpi para que wendy-agent arranque con una nueva variable de entorno en Raspberry Pi 5, y dime qué debo probar en la imagen”. Eso es mucho mejor que “arregla el arranque”.

Lee el origen en el orden correcto

Empieza con SKILL.md, y luego revisa los archivos yocto-meta-layers.md, system-internals.md y raspberry-pi.md si están presentes en el paquete del skill. Esas rutas te indican si el cambio va de selección de capa, comportamiento en tiempo de ejecución o restricciones específicas del dispositivo.

Usa un flujo de trabajo compatible con WendyOS

Un buen flujo de uso de wendy-contributing es: identificar el subsistema, confirmar la capa o servicio objetivo, redactar el cambio más pequeño posible y después pedir la compilación o comprobación E2E relevante. Para trabajo cercano al backend, incluye cómo debería afectar el comportamiento del lado del sistema operativo a las llamadas API, al ciclo de vida de contenedores o al descubrimiento de servicios para que la respuesta se mantenga anclada en el runtime real.

Preguntas frecuentes sobre el skill wendy-contributing

¿wendy-contributing es solo para ingenieros de sistemas operativos?

No. También es útil para desarrolladores de backend, plataforma e infraestructura que necesitan entender cómo se comporta WendyOS en tiempo de ejecución o cómo su servicio depende del empaquetado del sistema operativo. Si tu cambio cruza código de la app y comportamiento del dispositivo, este skill encaja bien.

¿Cuándo no debería usarlo?

No uses wendy-contributing para tutoriales genéricos de Yocto, administración Linux no relacionada o depuración normal de una aplicación que no tenga dependencia de WendyOS. Si el problema queda fuera del build, el agente o la pila de dispositivos de WendyOS, normalmente basta con un prompt general.

¿Es mejor que preguntar directamente a un modelo?

Sí, cuando la tarea depende de convenciones específicas de WendyOS. La guía wendy-contributing reduce la incertidumbre sobre objetivos de imagen, comportamiento del agente y expectativas de validación, justo donde los prompts genéricos suelen volverse vagos o incompletos.

¿Es apto para principiantes?

Sí, si puedes describir un cambio concreto y estás dispuesto a leer los archivos de contexto enlazados antes de editar. Es menos útil si necesitas una introducción completa a Linux embebido desde cero.

Cómo mejorar el skill wendy-contributing

Indica el objetivo exacto y la plataforma

Los mejores resultados llegan cuando especificas la plataforma, como Jetson, Raspberry Pi 4/5 o una VM ARM64, además de la capa o componente que esperas tocar. “Arregla el arranque del servicio en edgeos-rpi-image” es más accionable que “haz que funcione en WendyOS”.

Incluye criterios observables de éxito

Dile al skill cómo luce “terminado”: el arranque funciona, el agente expone gRPC en el puerto 50051, pasa una prueba E2E o aparece un paquete en la imagen. Esto ayuda a wendy-contributing a priorizar la validación en lugar de limitarse a sugerir ediciones de código.

Comparte las restricciones desde el principio

Si tienes un entorno de compilación limitado, no tienes acceso a hardware o necesitas evitar que la imagen crezca, dilo desde el inicio. Esas restricciones cambian de forma material la mejor ruta de uso de wendy-contributing y la estrategia de pruebas recomendada.

Itera del build al runtime

Después de la primera respuesta, afina con logs de compilación, salida de pruebas fallidas o el archivo exacto que cambiaste. Los seguimientos más útiles piden el siguiente paso de diagnóstico, la causa probable o la corrección mínima, en lugar de una reexplicación amplia de todo el sistema.