Convex Best Practices
提供Convex数据库开发的最佳实践指南和代码示例。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Convex Best Practices。 它的用途是：提供Convex数据库开发的最佳实践指南和代码示例。 详细介绍见：https://321skill.com/skills/convex-best-practices/ 请根据该页面的说明完成安装。
使用示例
“我正在用Convex设计一个任务管理应用的数据模型，一个用户有多个项目，一个项目有多个任务，应该如何设计表和索引？” 它会根据最佳实践，建议你使用`users`、`projects`、`tasks`表，在`projects`表中存储`userId`作为所有者，在`tasks`表中存储`projectId`，并建议在`projects(userId)`和`tasks(projectId)`上创建索引以高效查询。
介绍
这个Skill旨在解决开发者在学习和使用Convex（一种用于构建实时应用的数据库和后端服务）时遇到的常见问题，如如何高效设计数据模型、编写查询和变更函数、处理实时订阅以及优化性能。它通过提供结构化的最佳实践、代码片段和常见模式，帮助开发者快速上手并避免常见陷阱。
Skill的使用方式主要是作为开发过程中的参考指南。开发者可以在编写Convex相关代码时，向AI询问特定场景下的最佳实践，例如如何设计一个高效的索引，或者如何处理复杂的权限验证逻辑。AI会根据Skill中的知识库，提供具体的建议和代码示例。
它非常适合正在或计划使用Convex构建应用的前端、后端或全栈开发者，尤其是那些希望遵循成熟模式来提升代码质量和开发效率的团队。对于从其他数据库（如Firebase或传统SQL）迁移到Convex的开发者来说，这个Skill能帮助他们快速理解Convex的独特概念和最佳工作方式。
建议在使用时，结合具体的项目需求和Convex的官方文档。虽然Skill提供了通用性指导，但最佳实践的应用仍需根据实际业务逻辑进行调整。对于特别复杂的场景，建议在Skill建议的基础上进行充分的测试和验证。
核心特点
与通用的数据库教程不同，它专注于Convex这一特定技术栈，提供了从数据建模、实时查询到函数部署的端到端实践指南，并包含大量可直接参考的TypeScript代码示例。
注意事项
不适合用于学习其他数据库（如PostgreSQL、MongoDB）或解决与Convex无关的后端开发问题。
常见问题
Convex和Firebase有什么区别？
Convex提供强类型（TypeScript优先）的实时数据库和函数执行环境，相比Firebase Firestore，它在事务一致性、查询能力（支持关系型查询）和开发体验上有所不同。
如何在Convex中实现用户权限控制？
通常在查询和变更函数的开头，通过`ctx.auth`获取用户身份，并在数据查询时使用`with`过滤器，或在变更函数中手动校验权限。