THE3RDTRAINER/Homepage

前提条件

以下のセットアップ手順を完了してから進めてください。

1. ローカル環境のセットアップ: Firebase ツールが使用可能なように環境が適切にセットアップされていることを確認します。

   • 次のコマンドを実行して、Firebase CLI がインストールされているか確認します: npx -y firebase-tools@latest --version
   • 既存のツールを使用して、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 を使用するために、コマンドは firebase だけではなく、必ず npx -y firebase-tools@latest を先頭に付けてください。例: 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 コンソールに誘導して 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 をアプリに追加するための詳細なガイド:
  • Web: 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