firebase-local-env-setup

Firebase 本地环境设置

此技能介绍了为 Agent 提供完整 Firebase 体验所需的最低限度设置。在开始使用任何 Firebase 功能之前，必须确认以下每个步骤均已完成。

1. 验证 Node.js

• 操作：运行 node --version。

• 处理方式：确保已安装 Node.js，且版本为 >= 20。如果缺少 Node.js 或版本 < v20，请根据操作系统安装：

  推荐：使用 Node 版本管理器 这样可以避免安装全局软件包时遇到权限问题。

  适用于 macOS 或 Linux：

  1. 引导用户访问 nvm 官方仓库。
  2. 请用户手动安装 nvm，并在完成后回复。停止并等待用户确认。
  3. 通过加载相应的配置文件，使 nvm 在当前终端会话中可用：

     # For Bash
     source ~/.bash_profile
     source ~/.bashrc
     
     # For Zsh
     source ~/.zprofile
     source ~/.zshrc
     

  4. 安装 Node.js：

     nvm install 24
     nvm use 24
     

  适用于 Windows：

  1. 引导用户下载并安装 nvm-windows。
  2. 请用户手动安装 nvm-windows 和 Node.js，并在完成后回复。停止并等待用户确认。
  3. 用户确认后，验证 Node.js 是否可用：

     node --version
     

  替代方案：官方安装程序

  1. 引导用户从 nodejs.org 下载并安装 LTS 版本。
  2. 请用户手动安装 Node.js，并在完成后回复。停止并等待用户确认。

2. 验证 Firebase CLI

Firebase CLI 是与 Firebase 服务交互的主要工具。

• 操作：运行 npx -y firebase-tools@latest --version。
• 处理方式：确保此命令成功运行并输出版本号。

3. 验证 Firebase 身份验证

你必须完成身份验证，才能管理 Firebase 项目。

• 操作：运行 npx -y firebase-tools@latest login。
• 处理方式：如果环境是远程环境或受限环境（无法访问浏览器），请改为运行 npx -y firebase-tools@latest login --no-localhost。

4. 安装 Agent 技能和 MCP 服务

要全面管理 Firebase，Agent 需要安装特定技能和 Firebase MCP 服务。请识别当前运行环境中的 Agent，并严格按照相应的设置文档操作。

阅读适用于当前 Agent 的设置文档：

• Gemini CLI：查阅 references/gemini_cli.md
• Antigravity：查阅 references/antigravity.md
• Claude Code：查阅 references/claude_code.md
• Cursor：查阅 references/cursor.md
• GitHub Copilot：查阅 references/github_copilot.md
• 其他 Agent（Windsurf、Cline 等）：查阅 references/other_agents.md

---

**Agent 关键规则：**在上述每个步骤均成功验证并完成之前，不得继续执行任何其他 Firebase 任务。