用途:在改动 convex/ 目录下任何文件前调用的 Convex 后端专家技能,覆盖函数、schema、索引、查询、mutation、action、HTTP 端点等后端工作。使用方式:写或改 convex/ 下文件前先读 convex/schema.ts(若存在再读 convex/_generated/ai/guidelines.md);所有函数用对象形式并为 args 与 returns 添加校验器;读路径统一用 .withIndex(...) 而非 .filter();默认使用 internalQuery/internalMutation/internalAction,仅在客户端 hook 需要时才公开。LLM/聊天类功能使用 @convex-dev/agent,多步流程使用 @convex-dev/workflow,不自行实现。写完后确认 convex dev 推送成功并修复校验错误。主要规则:避免对大表做无界 .collect(),改用 .withIndex 配合 .paginate 或 .take;为每个读路径在 schema.ts 中添加 .index 并用 .withIndex 查询;query/mutation/action 及 internal 版本从 ./_generated/server 导入,api 与 internal 从 ./_generated/api 导入,错误导入会导致部署失败;固定取值用 v.literal;"use node" 仅限 action 模块顶部;ID 用 v.id(tableName);不给已有数据的表新增必填字段,先 optional 再回填后收紧;自定义索引不含 _creationTime;表中存 Id<'_storage'> 而非 URL,读取时调 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,并修复所有报错。限制:资料未提供收费、价格与平台支持等具体信息。
convex-expert
编程与开发
更新于 10-16 03:06