前言¶
在移動端或 Web 裏接 Firebase，常見卡點不在「會不會寫 SDK」，而在登錄 CLI、選對項目、把 google-services.json 或 GoogleService-Info.plist 放到正確路徑。人工翻控制台、記 firebase 命令，和讓編碼 Agent 按同一套步驟執行，往往各說各話。Google 在 google/skills 倉庫裏提供的 firebase-basics Skill，把 Firebase CLI 的基礎操作和 Agent 側約束寫進 SKILL.md，讓助手在動手前先對齊環境與權限邊界。
下面介紹這個 Skill 的定位、能做什麼、不能做什麼，以及如何在 Cursor 等環境裏安裝並配合其它 Firebase Skill 使用。
這是什麼¶
firebase-basics 是 Google 官方 Agent Skills 集合中的一條，路徑爲 skills/cloud/firebase-basics，元數據分類爲 Serverless。
官方描述概括其職責：提供 Firebase CLI 的基礎設置，包括 CLI 安裝與版本檢查、登錄（含無瀏覽器場景）、項目創建與切換、以及應用配置文件（google-services.json、GoogleService-Info.plist）的獲取方式。
需要明確的是範圍：僅用於 CLI 登錄、項目創建/切換、下載應用配置文件。不用於 Firebase Hosting 部署、Firestore、Auth、App Hosting、Data Connect、Crashlytics 或 Remote Config 等主題的實現指導；那些能力應交給同倉庫或其它 Firebase 專項 Skill，並配合 Firebase MCP Server 與官方文檔檢索工具。
核心功能¶
環境與 CLI 約定¶
Skill 要求 Agent 在執行 Firebase 相關命令時，始終通過 npx 拉取最新 CLI，而不是裸用全局的 firebase 命令。版本檢查示例：
npx -y firebase-tools@latest --version
前置步驟還包括：確認本機環境可用、檢查是否已安裝 Firebase MCP Server，並在配置擴展或 Agent 環境前閱讀 Skill 附帶的 references/local-env-setup.md。若當前只有 firebase-basics 這一條 Firebase Skill，官方要求按所用 Agent 類型閱讀對應 setup 文檔（含 Cursor、Claude Code、Gemini CLI、GitHub Copilot、Android Studio 等），以安裝完整的 Firebase Skill 套件。
認證與項目上下文¶
登錄 Firebase，使後續命令具備正確權限：
npx -y firebase-tools@latest login
遠程 Shell 等無法打開瀏覽器的環境：
npx -y firebase-tools@latest login --no-localhost
成功時應輸出當前用戶；未登錄則按命令提示完成交互式認證。
多數任務依賴「當前活動項目」。Skill 規定 Agent 在配置項目前必須暫停並詢問開發者：使用已有 Project ID，還是新建項目。
查看當前項目：
npx -y firebase-tools@latest use
若輸出 Active Project: <project-id>，需與用戶確認是否爲預期項目；否則用用戶提供的 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 個字符、小寫，可含數字與連字符，且全局唯一。
應用配置文件（CLI 拉取，非控制台手導）¶
設置 Android 或 iOS 應用時，Skill 要求不要讓用戶去 Firebase Console 手動下載配置文件，而應使用 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 等 Skill 所指路徑）。
Agent 側工作原則（Skill 內寫明）¶
- 凡 Firebase 相關知識，優先通過
developerknowledge_search_documentsMCP 工具檢索，查詢中包含 “Firebase” 以提高相關性，再考慮通用搜索或模型內置知識。 - 具體功能實現遵循各 Firebase Agent Skill 中的工作流與安全規則，而非泛泛的通用知識。
- 與遠程 Firebase API 交互（如 Crashlytics 日誌、Data Connect 查詢）時，使用 Firebase MCP Server 提供的工具，避免手寫 API 調用。
- 定期更新 Firebase 插件或 Agent Skills；遇工具過時，按環境閱讀
references/refresh/下對應文檔（Cursor 等可走other-agents.md）。
Skill 還通過 References 指向初始化服務、CLI 指南，以及 Web / Android / iOS SDK setup 文檔路徑，供在基礎 CLI 就緒後繼續深入。
安裝與啓用¶
firebase-basics 隨 google/skills 倉庫分發。安裝整個倉庫（或按需選擇 Skill）可使用 skills CLI：
npx skills add google/skills
按提示選擇具體 Skill、目標 Agent 以及安裝範圍（項目級或全局）。環境若無 npx，需先安裝 Node.js（含 npm/npx）。
更新已安裝的 Skills：
npx skills update
可選清理已廢棄的 Skill。倉庫 README 亦提供 skills.sh 安裝入口。
在 Cursor 中，官方在 Prerequisites 中指向 references/setup/cursor.md 與刷新說明 references/refresh/other-agents.md；具體點擊路徑以 Skill 倉庫內文件爲準，安裝後由 Agent 在觸發 firebase-basics 時加載 SKILL.md 全文執行。
若使用 Genkit，Common Issues 一節建議額外安裝：
npx skills add genkit-ai/skills
典型用法（Agent 視角）¶
開發者提出「接 Firebase」「下載 google-services.json」等需求時，加載 firebase-basics 的 Agent 大致會按下列順序推進（與 Skill 正文一致）：
- 用
npx -y firebase-tools@latest --version確認 CLI 可用，並完成 local-env-setup 與（必要時）整套 Firebase Skills 的配置。 - 執行
login或login --no-localhost，確認已認證用戶。 - 詢問沿用現有項目還是新建；用
use/projects:create固定活動項目。 - 在已知
APP_ID與PROJECT_ID時，用apps:sdkconfig生成 Android/iOS 配置文件並寫入工程路徑。 - 需要啓用具體 Firebase 產品時，轉引
references/firebase-service-init.md及平臺 setup 文檔，而不是在本 Skill 內展開 Hosting、Firestore 等實現。
登錄失敗且瀏覽器無法打開時，Skill 明確 fallback 爲 login --no-localhost。
適用場景與注意¶
適合誰
- 獨立開發者或初創團隊在 Cursor、Claude Code、Copilot 等 Agent 裏做 Firebase 工程初始化。
- 希望 Agent 統一使用
npx -y firebase-tools@latest、避免過時 CLI 命令與「去控制台點下載」的重複勞動。
邊界與注意
- 本 Skill 是「CLI 與項目上下文 + 配置文件獲取」的底座，不是 Firebase 全棧百科；Hosting、數據庫、認證等產品線需其它 Skill 與 MCP。
- Agent 必須在選項目前與用戶確認，避免誤操作錯誤 GCP/Firebase 項目。
- Firebase 實踐變化較快，Skill 要求保持插件與 Skills 更新，並優先官方 MCP 與文檔檢索。
Firebase 在移動與 Web 場景裏仍是常見後端選型；官方把入門 CLI 流程固化成 Agent Skill，有助於補齊模型對「npx 前綴、無 localhost 登錄、CLI 拉配置」等細節的盲區，並與同倉庫其它 Firebase Skill 串聯成可復現工作流。
官方 Skill 目錄：https://github.com/google/skills/tree/main/skills/cloud/firebase-basics
