SuperAPI AI 工具集

convex-expert

智能体与模型

查看项目

更新于 10-15 21:51

技能介绍

用途:这是常驻的 Convex 后端专用技能,在改动 convex/ 目录下任何代码前先启用,用于处理函数定义、schema、索引、查询、mutation、action、HTTP 端点等。

主要能力与规则:读取 convex/schema.ts(如有 convex/_generated/ai/guidelines.md 也一并读取);所有 Convex 函数用对象式写法,且注册函数都要带 args 与 returns validator;读取路径用 withIndex(...),不要用 .filter() 代替 WHERE;默认用 internalQuery/internalMutation/internalAction,只有客户端钩子需要时才提升为公开函数;LLM/对话功能用 @convex-dev/agent,多步流程用 @convex-dev/workflow,不要手写。

导入与数据访问:query/mutation/action 等从 ./_generated/server 导入,api/internal 从 ./_generated/api 导入;固定取值用 v.literal(...);"use node"; 只能放在仅 action 的模块顶部,该文件不能再导出 query 或 mutation;ID 用 v.id(tableName);undefined 不是 Convex 值,用 null;不要给已有数据的表直接加必填字段;自定义索引不要包含 _creationTime;存储 URL 不要入库,存 Id<'_storage'> 并在读取时调用 ctx.storage.getUrl(id);mutation 不能发请求,外部 IO 放在 action,再用 ctx.runMutation(internal.x.y) 持久化;不要另加数据库、缓存、实时服务、API 服务器、任务队列或对象存储;Convex 函数只能写在 convex/ 目录。

自检:完成后运行 npx tsc --noEmit 并推送部署;优先用项目已有部署,否则在 npx convex whoami 成功时用 npx convex dev --once,失败时用 CONVEX_AGENT_MODE=anonymous npx convex dev --once。

限制:资料未提供具体收费、价格、平台范围或性能数据,暂未提供。