Agent Skills
返回列表
💻

Firebase 与 Firestore 工程实践

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/alinaqi-maggy-firebase。

技能介绍

你在 Firestore 里常被什么问题卡住

多数团队不是不会接 Firebase SDK,而是在文档怎么摊平、读路径与安全规则怎么对齐、以及实时监听和离线持久化上线后才发现缺索引或规则洞。Firestore 是文档库,读多写少的场景若仍按关系型思路嵌套过深,会在列表分页、权限校验和单文档 1MB 上限上连环踩坑。

技能覆盖的能力与用法

本技能按 Firebase 全栈拆开说明:Firestore 建模(何时用 subcollection、常见反规范化模式)、TypeScript Modular SDK(v9+) 的初始化、CRUD、onSnapshot 实时监听与 Web 离线持久化;Security Rules 的结构、字段校验与本地 Emulator 测试;Authentication(邮箱密码、OAuth);Cloud Functions(HTTP 与 Callable);以及 Batch Writes / Transactions 与复合索引配置。附带 CLI 与 Emulator 初始化、项目结构约定,以及明确的 Anti-Patterns(生产禁用 test mode、控制嵌套层级、大列表别塞数组字段等)。

适用边界

侧重 Web / 移动端 + Firestore 数据访问模式 的设计与实现指引,不是 Firebase 控制台点选教程,也不替代你业务侧的合规审计。Hosting、Storage、Extensions 在栈表里点到为止;若项目以 BigQuery 导出或重度服务端渲染为主,需结合官方文档做架构取舍。

使用场景

  • 新功能要在评论区用 onSnapshot 同步点赞数,需先定子集合结构和复合索引再写 Rules
  • PWA 要断网可读草稿,需要按技能开启 Web 离线持久化并处理首次同步冲突
  • Callable Function 里写批量扣库存,要用 Transaction 与 Firestore 批写避免超卖
  • 上线前 Security Rules 只在控制台手测,打算用 Emulator 跑规则单测再部署

适合人员

  • React Native 工程师要在新 App 里接邮箱登录并给 `/users/{uid}` 写最小权限 Rules
  • 全栈开发者从 REST 迁到 Firestore,需要把一对多关系改成可读一次的反规范化文档
  • Firebase 项目负责人要禁止团队在生产环境长期开 test mode,并统一 Emulator 联调流程
  • TypeScript 前端负责 Modular v9 初始化与 field mask,避免整文档拉取浪费带宽