前言¶
在移动端或 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
