wendy
작성자 JoannisWendyOS 엣지 디바이스에서 앱을 빌드, 배포, 관리하기 위한 wendy 기술 가이드입니다. wendy 설치, 사용법, 디바이스 검색, Swift 앱 배포, ARM64 원격 디버깅, NVIDIA Jetson 또는 Raspberry Pi 4/5 워크플로가 필요할 때 유용합니다. 추측보다 구조화된 JSON 우선 CLI 단계가 필요할 때 가장 잘 맞습니다.
이 스킬은 100점 만점에 79점으로, WendyOS 관련 도움이 필요한 디렉터리 사용자에게 충분히 유력한 후보입니다. 리포지토리는 일반적인 프롬프트보다 훨씬 덜 추측하게 해 주는 실행 단서와 워크플로 세부 정보를 제공하지만, 완전히 독립적인 툴체인이라기보다 WendyOS 명령 동작에 어느 정도 의존한다는 점은 감안해야 합니다.
- Wendy/WendyOS, wendy CLI, wendy.json, 엣지 배포, Swift ARM64 디버깅, Jetson/Raspberry Pi 사용 사례까지 명확한 트리거 범위를 제공합니다.
- 실행 지침에 `wendy --experimental-dump-help`, `wendy run`, `wendy init` 같은 구체적인 명령과 디바이스/네트워크 관리 흐름이 포함되어 있습니다.
- 프런트매터가 유효하고 본문도 충분히 길며, 여러 개의 제목과 플레이스홀더 표시가 없어 단순한 스텁이 아니라 실제 워크플로 콘텐츠일 가능성이 높습니다.
- 설치 명령, 지원 파일, 참조된 보조 문서가 보이지 않아, 실제 도입은 거의 전적으로 단일 `SKILL.md` 파일에 의존합니다.
- 파일 발췌본에서는 미리보기에서 `wendy init` 섹션이 중간에서 잘려 있어, 완전성과 예외 처리까지 확인하려면 전체 스킬을 추가로 살펴봐야 할 수 있습니다.
wendy skill 개요
wendy skill은 무엇에 쓰나
wendy skill은 wendy CLI를 사용해 WendyOS 엣지 디바이스를 다루도록 도와줍니다. 초기 설정부터 배포, 원격 관리까지 한 흐름으로 이어지며, 프로젝트 생성, 앱 실행, 디바이스 탐색, 변경 사항 푸시를 실제로 해내야 하는 개발자에게 특히 잘 맞습니다.
누가 사용하면 좋은가
NVIDIA Jetson이나 Raspberry Pi 4/5를 대상으로 작업하거나, WendyOS 하드웨어에 배포하기 전에 ARM64/AMD64 VM에서 개발 중이라면 wendy skill이 유용합니다. 엣지 디바이스용 Swift 앱 배포 흐름이 필요하고, 어떤 CLI 명령을 써야 할지 덜 헤매고 싶을 때도 적합합니다.
무엇이 다른가
일반적인 임베디드 배포 프롬프트와 달리, wendy skill은 wendy 툴체인과 JSON 기반 명령 스타일에 초점을 맞춥니다. 구조화된 출력이 필요하고, 대화형 프롬프트는 줄이고 싶으며, 로컬 개발에서 디바이스 배포까지 흐름을 깔끔하게 연결하고 싶다면 이 차이가 중요합니다.
wendy skill 사용 방법
먼저 올바른 설치 맥락부터 잡기
이 skill은 WendyOS, 디바이스 설정, 앱 배포가 명확히 관련된 repo에서 사용할 때 가장 잘 맞습니다. 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, device WiFi setup, agent update, OS install이 여기에 해당합니다. 사용법을 더 분명히 하려면 JSON 출력이 필요한 작업인지도 확인하세요. 이 skill은 대화형 대화창을 피하기 위해 구조화된 명령 출력을 선호합니다.
배포에 맞는 워크플로를 쓰기
신뢰할 수 있는 기본 패턴은 이렇습니다. 대상 디바이스를 정의하고, discovery를 실행한 뒤, 디바이스 상태를 확인합니다. 그다음 wendy.json을 만들거나 검증하고, JSON 출력을 켠 상태로 필요한 명령을 실행합니다. 배포 계획을 요청할 때는 초기 설정이 필요한지, 반복 가능한 CI 스타일 배포가 필요한지, ARM64에서 원격 디버깅이 필요한지도 함께 말하세요. 이 차이에 따라 명령 순서와 디바이스 준비 수준이 달라집니다.
wendy skill FAQ
wendy는 WendyOS 전용인가요?
네, wendy skill은 WendyOS와 그 디바이스 워크플로를 위해 만들어졌습니다. 프로젝트가 WendyOS를 대상으로 하지 않는다면, 일반적인 배포 프롬프트나 다른 플랫폼 전용 skill이 더 잘 맞을 가능성이 큽니다.
wendy CLI를 이미 알고 있어야 하나요?
아니요. 다만 대상 하드웨어와 무엇을 하고 싶은지는 알고 있어야 합니다. wendy skill은 대략적인 목표를 정확한 wendy usage 단계로 바꾸는 데 유용하며, 특히 명령의 대화형 동작이나 플래그 추측을 피하고 싶을 때 효과적입니다.
언제는 wendy skill을 쓰지 말아야 하나요?
WendyOS와 관련 없는 일반적인 임베디드 Linux 조언에는 쓰지 마세요. 또한 wendy CLI를 사용하지 않는 배포 시스템에도 맞지 않습니다. 단순히 높은 수준의 개념 설명만 필요하고 실제 명령 실행 계획이 없다면, 이 skill은 좋은 선택이 아닙니다.
초보자에게도 괜찮나요?
WendyOS 대상이 이미 정해져 있다면 괜찮습니다. 이 skill은 실용적이지만, 출력이 너무 일반적이지 않게 하려면 디바이스 종류, 프로젝트 언어, 배포 목표를 말할 수 있어야 한다는 전제를 깔고 있습니다.
wendy skill 개선 방법
구체적인 배포 대상을 알려주기
출력을 가장 빨리 개선하는 방법은 정확한 디바이스와 환경을 지정하는 것입니다. 예를 들어 Jetson 프로덕션 장치인지, Raspberry Pi 테스트 장치인지, 아니면 개발용 VM인지 밝히세요. 그러면 wendy skill이 워크플로를 더 좁히고, 불필요한 단계를 빼고, 올바른 설치 또는 배포 경로에 집중할 수 있습니다.
프로젝트 형태와 제약 조건까지 함께 주기
처음부터 새로 시작하는지, 기존 Wendy Lite 프로젝트를 갱신하는지, 아니면 Wendy를 Swift 앱에 통합하는지 알려주세요. 여기에 “반드시 비대화형이어야 함”, “JSON 출력이 필요함”, “ARM64 원격 디버깅으로 동작해야 함” 같은 제약도 함께 적으면 좋습니다. 이런 정보는 명령을 실제로 바꾸며, wendy 가이드를 위험한 가정에서 벗어나게 해줍니다.
명령만 묻지 말고 빠진 부분도 같이 요청하기
첫 결과가 너무 넓다면, 정확한 wendy.json 필드, 가장 작은 유효한 wendy init 흐름, 또는 디바이스에 맞는 wendy run 순서를 물어보세요. 배포 작업이라면 보통 전제 조건, 디바이스 탐색, 앱 패키지나 entitlement 설정 조정이 필요한지 확인하는 후속 질문이 가장 유용합니다.
한 번에 한 가지 실패만 고치기
wendy 출력이 동작하지 않으면, 정확한 명령, 디바이스 종류, 오류 메시지를 그대로 전달하세요. 그런 다음 수정된 명령이나 최소 재현 경로를 요청하면 됩니다. 전체를 다시 써 달라고 하는 것보다 훨씬 좋은 결과가 나옵니다. 이 skill이 전체 WendyOS 과정을 다시 설명하는 대신, 막힌 지점만 정확히 겨냥할 수 있기 때문입니다.
