THE3RDTRAINER/Homepage

사전 조건

진행하기 전에 다음 설정 단계를 완료하세요:

1. 로컬 환경 설정: Firebase 도구를 사용할 수 있도록 환경이 올바르게 설정되었는지 확인합니다.

   • npx -y firebase-tools@latest --version을 실행하여 Firebase CLI가 설치되어 있는지 확인합니다.
   • 기존 도구를 사용하여 Firebase MCP 서버가 설치되어 있는지 확인합니다.
   • 중요: 아래 확장 프로그램이나 에이전트 환경을 구성하기 전에 반드시 references/local-env-setup.md를 읽으세요.
   • 건너뛰지 마세요: 'firebase-basics'가 사용 가능한 유일한 Firebase 스킬인 경우, 전체 Firebase 스킬 제품군을 설정하려면 에이전트 환경에 대한 참조를 따라야 합니다:
     • Gemini CLI: references/setup/gemini_cli.md 검토
     • Antigravity: references/setup/antigravity.md 검토
     • Android Studio: references/setup/android_studio.md 검토
     • Claude Code: references/setup/claude_code.md 검토
     • Cursor: references/setup/cursor.md 검토
     • GitHub Copilot: references/setup/github_copilot.md 검토
     • 기타 에이전트: references/setup/other_agents.md 검토

2. 인증: 명령어가 올바른 권한을 가지도록 Firebase에 로그인했는지 확인합니다. npx -y firebase-tools@latest login을 실행하세요. 브라우저가 없는 환경(예: 원격 셸)에서는 npx -y firebase-tools@latest login --no-localhost를 사용하세요.

   • 명령어는 현재 사용자를 출력해야 합니다.
   • 로그인되지 않은 경우, 이 명령어의 대화형 안내를 따라 인증하세요.

3. 활성 프로젝트: 대부분의 Firebase 작업에는 활성 프로젝트 컨텍스트가 필요합니다.

   [!IMPORTANT] 에이전트 대상: 프로젝트 구성을 진행하기 전에, 반드시 개발자에게 다음 중 선호하는 방식을 질문하고 중단해야 합니다:

   1. 기존 Firebase 프로젝트 ID 제공, 또는
   2. 새 Firebase 프로젝트 생성.

   • 기존 프로젝트 ID를 사용하는 경우:

     1. npx -y firebase-tools@latest use를 실행하여 현재 프로젝트를 확인합니다.

     2. 명령어가 Active Project: <project-id>를 출력하면 사용자에게 이 프로젝트가 의도한 프로젝트인지 확인합니다.

     3. 그렇지 않거나 활성 프로젝트가 없는 경우, 사용자가 제공한 프로젝트를 설정합니다:

        npx -y firebase-tools@latest use <PROJECT_ID>
        

   • 새 프로젝트를 생성하는 경우: 다음 명령어를 실행하여 생성합니다:

     npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"
     

     참고: <project-id>는 6~30자, 소문자, 숫자와 하이픈을 포함할 수 있으며 전역적으로 고유해야 합니다.

Firebase 사용 원칙

다음 원칙을 준수하세요:

1. CLI 명령어에는 npx 사용: 항상 최신 버전의 Firebase CLI를 사용하려면 명령어 앞에 항상 npx -y firebase-tools@latest를 붙이고, firebase만 사용하지 마세요. 예를 들어 npx -y firebase-tools@latest --version을 사용하세요. 절대로 firebase 명령어를 대안으로 제안하지 마세요.
2. 공식 지식 우선: Firebase 관련 지식이 필요하면 Google 검색이나 내부 지식 베이스로 넘어가기 전에 developerknowledge_search_documents MCP 도구를 먼저 참조하세요. 검색 쿼리에 "Firebase"를 포함하면 관련성이 크게 향상됩니다.
3. 구현 지침은 에이전트 스킬 따르기: 스킬은 의견이 반영된 워크플로우(CUJ), 보안 규칙, 모범 사례를 제공합니다. 일반 지식에 의존하지 말고 항상 스킬을 참조하여 Firebase 기능을 올바르게 구현하는 방법을 이해하세요.
4. 직접 API 호출 대신 Firebase MCP 서버 도구 사용: Firebase 원격 API(예: Crashlytics 로그 가져오기, Data Connect 쿼리 실행)와 상호 작용해야 하는 경우, 수동 API 호출을 시도하는 대신 Firebase MCP 서버에서 제공하는 도구를 사용하세요.
5. 플러그인/에이전트 스킬 업데이트 유지: Firebase 모범 사례는 빠르게 진화하므로 정기적으로 Firebase 플러그인 또는 에이전트 스킬의 업데이트를 확인하고 설치하세요. 유사하게, 오래된 도구나 명령어에 문제가 발생하면 에이전트 환경에 따라 다음 단계를 따르세요:
   • Antigravity: references/refresh/antigravity.md 참조
   • Gemini CLI: references/refresh/gemini-cli.md 참조
   • Claude Code: references/refresh/claude.md 참조
   • Cursor: references/refresh/other-agents.md 참조
   • Android Studio: references/refresh/android_studio.md 참조
   • 기타: references/refresh/other-agents.md 참조
6. 구성 파일 검색 자동화: iOS 또는 Android 앱을 설정할 때, Firebase Console로 이동하여 google-services.json 또는 GoogleService-Info.plist를 다운로드하도록 사용자에게 안내하지 마세요. 대신 Firebase CLI를 사용하여 프로그래밍 방식으로 구성을 가져오세요:
   • Android: npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>
   • iOS: npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID> 출력을 적절한 위치(예: Android의 경우 app/google-services.json, iOS의 경우 xcode-project-setup에서 링크할 경로)에 저장하세요.

참조

• Firebase 초기화: CLI를 사용하여 새 Firebase 서비스를 초기화해야 하는 경우 references/firebase-service-init.md를 참조하세요.
• 명령어 탐색: CLI 기능을 검색하고 이해하려면 references/firebase-cli-guide.md를 참조하세요.
• SDK 설정: 앱에 Firebase를 추가하는 자세한 가이드:
  • 웹: references/web_setup.md 참조
  • Android: references/android_setup.md 참조
  • iOS: references/ios_setup.md 참조

일반적인 문제

• 로그인 문제: 로그인 단계에서 브라우저가 열리지 않으면 대신 npx -y firebase-tools@latest login --no-localhost를 사용하세요.

• Genkit: Genkit을 사용하는 경우 스킬을 설치하세요:

  npx skills add genkit-ai/skills