Communitygithub.com

Kappaemme-git/codex-phone-lab

실제 휴대폰에서 Expo/React Native 라이브 프리뷰를 통해 모바일 앱을 빌드하고 반복 개선합니다. Codex가 휴대폰 앱을 만들거나, iPhone/Android 앱 프로토타입을 제작하거나, 실제 기기에서 앱을 실행하거나, Expo Go용 QR 코드를 보여주거나, 모바일 개발 워크플로를 설정하거나, Xcode/TestFlight/앱 스토어 배포 없이 프롬프트를 라이브 모바일 앱으로 전환할 때 사용하세요.

codex-phone-lab란 무엇인가요?

이 스킬은 Codex가 제품 프롬프트를 실제 휴대폰에서 실행 가능한 React Native/Expo 앱으로 빠르게 전환할 수 있도록 설계되었습니다. 주된 목표는 시뮬레이터, 네이티브 빌드, TestFlight 또는 앱 스토어 배포를 고려하기 전에 '프롬프트 → 앱 → 휴대폰' 루프를 최적화하는 것입니다. 이 스킬은 SDK 54 템플릿을 사용하여 새 Expo 앱을 생성하고, Metro 번들러와 Expo Go를 통해 실제 기기에서 라이브 프리뷰를 제공합니다. 개발자는 LAN 모드(같은 네트워크) 또는 터널 모드(다른 네트워크)를 사용하여 QR 코드를 생성하고, 사용자는 Expo Go 앱으로 해당 QR을 스캔하여 앱을 즉시 열 수 있습니다. 이 스킬은 또한 앱이 모바일에 최적화된 UI(안전 영역, 실제 상호작용, 로딩/에러 상태)를 갖추도록 안내하며, 빠른 프로토타이핑과 분산 배포 결정(Expo Go QR, 개발 빌드, TestFlight, 앱 스토어)에 대한 명확한 지침을 제공합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Kappaemme-git/codex-phone-lab/tree/HEAD/skill

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

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

문서

Codex Phone Lab

이 스킬을 사용하여 제품 프롬프트를 사용자가 실제 휴대폰에서 Expo Go로 열 수 있는 React Native/Expo 앱으로 전환하세요. 시뮬레이터, 네이티브 빌드, TestFlight 또는 앱 스토어 배포를 고려하기 전에 빠른 "프롬프트 → 앱 → 휴대폰" 루프에 최적화하세요.

운영 모델

사용자가 명시적으로 네이티브 iOS/Android 모듈을 요구하지 않는 한 이 경로를 선호하세요:

  1. scripts/doctor.sh로 로컬 사전 요구 사항을 확인합니다.
  2. 모바일 프로젝트가 없으면 scripts/new-expo-app.sh <app-name>으로 Expo 앱을 생성합니다. 이 명령은 기본적으로 expo-template-default@sdk-54를 사용하여 현재 워크플로에서 사용하는 Expo Go 버전에서 열리도록 합니다.
  3. 첫 번째 사용 가능한 화면을 빠르게 빌드합니다. 랜딩 페이지를 만들지 마세요.
  4. scripts/start-phone-preview.sh [lan|tunnel|local]로 휴대폰 프리뷰를 시작합니다.
  5. 편집하는 동안 개발 서버를 계속 실행합니다. Metro/Expo 로그를 사용하여 런타임 오류를 수정합니다.
  6. 사용자에게 Expo Go를 설치하고 QR을 스캔하며 LAN 모드의 경우 휴대폰을 동일한 네트워크에 유지하도록 안내합니다.
  7. 작고 눈에 띄는 변경으로 반복합니다: 편집, 로그 관찰, 새로고침, 수정.

프로젝트 감지

새 앱을 만들기 전에 현재 디렉토리를 검사합니다:

  • package.json에 expo 종속성이 있는 경우: 기존 Expo 앱으로 처리합니다.
  • app.json, app.config.*, app/ 또는 expo-router가 있는 경우: 종속성 설치가 필요하더라도 Expo 앱으로 처리합니다.
  • ios/ 및 android/가 있지만 Expo가 없는 경우: 사용자에게 Expo 마이그레이션이 필요한지 묻고, 그렇지 않으면 기존 스택을 유지합니다.
  • 빈 디렉토리: SDK 54 템플릿으로 새 Expo 앱을 생성합니다.

휴대폰 프리뷰

첫 번째 "와우" 데모에는 Expo Go를 사용하세요. App Store/TestFlight의 마찰을 피할 수 있습니다.

기본적으로 SDK 54를 사용합니다. 이 워크플로의 현재 Expo Go는 SDK 55 프로젝트를 "프로젝트가 이 버전의 Expo Go와 호환되지 않습니다"라는 메시지와 함께 거부합니다. 사용자의 Expo Go가 최신 SDK를 지원하는 것으로 알려진 경우에만 재정의하세요:

CODEX_PHONE_LAB_EXPO_TEMPLATE=expo-template-default@sdk-55 <skill-dir>/scripts/new-expo-app.sh my-app

실행:

<skill-dir>/scripts/start-phone-preview.sh lan

휴대폰이 동일한 Wi-Fi에 없거나 LAN 모드로 연결할 수 없는 경우 tunnel을 사용하세요. 터널 모드는 Expo에 터널링 종속성을 설치하도록 요청할 수 있습니다.

사용자 워크플로:

  1. 휴대폰에 Expo Go를 설치합니다.
  2. 프리뷰 명령을 실행합니다.
  3. Expo Go 또는 휴대폰 카메라에서 QR 코드를 스캔합니다.
  4. 터미널을 열어 둡니다. 앱 편집 내용이 실시간으로 새로고침됩니다.

앱 빌드 지침

첫 번째 화면이 실제 앱처럼 느껴지도록 만드세요:

  • 안전 영역과 모바일 크기 레이아웃을 사용하세요.
  • 실제 상호작용을 구축하세요: 양식, 목록, 탐색, 토글, 타이머, 모의 데이터 또는 상태.
  • 워크플로가 암시하는 경우 로딩, 빈 상태 및 오류 상태를 포함하세요.
  • 모바일에 적합한 간결한 타이포그래피를 유지하세요.
  • 웹 랜딩 페이지 패턴, 과도한 크기의 히어로 섹션, 중첩 카드 및 설명적인 인앱 텍스트를 피하세요.
  • 템플릿에 이미 포함된 경우 다중 화면 앱에는 Expo Router를 선호하세요.

배포 결정

사용자의 목표에 가장 적합한 가벼운 경로를 선택하세요:

  • 사용자 휴대폰에서 빠른 프로토타입: Expo Go QR.
  • 사용자 정의 네이티브 모듈이 있는 앱: Expo 개발 빌드.
  • iPhone에서 베타 사용자: EAS/Apple Developer 계정을 통한 TestFlight.
  • 공개 릴리스: App Store / Play Store 제출.

Expo Go가 프로덕션 배포라고 암시하지 마세요. 이는 라이브 개발 프리뷰입니다.

참고 자료

Expo Go, 개발 빌드, TestFlight 및 앱 스토어 릴리스 중에서 결정할 때 references/expo-phone-workflow.md를 읽으세요.

관련 스킬