用途:convex-reviewer 是一个专注于 Convex 开发的代码审查技能。当用户要求审查或审计 Convex 代码,或在编写完 Convex 代码后触发,它会按清单检查并给出改进建议。
主要能力: 安全与认证:检查所有公开函数是否调用 ctx.auth.getUserIdentity(),认证是否使用不可猜测的 ID(Convex ID、UUID)而非邮箱,是否验证资源归属、是否信任客户端传入的用户 ID,团队/组织访问是否校验。 校验器:检查公开函数是否有 args 校验器、所有函数是否有 returns 校验器、校验器是否与数据结构一致。 内部函数:定时任务是否指向 internal.* 而非 api.*,ctx.runMutation 与 ctx.runAction 作用域是否合适。 性能:数据库查询是否用 .withIndex() 而非 .filter(),外键字段是否有索引,常见查询是否用复合索引,是否有多余索引,是否对无界查询用 .collect(),是否按需分页;查询函数中是否使用 Date.now() 而破坏响应式。 模式设计:是否为扁平文档加 ID 关系、是否有深层嵌套数组、数组是否受限,枚举是否用 v.union(v.literal(...)),可选字段是否用 v.optional(),时间戳是否用 v.number(),关系是否用外键加索引或中间表。 代码质量:Promise 是否 await、错误处理、查询/变更包装是否轻量、业务逻辑是否放在普通 TypeScript 函数、类型是否来自 _generated/dataModel。
使用方式:在请求审查或编写代码后调用本技能,它按安全、性能、代码质量、改进建议四轮审查,反馈分关键、重要、建议、表扬四级,并解释每个改动的原因。
限制:资料未提供安装命令、收费方式、具体平台支持与运行细则,暂未提供。