SuperAPI AI 工具集

convex-expert

编程与开发

查看项目

更新于 10-15 21:51

技能介绍

用途:该技能是常驻的 Convex 后端专家,在触碰 convex/ 目录下任何代码前调用,处理函数定义、schema、索引、query、mutation、action、HTTP 等后端逻辑,弥补通用模型在这类细节上的常见错误。

主要能力与规则:写入前先读 convex/schema.ts(若存在则读 convex/_generated/ai/guidelines.md);所有函数用对象式语法并同时带 args 与 returns 校验器;读取路径使用 .withIndex(...),不用 .filter() 代替 WHERE;默认 internalQuery/internalMutation/internalAction,仅在客户端 hook 需要时才提升为公开;LLM/聊天功能使用 @convex-dev/agent,多步流程用 @convex-dev/workflow。规则还涵盖:避免无限 .collect(),改用 .withIndex(...) 配合 .paginate(paginationOptsValidator)/.take(n);精确 OR 导入路径,query 等来自 "./_generated/server",api/internal 来自 "./_generated/api";固定值用 v.literal;"use node" 仅限 action 专属模块;ID 用 v.id(tableName);不给已有数据的表加必填字段;自定义索引不含 _creationTime;不存 storage URL 而存 Id 并在读取时用 ctx.storage.getUrl(id);mutation 不执行外部请求,外部 IO 放在 action 中。

使用方式:开始编辑 convex/ 文件前先读 schema,按规则编写,完成后运行 npx tsc --noEmit 并将代码推送到部署环境验证;优先用项目现有部署,若 npx convex whoami 成功则用 npx convex dev --once,否则用 CONVEX_AGENT_MODE=anonymous npx convex dev --once。修复报告的全部错误后再结束。

适用场景:任何涉及 Convex 后端的开发与改动。限制:具体定价、支持平台与更多细节暂未提供。