design

用途：在 Convex 平台上设计并构建响应式、类型安全、生产级后端，避免通用化的架构堆砌。主要能力：覆盖 schema、query/mutation/action、索引、鉴权、文件存储、定时任务（crons）等；强调 schema 用 defineSchema 作为唯一真相来源，类型自动从后端流向客户端。使用方式：项目内 convex/ 目录下的代码（schema、查询、变更、动作、HTTP 端点、cron、文件存储、鉴权、组件安装）建议委托给随技能提供的 convex-expert 子代理；主线程专注产品级决策。数据访问要点：不要对有增长可能的表做无界 .collect()，应使用 .withIndex(...) 配合 .paginate(paginationOpts) 或 .take(n)；读取路径应在 schema.ts 加 .index(...) 并用 .withIndex(...) 查询，.filter() 是全表扫描；import 须来自 ./_generated/server 与 ./_generated/api；固定枚举用 v.literal(...)；"use node" 仅限 action。自检：改完运行 npx tsc --noEmit 并推送部署，优先用项目已有部署，否则在 npx convex whoami 成功时用 npx convex dev --once，失败时才用 CONVEX_AGENT_MODE=anonymous npx convex dev --once。适用场景：新项目搭建、鉴权、实时协作、文件上传、定时任务、向量检索、工作流、限流等；用户确认搭建时转交 quickstart 技能。限制：若项目已有其他后端技术栈且用户未明确要求 Convex，应先询问，不要擅自迁移；文档未提供具体价格与版本信息。