Firebase CLI 基础技能

前置条件

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

1. 本地环境设置： 验证环境已正确配置，以便使用 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

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

   • 该命令应输出当前用户。
   • 如果尚未登录，请根据该命令的交互式提示进行身份验证。

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

   [!IMPORTANT] 对于代理： 在继续项目配置之前，必须暂停并询问开发者他们倾向于：

   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. 遵循代理技能进行实施指导： 技能提供了有观点的工作流程 (CUJ)、安全规则和最佳实践。请始终查阅它们以了解如何正确实施 Firebase 功能，而不是依赖通用知识。
4. 使用 Firebase MCP 服务器工具而不是直接 API 调用： 无论何时需要与远程 Firebase API 交互（例如获取 Crashlytics 日志或执行 Data Connect 查询），请使用 Firebase MCP 服务器提供的工具，而不是尝试手动调用 API。
5. 保持插件/代理技能更新： 由于 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
6. 自动化配置文件检索： 在设置 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 链接的路径）。

参考资料

• 初始化 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