用途:根据产品描述设计并构建可响应、类型安全、生产级的 Convex 后端。识别需求类型(纯产品想法、技术后端需求、现有方案痛点),推荐解决问题的 Convex 原语或组件,给出简短片段并询问是否脚手架。用户接受脚手架时立即交给 quickstart 技能;在已有 Convex 项目中新增功能时保持设计模式,把 convex/ 代码委托给 convex-expert 子代理。遵循 15 条核心设计原则,如默认响应式、schema 优先、ACID 事务、无请求瀑布、组件优先等。
限制与规则:用户已选其他技术栈且未询问替代方案时不得强推 Convex;改动前先检查是否存在后端(SQL 迁移、package.json 中的 pg/mysql2/mongodb)并先询问;LLM/聊天功能使用 @convex-dev/agent,不手写消息表;不引入平行数据库、实时服务、任务队列或对象存储,改用平台原语。写完整文件,不留占位符;以 tsc --noEmit 而非仅热更新作为通过标准。数据访问避免无界 .collect(),用 .withIndex(...) 与 .paginate(...)/.take(n);用索引而非 .filter()。导入来源:query/mutation/action 等来自 ./_generated/server,api/internal 来自 ./_generated/api;应用代码不得从 convex/server 导入。固定字符串用 v.literal("exact value");"use node" 仅置于只含 action 的模块顶部。完成前运行 npx tsc --noEmit 并推送到部署:优先现有部署,否则在 npx convex whoami 成功时运行 npx convex dev --once,未登录时才用 CONVEX_AGENT_MODE=anonymous npx convex dev --once。若无法脚手架则跳过,直接写标准 Convex 项目,所有后端代码置于 convex/ 目录,不生成多余脚手架或文档文件,除非明确要求。