wendy-contributing

wendy-contributing 스킬 개요

wendy-contributing은 WendyOS와 그 주변 도구에 기여할 때 필요한 핵심 가이드를 압축해 둔 스킬입니다. 특히 Yocto 빌드, wendy-agent, E2E 테스트, 또는 플랫폼별 OS 동작이 걸린 작업에서 유용합니다. “WendyOS에서 뭔가를 바꿔야 하는데 어디부터 봐야 하지?”라는 상태에서, 정확히 어떤 repo 영역을 봐야 하는지, 어떤 빌드 흐름을 따라야 하는지, 어떤 검증을 해야 하는지까지 이어지도록 도와줍니다.

이 스킬은 누구를 위한 것인가

WendyOS 이미지, meta-wendyos 레이어, bitbake recipe, bbappend 수정, agent 내부 동작, 또는 mDNS/Avahi와 device identity 같은 서비스 동작을 다루는 경우 wendy-contributing 스킬을 사용하세요. Backend Development에서 OS가 패키징, 실행, 서비스 노출을 어떻게 처리하는지에 따라 작업이 달라질 때도 특히 적합합니다.

무엇을 도와주는가

이 스킬의 진짜 목적은 일반적인 Linux 도움말을 주는 것이 아니라, 제약이 많은 embedded OS stack에서 안전하고 검토 가능한 변경을 만들게 하는 데 있습니다. WendyOS가 어떻게 조립되는지, wendy-agent가 어떻게 동작하는지, 그리고 변경이 맞는지 확인하기 전에 어떤 검증이 필요한지 이해하도록 돕습니다.

무엇이 다른가

일반적인 프롬프트와 달리 wendy-contributing은 작업을 따라가는 의견 있는 경로를 제공합니다. 먼저 아키텍처를 보고, 그다음 build system을 보고, 마지막으로 테스트를 보는 식입니다. Yocto나 agent 관련 변경은 처음 손댄 코드에서는 보이지 않는 이유로 실패하는 경우가 많기 때문에 이 순서가 중요합니다.

wendy-contributing 스킬 사용 방법

올바른 작업에 연결해 설치하기

npx skills add Joannis/claude-skills --skill wendy-contributing으로 wendy-contributing 스킬을 설치하세요. 그다음에는 요청을 WendyOS 기여 작업으로 표현할 수 있을 때 사용하고, 넓은 의미의 “Linux 설명” 요청에는 쓰지 마세요.

입력 형식을 제대로 주기

좋은 입력은 대상 영역, device class, 원하는 결과를 구체적으로 적습니다. 예를 들어 “meta-wendyos-rpi recipe를 수정해서 Raspberry Pi 5에서 wendy-agent가 새 환경 변수와 함께 시작되도록 하고, 이미지에서 무엇을 테스트해야 하는지도 알려줘”처럼요. 이것은 “startup을 고쳐줘”보다 훨씬 낫습니다.

소스는 올바른 순서로 읽기

먼저 SKILL.md를 읽고, skill package 안에 있다면 연결된 yocto-meta-layers.md, system-internals.md, raspberry-pi.md 파일을 확인하세요. 이 경로들은 변경이 layer 선택 문제인지, runtime behavior 문제인지, device-specific constraint 문제인지 구분하는 데 도움을 줍니다.

WendyOS를 고려한 workflow를 쓰기

좋은 wendy-contributing 사용 흐름은 다음과 같습니다. 서브시스템을 식별하고, 대상 layer나 service를 확인한 뒤, 가장 작은 변경안을 작성하고, 그다음에 필요한 build 또는 E2E 체크를 요청하세요. Backend와 연관된 작업이라면 OS 쪽 동작이 API 호출, container lifecycle, service discovery에 어떤 영향을 줘야 하는지도 함께 적어야 실제 runtime에 맞는 답을 받을 수 있습니다.

wendy-contributing 스킬 FAQ

wendy-contributing은 OS 엔지니어만 쓰는 건가요?

아닙니다. 런타임에서 WendyOS가 어떻게 동작하는지, 또는 자신의 서비스가 OS 패키징에 어떻게 의존하는지 이해해야 하는 backend, platform, infrastructure 개발자에게도 유용합니다. 앱 코드와 device 동작이 함께 바뀌는 작업이라면 이 스킬이 잘 맞습니다.

언제 쓰지 않는 게 좋나요?

일반적인 Yocto 튜토리얼, WendyOS와 무관한 Linux 관리, 또는 WendyOS 의존성이 없는 평범한 애플리케이션 디버깅에는 wendy-contributing을 쓰지 마세요. 문제가 WendyOS의 build, agent, device stack 바깥에 있다면 일반적인 프롬프트면 충분한 경우가 많습니다.

모델에 직접 묻는 것보다 나은가요?

WendyOS 고유의 관례가 중요한 작업이라면 그렇습니다. wendy-contributing 가이드는 image target, agent behavior, validation expectations에 대한 추측을 줄여 주는데, 바로 이 부분에서 일반 프롬프트는 자주 모호하거나 불완전해집니다.

초보자도 쓰기 쉬운가요?

구체적인 변경 요청을 설명할 수 있고, 수정하기 전에 연결된 context 파일을 읽을 의향이 있다면 초보자도 쓰기 쉽습니다. embedded Linux를 처음부터 전반적으로 배워야 하는 상황이라면 도움이 덜할 수 있습니다.

wendy-contributing 스킬 개선 방법

정확한 대상과 플랫폼을 알려주기

가장 좋은 결과는 Jetson, Raspberry Pi 4/5, ARM64 VM처럼 플랫폼을 명시하고, 함께 건드릴 것으로 예상되는 layer나 component까지 적을 때 나옵니다. “edgeos-rpi-image에서 service startup을 고쳐줘”는 “WendyOS에서 동작하게 해줘”보다 훨씬 실행 가능한 요청입니다.

눈에 보이는 성공 기준을 포함하기

boot 성공, wendy-agent가 port 50051에서 gRPC를 노출, E2E test 통과, image 안에 package가 포함됨처럼 “완료”의 기준을 알려주세요. 이렇게 해야 wendy-contributing이 단순한 code edit보다 검증을 우선하도록 도울 수 있습니다.

제약은 초기에 공유하기

빌드 환경이 제한적이거나, hardware 접근이 없거나, image size 증가를 피해야 한다면 처음부터 말하세요. 이런 제약은 wendy-contributing을 어떻게 쓰는 게 좋은지와 추천되는 test strategy를 실제로 바꿉니다.

build에서 runtime으로 이어가며 반복하기

첫 답변을 받은 뒤에는 build log, 실패한 test output, 또는 실제로 수정한 file을 기준으로 더 구체화하세요. 가장 유용한 후속 질문은 전체 시스템을 다시 설명해 달라는 요청이 아니라, 다음 진단 단계, 가능한 원인, 또는 최소 수정안에 대한 요청입니다.