前言¶

在移动端或 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 内写明）¶

1. 凡 Firebase 相关知识，优先通过 developerknowledge_search_documents MCP 工具检索，查询中包含 “Firebase” 以提高相关性，再考虑通用搜索或模型内置知识。
2. 具体功能实现遵循各 Firebase Agent Skill 中的工作流与安全规则，而非泛泛的通用知识。
3. 与远程 Firebase API 交互（如 Crashlytics 日志、Data Connect 查询）时，使用 Firebase MCP Server 提供的工具，避免手写 API 调用。
4. 定期更新 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 正文一致）：

1. 用 npx -y firebase-tools@latest --version 确认 CLI 可用，并完成 local-env-setup 与（必要时）整套 Firebase Skills 的配置。
2. 执行 login 或 login --no-localhost，确认已认证用户。
3. 询问沿用现有项目还是新建；用 use / projects:create 固定活动项目。
4. 在已知 APP_ID 与 PROJECT_ID 时，用 apps:sdkconfig 生成 Android/iOS 配置文件并写入工程路径。
5. 需要启用具体 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