firebase-basics 是 Firebase 官方 agent-skills 项目中的基础技能，面向使用 AI 代理进行 Firebase 开发的场景，主要解决在正式使用 Firebase 各项功能之前的环境准备与项目上下文建立问题。
用途 该技能用于完成 Firebase 开发的前置设置：检查 Firebase CLI 是否可用、确认 Firebase MCP 服务器是否安装、完成登录认证，以及确定当前活动的 Firebase 项目。它同时作为入口，引导代理在需要时安装完整的 Firebase 技能套件。
主要能力
- 环境检查：通过 npx -y firebase-tools@latest --version 检查 Firebase CLI 是否安装，并验证 Firebase MCP 服务器是否已安装。
- 登录认证：运行 npx -y firebase-tools@latest login 完成登录；在无浏览器环境（如远程 shell）中使用 npx -y firebase-tools@latest login --no-localhost。命令应输出当前用户。
- 项目上下文：通过 npx -y firebase-tools@latest use 查看当前项目；若需切换，使用 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-basics 一个技能，需按代理环境阅读对应参考文档完成完整技能套件安装，涵盖 Gemini CLI、Antigravity、Android Studio、Claude Code、Cursor、GitHub Copilot 及其他代理。
- 配置文件获取：设置 iOS 或 Android 应用时，不引导用户去 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>，并将输出保存到相应位置。
使用方式 技能强调若干使用原则：始终用 npx -y firebase-tools@latest 前缀运行 CLI 命令以确保最新版本，不建议直接使用裸 firebase 命令；Firebase 相关知识优先查询 developerknowledge_search_documents MCP 工具；实现指导优先参考 Agent Skills 提供的工作流、安全规则与最佳实践；与远程 Firebase API 交互时使用 Firebase MCP 服务器工具而非手动 API 调用；定期检查并更新 Firebase 插件或 Agent Skills。技能还提供多个参考文档入口，包括本地环境设置、Firebase 服务初始化、CLI 指南，以及 Web、Android、iOS 的 SDK 设置指南。
适用场景 适用于需要为 AI 代理准备 Firebase 开发环境的场景，包括首次配置 Firebase CLI、在远程或无浏览器环境登录、切换或创建 Firebase 项目、为移动应用获取 SDK 配置文件，以及按代理环境安装完整 Firebase 技能套件。
限制 资料未提供该技能的具体收费、价格、平台支持范围或效果数据。技能本身依赖 Firebase CLI 与 Firebase MCP 服务器；部分步骤（如项目创建、登录）需要用户交互确认。使用前必须先阅读 references/local-env-setup.md，且若仅有该技能，需按对应代理环境参考文档完成完整套件安装。