用途：在 /functions 目录创建或修改 Firebase Cloud Functions 时使用，规范云函数的结构与错误处理模式。
目录结构：functions/src 下包含 index.ts（函数导出）、admin.ts（Firebase Admin SDK 初始化）、backfill/（数据迁移脚本）、commentSuggestion/（AI 评论功能）、commentings/（评论活动追踪）、notifications/（推送通知函数）、postings/（帖子活动追踪）、replyings/（回复活动追踪）和 shared/（共享工具）。
函数结构：使用 firebase-functions/v2/firestore 的 onDocumentCreated 等触发器，从 ../admin 引入 admin，从 ../types/... 引入类型。示例中 createPosting 监听 'boards/{boardId}/posts/{postId}'，从 event.data?.data() 读取数据，从 event.params 获取 boardId 与 postId；无数据时记录 console.error 并返回 null，成功写入后记录日志。
错误处理：不要抛出异常，让函数平稳完成。将写入操作包在 try/catch 中，成功时 console.log 记录，失败时 console.error 记录，不重新抛出，最后 return null。
构建与测试：cd functions && npm install 安装依赖；cd functions && npm run build 编译 TypeScript；cd functions && npm test 运行 Jest 测试。
适用场景：Firebase 项目中编写 Firestore 触发、推送通知、活动追踪等云函数。限制：资料未提供完整的参数配置、部署命令、收费与配额信息；以上内容仅为该来源给出的模式约定。