firebase

firebase 技能概览

firebase 技能适合做什么

firebase 技能是一份实用指南，帮助你围绕 Firestore、Auth、Storage、Functions、Hosting 和 security rules 等 Firebase 服务进行开发。它最适合需要真正上线或维护 Firebase 后端应用的人，而不只是想在理论层面了解 Firebase。

谁应该使用它

如果你在做 Web 或移动应用，需要实时数据同步，想要支持离线的客户端逻辑，或者必须收紧 Firestore 和 Storage 的访问规则，就适合使用这个 firebase 技能。对于 firebase for Database Engineering 来说，它也很合适，尤其是当核心工作是把读取、写入和权限建模得清晰可控时。

它能帮你做什么决策

它的核心价值，是让你用更少的坏默认设置更快落地：比如如何组织 Firestore 数据、什么时候该反规范化、如何用规则保护文档，以及如何在生产前先用本地模拟器验证。 如果你只是需要一次性的 prompt，一个通用的 Firebase prompt 可能就够了；如果你希望有可复用的搭建方式和更安全的模式，这个 firebase 技能会更合适。

如何使用 firebase 技能

在你的工作区中安装 firebase 技能

要使用 firebase install 流程，请把这个技能添加到你实际要开发应用的同一个工作区或 agent 上下文里。然后让 agent 直接对齐仓库中与 Firebase 相关的文件，这样它给出的建议会基于你当前的配置，而不是泛泛的示例。

先从最有用的文件开始看

先读 SKILL.md，再检查 firebase.json、firestore.rules、storage.rules，以及任何已有的 emulator 或 function 配置。这个技能仓库很精简，所以这些文件承载了大部分你需要的 Firebase 实战指导，也最能帮助你正确适配这个技能。

把模糊目标变成高质量 prompt

把应用类型、涉及的 Firebase 服务，以及最关键的约束说清楚。比如：“为一个多租户 SaaS 应用设计 Firestore schema，要求支持按组织的角色权限、快速列表查询，以及规则强制校验。” 这类表达远比“帮我处理 Firebase”更有用，因为它同时给了 firebase 指南查询模式、权限模型和真实实现目标。

采用以实现为先的工作流

一个更好的流程是：先定义数据模型，再起草 rules，然后用 emulators 验证，最后再接入客户端代码。对于 firebase for Database Engineering 来说，这个顺序尤其重要，因为 schema 设计和 security rules 会互相影响；其中一个拖到最后再改，往往会带来代价很高的重写。

firebase 技能 FAQ

它比普通的 Firebase prompt 更好吗？

通常是的，尤其当你需要可重复的 Firebase 用法、规则设计，或者一条结构清晰的搭建路径时。普通 prompt 也能回答单点问题，但当你希望在 schema、auth、storage 和部署之间保持一致工作流时，firebase 技能会更有价值。

它会取代 Firebase 文档吗？

不会。firebase 技能的作用是加速决策和实现，而官方文档仍然是平台行为和边界案例的权威来源。你可以先用这个技能拿到一个可执行方案，接近生产环境时再对照 Firebase docs 核实细节。

它适合新手吗？

如果你已经知道自己的应用目标，并希望把它转成 Firebase 实现方案，那它对新手也很友好。 但如果你还在纠结到底该用 Firestore、Realtime Database，还是别的后端，它就没那么有帮助，因为这个技能默认你已经选定 Firebase 作为技术栈。

什么时候应该跳过这个技能？

如果你的项目根本不用 Firebase、后端已经固定在别的数据库或认证系统上，或者你只是需要一句 CLI 提醒，那就可以跳过。它最有价值的场景，是工作本身依赖 Firebase install、配置、rules 或数据建模决策时。

如何改进 firebase 技能

给这个技能提供正确的约束

想让 firebase 技能产出更好，输入就要具体：集合名、用户角色、预期查询模式、数据量，以及是否需要离线支持。“做一个任务应用” 这样的要求太弱；“做一个带组织级访问控制、未读计数和按状态过滤列表查询的任务应用” 就要好得多。

尽早加入 rules 和查询预期

如果你关心 security rules，那就先说明用户可以读、写还是列出哪些数据，再来问 schema 设计。Firestore 设计最容易被优化的时机，就是 prompt 同时包含客户端查询形态和权限边界，因为这两者通常也是最先出问题的地方。

留意常见失败模式

最常见的错误，是把 Firestore 过度按关系型数据库去规范化，结果让读取成本变高、rules 也更难写。另一个失败点，是在数据模型还没稳定时就急着要客户端代码。使用 firebase 指南可以先把这些决策压测一遍，再开始真正开发。

在第一版输出后继续迭代

拿到初版答案后，可以继续细化，比如要求提供可直接用于 emulator 的 rules、未认证用户的边界情况，或者一个更小、只匹配前三个高频查询的 schema。对于 firebase for Database Engineering 来说，提升最快的方式，是把读取模式和访问规则一起收紧，而不是分开修改。