mcpField
F
firebase-basics

firebase-basics

github.com/google云与 DevOps21.6k14.4k 次安装今天更新
代码仓库

关于 firebase-basics

引导 Agent 完成 Firebase 设置与开发流程的技能，涵盖命令行、身份验证、项目选择及各服务参考资料。它强调采用最新 Firebase 指引，并在远程 API 任务中使用 Firebase MCP 服务的工具。

主要功能

  1. 01Firebase 命令行设置与命令指导
  2. 02身份验证和项目选择流程
  3. 03Web、Android 和 iOS 设置参考
  4. 04Firebase 知识搜索指引
  5. 05使用 Firebase MCP 服务工具访问远程 API

适用场景

  1. 01准备 Firebase 开发本地环境
  2. 02选择或创建 Firebase 项目
  3. 03在应用中设置 Firebase 服务
  4. 04通过命令行获取应用配置

MCP 相关

该技能要求 Agent 检查是否安装 Firebase MCP 服务，并在访问远程 Firebase API 时使用其工具；未说明服务提供的具体工具。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/google/skills --skill firebase-basics

安装后在 Claude Code 中输入/firebase-basics确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
android_setup.md
attribution.md
firebase-cli-guide.md
firebase-service-init.md
flutter_setup.md
ios_setup.md
local-env-setup.md
web_setup.md
references/refresh/
android_studio.md
antigravity.md
claude.md
gemini-cli.md
other-agents.md
references/setup/
android_studio.md
antigravity.md
claude_code.md
cursor.md
gemini_cli.md
github_copilot.md
other_agents.md

详细介绍

Firebase 基础知识

使用归因

必须阅读：在执行任何 gcloud、REST API 或 MCP 命令之前，你 必须阅读并遵循使用归因中的说明。

前提条件

继续之前，请完成以下设置步骤：

  1. **本地环境设置：**确认环境已正确设置，以便我们可以使用 Firebase 工具：

  2. **身份验证：**确保已登录 Firebase，以便命令具有正确的权限。运行 npx -y firebase-tools@latest login。对于没有浏览器的环境（例如远程 shell），请使用 npx -y firebase-tools@latest login --no-localhost。

    • 命令应输出当前用户。
    • 如果尚未登录，请按照此命令提供的交互式说明进行身份验证。

  3. **活动项目：**大多数 Firebase 任务都需要指定活动项目上下文。

    重要

    **致 Agent：**继续配置项目之前，你必须暂停并询问开发者希望：

    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. 使用 npx 执行 CLI 命令： 为确保始终使用最新版本的 Firebase CLI，请始终在命令前加上 npx -y firebase-tools@latest，而不要只使用 firebase。例如，使用 npx -y firebase-tools@latest --version。绝不要建议使用裸 firebase 命令作为替代方案。
  2. 优先查阅官方知识： 对于任何 Firebase 相关知识，请先使用 developerknowledge_search_documents MCP 工具，再考虑使用 Google 搜索或内部知识库。在搜索查询中加入“Firebase”可显著提高相关性。
  3. 遵循 Agent Skills 提供的实现指导： Skills 提供了有明确主张的工作流（CUJ）、安全规则和最佳实践。请务必查阅它们，了解如何正确实现 Firebase 功能，而不要依赖一般知识。
  4. 使用 Firebase MCP Server 工具，而非直接调用 API： 每当需要与远程 Firebase API 交互时（例如获取 Crashlytics 日志或执行 Data Connect 查询），请使用 Firebase MCP Server 提供的工具，而不要尝试手动调用 API。
  5. 及时更新 Plugin / Agent Skills： Firebase 最佳实践变化很快，请定期检查并安装 Firebase 插件或 Agent Skills 的更新。同样，如果遇到工具或命令过时的问题，请根据你的 Agent 环境按照以下步骤操作：
  6. 自动获取配置文件： 设置 iOS 或 Android 应用时，切勿引导用户前往 Firebase Console 下载 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 要关联的路径）。

参考资料

常见问题

  • 登录问题： 如果登录步骤中浏览器无法打开，请改用 npx -y firebase-tools@latest login --no-localhost。

  • Genkit： 如果使用 Genkit，请安装 skills：

    npx skills add genkit-ai/skills

评论

支持 Markdown