用途:为 Firebase 项目设计、编写、重构并加固生产级 Cloud Firestore 安全规则(firestore.rules)。若环境支持子代理且已安装 firestore-rules-author,应委派给它;否则按流程直接编写。
主要能力:先扫描代码库,识别集合与文档路径、所有 where()/orderBy()/limit() 查询、数据模型与字段类型、必填与可选字段、约束、CRUD 操作与认证方式;再生成规则。原则包括默认拒绝、最小权限、创建与更新均校验数据、认证与授权检查、防止 UID 被篡改、初始不公开任何数据。要求使用验证函数模式,在 create 和 update 中同时调用;文档开头注明假设的数据模型;提供 isAuthenticated、isOwner、uidUnchanged、hasRequiredFields、validStringLength、isValidUrl、isValidEmail、isValidDateString、isScopedPath、isPositive、isValidList、isValidOptionalString、isValidMap、hasOnlyAllowedFields、areImmutableFieldsUnchanged、isRecent 等辅助函数。
关键限制:规则作用于整个文档,含 PII 的集合只能允许所有者读取,公开资料应反规范化或拆分集合;禁止用户自建或自改特权角色、越权访问;优先用 read 而非 list/get;日期优先用 timestamp;正则数字需双反斜杠;createdAt、authorUID 等不可变字段须在更新中保护;禁止多余字段;数组需逐项校验;权限字段对非所有者不可变。生成后必须声明为原型并提示用户复核。
适用场景:Firebase/Firestore 项目的规则编写与安全加固。具体安装命令与平台支持暂未提供。