Communitygithub.com

SEKAI-SEEK/wechat-starter

초보자 친화적인 Agent Skill로, 아이디어부터 DevTools 미리보기까지 네이티브 WeChat 미니 프로그램과 미니 게임을 처음부터 구축합니다.

wechat-starter란 무엇인가요?

이 Agent Skill은 WeChat 미니 프로그램 또는 미니 게임 개발을 처음 시작하는 사용자가 아이디어만 가지고도 WeChat DevTools에서 바로 실행 가능한 미리보기를 만들 수 있도록 안내합니다. 사용자 모드를 '초보자 모드(기본값)'와 '개발자 모드' 중에서 선택할 수 있으며, 각 단계별로 가르치기(Teach), 실행하기(Do), 확인하기(Verify), 복구하기(Recover), 기록하기(Record)의 5단계 루프를 따라 진행됩니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 동작하며, 안전 규칙을 통해 API 키나 개인 정보가 노출되지 않도록 보호합니다. 또한 Git 체크포인트를 로컬에만 생성하고, 사용자 확인 없이는 외부로 푸시하거나 제출하지 않습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add SEKAI-SEEK/wechat-starter

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

WeChat Starter

아이디어만 가지고 있는 첫 번째 개발자가 실제로 작동하는 WeChat DevTools 미리보기까지 도달할 수 있도록 도와줍니다. 사용자가 각 단계를 시작할 시점을 제어할 수 있게 하고, 승인된 단계를 처음부터 끝까지 완료한 후에 다음 지시를 기다리세요.

운영 계약

기본적으로 초보자 모드로 설정합니다. 사용자가 설명을 덜 요구하거나 기본적인 컴퓨터, Git, JavaScript 개념에 이미 익숙함을 보여줄 경우에만 개발자 모드로 전환하세요.

모든 단계에서 다음 루프를 따르세요:

  1. 가르치기: 즉각적인 목표를 설명하고 각각의 새로운 용어를 한 문장으로 정의합니다.
  2. 실행하기: 안전하게 완료할 수 있는 코드 및 파일 시스템 작업을 수행하고, 사용자만 수행할 수 있는 DevTools 또는 계정 단계는 한 번에 하나의 작은 작업 그룹으로 제공합니다.
  3. 확인하기: 성공을 증명하는 정확한 시각적 결과, 명령 출력 또는 동작을 명시합니다.
  4. 복구하기: 확인에 실패하면 한 번에 하나의 증거 기반 원인을 진단하고 재시도합니다.
  5. 기록하기: 단계 진행 상황을 업데이트하고 게이트에 도달하면 로컬 Git 체크포인트를 생성합니다.

한 번에 세 개 이상의 필수 질문을 하지 마십시오. 사용자가 관련 단계에 도달하기 전에 전체 튜토리얼을 한 번에 모두 보여주지 마십시오.

사용자의 언어와 일치하세요. 사용자가 중국어를 작성하면 간결한 간체 중국어로 가르치고, 인식을 위해 도움이 되는 경우에만 처음 사용 시 영어 플랫폼 용어를 표시합니다. 개발자 모드는 설명을 줄일 수 있지만 안전 또는 승인 게이트를 약화시켜서는 안 됩니다.

안전 규칙

  • 편집하기 전에 AGENTS.md, 저장소 상태, 기존 파일 및 현재 지침을 검사하십시오.
  • 관련 없는 사용자 작업을 덮어쓰거나, 되돌리거나, 삭제하거나, 커밋하지 마십시오.
  • API 키, AppSecret 값, 비밀번호, 토큰, 개인 인증서, CloudBase 자격 증명, 개인 자료 또는 라이선스가 없는 이미지를 노출하거나 커밋하지 마십시오.
  • 재사용 가능한 예제에서는 <WECHAT_APP_ID> 및 <CLOUDBASE_ENV_ID>와 같은 명시적 플레이스홀더를 사용하십시오.
  • 사용자의 로컬 프로젝트에서 필수 AppID 및 환경 식별자를 비공개로 구성할 수 있도록 허용하십시오. 사용자에게 채팅에 붙여넣거나, 공개 출력에 표시하거나, 이 Skill 저장소에 복사하도록 요청하지 마십시오.
  • project.private.config.json, .env*, 개인 키, 로컬 계정 데이터 및 식별자가 포함된 스크린샷을 기본적으로 비공개로 취급하십시오. AppSecret 및 서버 자격 증명은 미니 프로그램 또는 미니 게임 프론트엔드 코드에 절대 입력되어서는 안 됩니다.
  • 사용자 소유, 명확한 라이선스, 퍼블릭 도메인 또는 새로 생성된 자산만 사용하십시오. 자산이 나중에 게시될 수 있는 경우 출처를 기록하십시오.
  • 계정 로그인, 권한 부여, 개인정보 결정, 파괴적 변경 또는 현재 프로젝트 외부의 모든 작업 전에 확인을 요청하십시오.
  • Git을 로컬로 유지하십시오. 푸시, 풀 리퀘스트 생성, 릴리스 게시, WeChat에 제출 또는 플랫폼 검토 흐름에 진입하지 마십시오.

자격 증명, 클라우드 서비스, 외부 자산 또는 사용자 데이터를 추가하기 전에 references/security.md를 읽으십시오.

차단 조건

다음과 같은 경우 현재 단계를 중지하고 다음 단일 조치를 설명하십시오:

  • 대상 디렉토리를 알 수 없거나, 승인된 작업 공간 외부에 있거나, 안전하게 분리할 수 없는 관련 없는 작업이 포함된 경우.
  • 사용자가 첫 번째 미리보기 개요를 승인하지 않은 경우.
  • 최종 미리보기에 사용자가 완료하지 않은 AppID 또는 DevTools 로그인이 필요한 경우.
  • 요청된 기능에 프론트엔드 코드의 비밀, 라이선스가 없는 자산, 공개되지 않은 개인 데이터 수집 또는 확인 없는 파괴적 작업이 필요한 경우.
  • 컴파일, 런타임, 리소스 또는 상호 작용 실패가 현재 게이트에서 해결되지 않은 상태로 남아 있는 경우.

발명된 자격 증명, 가짜 성공 주장 또는 홍보용 스크린샷으로 차단기를 우회하지 마십시오.

경로 선택

요구 사항 수집 후 정확히 하나의 기본 경로를 선택하십시오:

사용자가 명시적으로 요청하거나 기존 저장소가 이미 의존하는 경우에만 프레임워크를 사용하십시오. 승인된 요구 사항에 원격 데이터, 클라우드 함수, 스토리지, 인증 또는 AI 서비스가 필요한 경우에만 CloudBase를 활성화하고 references/cloudbase.md를 읽으십시오.

단계 진행 상황 표시

응답당 한 번씩, 가급적 단계가 변경될 때는 시작 부분에, 그 외에는 끝 부분에 이 간결한 상태를 표시하십시오:

WeChat Starter | <초보자|개발자> | <미니 프로그램|미니 게임>
단계 <0-6>: <단계 이름>
상태: <대기 중|작업 중|차단됨|통과>
다음 게이트: <하나의 관찰 가능한 결과>

새 대상 프로젝트에 assets/templates/ 아래의 템플릿을 사용하여 codex_showcase/ 폴더를 하나 만드십시오. 프로젝트 개요, 단계 진행 상황, 증거 및 미리보기 체크리스트로만 제한하십시오.

단계 0: 환경 준비

references/beginner-onboarding.md을 읽으십시오. 다음을 확인하십시오:

  • WeChat 계정 및 올바른 미니 프로그램 또는 미니 게임 등록 경로.
  • 사용자에게 개인 자격 증명을 채팅에 붙여넣도록 요청하지 않고 AppID 사용 가능 여부.
  • WeChat DevTools 설치 및 로그인.
  • 안전한 절대 경로가 있는 전용 프로젝트 디렉토리.
  • Git 사용 가능 여부 및 디렉토리가 이미 저장소인지 여부.

사용자 전용 작업을 한 번에 하나의 그룹으로 제공하십시오. DevTools가 열리고 로컬 작업 공간이 알려진 경우에만 이 게이트를 통과하십시오.

재사용 가능한 프로젝트에 조작된 AppID를 작성하지 마십시오. DevTools가 현재 문서화된 테스트 모드를 지원하는 경우 그 한계를 설명하고, 그렇지 않으면 사용자가 DevTools 내에서 자신의 로컬 AppID를 선택하도록 하십시오.

단계 1: 첫 번째 버전 잠그기

한 문장으로 된 아이디어를 받아들이십시오. 결정하는 데 필요한 것만 물어보십시오:

  • 미니 프로그램 또는 미니 게임.
  • 대상 사용자 및 하나의 핵심 결과물 또는 게임 플레이 루프.
  • 첫 번째 미리보기에 로컬 전용 데이터로 충분한지 여부.

요구 사항을 '첫 번째 미리보기'와 '나중에'로 분할하십시오. 첫 번째 실행 가능한 루프를 방해하는 범위는 거부하십시오. codex_showcase/project-brief.md를 작성하고 구현 전에 명시적인 사용자 확인을 기다리십시오.

사용자가 하나의 기본 흐름과 명확한 범위 외 목록이 포함된 개요를 승인하면 이 게이트를 통과하십시오.

단계 2: 스캐폴딩 및 컴파일

파일을 만들기 전에 작업 공간을 검사하십시오. 선택한 경로에 대해 가장 작은 네이티브 프로젝트 스켈레톤을 빌드하십시오. 가능한 경우 실제 계정 식별자를 로컬/비공개 구성에 보관하고 소스 코드에 절대 비밀을 두지 마십시오.

WeChat DevTools에서 프로젝트를 열거나 가져오십시오. 기능을 추가하기 전에 구성, 진입점, 경로 및 구문 오류를 해결하십시오.

첫 번째 깨끗한 컴파일 후에만 'scaffold' 로컬 Git 체크포인트를 생성하십시오.

단계 3: 수직 슬라이스 구축

범위를 확장하기 전에 하나의 완전한 사용자 여정을 구현하십시오:

  • 미니 프로그램 예시: 페이지 열기 -> 데이터 입력 또는 선택 -> 작업 트리거 -> 유지 또는 계산된 결과 보기.
  • 미니 게임 예시: 장면 진입 -> 핵심 상호 작용 수행 -> 피드백 받기 -> 결과 도달 또는 재시작 상태.

UI를 기능적이고 읽기 쉽게 유지하십시오. 이 루프가 작동하기 전에 보조 페이지, 정교한 애니메이션, 소셜 시스템, 수익 창출 또는 클라우드 인프라를 구축하지 마십시오.

사용자가 DevTools에서 루프를 작동할 수 있을 때만 'vertical-slice' 로컬 Git 체크포인트를 생성하십시오.

단계 4: 승인된 기능 완성

승인된 첫 번째 미리보기 기능만 구현하십시오. 상태, 스토리지, 오디오, 자산, 네트워크 액세스 및 CloudBase를 점진적으로 추가하십시오. 각 추가 후에 핵심 흐름을 다시 실행하고 해당 변경으로 도입된 개념만 설명하십시오.

렌더링, 입력 및 상태 계산을 일관되게 유지하십시오. Canvas 프로젝트의 경우 장치 픽셀 비율, 디자인 좌표, 안전 영역 및 터치 히트 영역을 함께 확인하십시오.

단계 5: 미리보기 강화

references/preview-gates.md을 읽으십시오. 최소한 다음을 확인하십시오:

  • 깨끗한 컴파일 및 해결되지 않은 콘솔 오류 없음.
  • 진입점, 구성, 경로 및 리소스 경로.
  • 핵심 상호 작용, 빈/로딩/오류 상태, 재시작 또는 복구 동작.
  • 대표 시뮬레이터 크기의 화면 적응 및 터치 대상.
  • 사용 시 로컬 스토리지 및 CloudBase 실패 동작.
  • 사용 시 오디오 라이프사이클 및 자산 로딩.
  • 패키지/리소스 예산 및 개인 또는 소스 전용 파일의 우발적 포함.
  • 미리보기 소스에 디버그 백도어, 테스트 비밀번호, 비밀 또는 개인 자료 없음.

자동화된 확인 결과가 녹색이라고 해서 미리보기가 성공한 것으로 간주하지 마십시오. 시각적 및 상호 작용 증거가 필요합니다.

단계 6: DevTools 미리보기 승인

마지막 미리보기 실행을 통해 사용자를 안내하십시오. 다음 모두를 요구하십시오:

  1. DevTools가 오류 없이 컴파일됩니다.
  2. 기본 흐름이 처음부터 끝까지 작동 가능합니다.
  3. 필요한 구성, 리소스 및 패키지 검사가 통과합니다.
  4. 스크린샷 또는 간결한 관찰 기록이 미리보기 결과를 기록합니다.
  5. 사용자가 명시적으로 승인을 확인합니다.

codex_showcase/preview-checklist.md를 업데이트하고 'preview-ready' 로컬 Git 체크포인트를 생성하십시오. 여기서 멈추십시오. 업로드, 제출, 검토 또는 릴리스를 계속하지 마십시오.

스크린샷 및 오류 진단

사용자가 스크린샷, 콘솔 출력, 컴파일 실패, 빈 화면, 누락된 자산 또는 잘못된 상호 작용을 공유할 때마다 references/troubleshooting.md을 읽으십시오.

가장 작은 유용한 증거를 수집하십시오:

  • 현재 단계 및 경로.
  • 의역이 아닌 정확한 오류 텍스트.
  • 가능한 경우 개인 식별자가 편집된 스크린샷.
  • 관련 파일 및 실패 전의 마지막 작업.

문제를 환경, 구성, 코드, 리소스, 런타임, 레이아웃/입력, 클라우드 또는 권한으로 분류하십시오. 하나의 테스트 가능한 가설을 세우고, 가장 작은 안전한 변경을 수행한 후 실패한 확인 단계를 반복하십시오.

참조 맵

관련 스킬