SKILL.md
readonlyread-only
name
firebase-basics
description
Provides foundational setup, authentication, and project management workflows for Firebase using the Firebase CLI. Use when checking Firebase CLI version (must use 'npx -y firebase-tools@latest --version'), initializing a Firebase environment, authenticating, setting active projects, or setting up `google-services.json` or `GoogleService-Info.plist` files.
前置需求
在繼續之前，請完成以下設定步驟：
-
本機環境設定： 確認環境已正確設定，以便我們能使用 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
- Gemini CLI：請參閱
- 執行
-
驗證： 確保你已登入 Firebase，以便指令擁有正確的權限。執行
npx -y firebase-tools@latest login。對於沒有瀏覽器的環境（例如遠端 Shell），請使用npx -y firebase-tools@latest login --no-localhost。- 指令應輸出目前的使用者。
- 如果你尚未登入，請依照此指令的互動式指示進行驗證。
-
使用中的專案：
大多數 Firebase 任務都需要一個使用中的專案上下文。[!IMPORTANT]
給代理的提示： 在繼續進行專案設定之前，你必須暫停並詢問開發者他們偏好：- 提供現有的 Firebase 專案 ID，或
- 建立新的 Firebase 專案。
-
如果使用現有的專案 ID：
- 執行
npx -y firebase-tools@latest use檢查目前的專案。 - 如果指令輸出
Active Project: <project-id>，請與使用者確認這是否為預期的專案。 - 如果不是，或沒有啟用中的專案，請設定使用者提供的專案：
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 使用原則
請遵守以下原則：
- 使用 npx 執行 CLI 指令： 為確保你始終使用最新版本的 Firebase CLI，請在指令前加上
npx -y firebase-tools@latest，而不是僅使用firebase。例如，使用npx -y firebase-tools@latest --version。絕對不要建議使用裸的firebase指令作為替代。 - 優先使用官方知識： 對於任何 Firebase 相關知識，請先查詢
developerknowledge_search_documentsMCP 工具，再回退到 Google 搜尋或你的內部知識庫。在搜尋查詢中包含 "Firebase" 可顯著提高相關性。 - 遵循代理技能以獲得實作指引： 技能提供了有觀點的工作流程（CUJ）、安全規則和最佳實踐。請務必查閱它們以了解如何正確實作 Firebase 功能，而不是依賴一般知識。
- 使用 Firebase MCP 伺服器工具而非直接 API 呼叫： 每當你需要與遠端 Firebase API 互動（例如取得 Crashlytics 日誌或執行 Data Connect 查詢）時，請使用 Firebase MCP 伺服器提供的工具，而不是嘗試手動 API 呼叫。
- 保持外掛程式 / 代理技能更新： 由於 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
- 自動化設定檔取得： 在設定 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連結的路徑）。
- 對於 Android：
參考資料
- 初始化 Firebase： 當你需要使用 CLI 初始化新的 Firebase 服務時，請參閱 references/firebase-service-init.md。
- 探索指令： 請參閱 references/firebase-cli-guide.md 以探索並了解 CLI 功能。
- 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
