用途:这是 Convex 项目的团队内部风格约定,而非 Convex 使用手册。它只补充项目策略,脚手架、认证、迁移、性能、组件与 API 机制应参考已安装的官方 Convex 技能和实时文档;只应用与当前改动相关的部分。
主要能力:规定目录布局与共享结构,如 convex/ 保持在根目录、不编辑 _generated/,schema.ts 负责 defineSchema 与表声明,auth.config.ts 负责 Clerk JWT provider,表校验器、语义校验、认证辅助与限流配置各保留一个模块,crons.ts 与 http.ts 仅在需要时添加。认证方面以 Clerk 为身份提供方,服务端通过 ctx.auth.getUserIdentity() 派生身份,客户端不提交 userId;每个公开函数在顶部认证并声明 args 与 returns 校验器。读写方面要求索引缩小候选集、其余过滤在代码中进行,无界查询用 .take() 设上限,查询保持纯函数且不使用 Date.now(),mutation 负责写入、action 负责外部调用,公开 mutation 使用 @convex-dev/rate-limiter 限流。数据方面用户创建的行采用软删除,审计记录只追加,schema 变更按 widen、migrate、narrow 流程进行。
使用方式与限制:需对照实时 Convex 文档与已安装版本核验每个 API,升级前阅读发布说明;实时文档优先于本技能。完成标准包括代码生成与类型检查通过、相关测试与项目门禁通过、迁移在开发部署上运行并记录结果。资料未提供具体安装命令、价格或平台信息。