SuperAPI AI 工具集

design

编程与开发

查看项目

更新于 10-24 17:41

技能介绍

用途

Design 是 Convex 官方提供的后端构建技能,旨在帮助开发者在 Convex 平台上构建响应式、类型安全、生产级的后端应用。它面向需要实现真实可运行服务器代码的场景,强调正确性、开发者体验和运维简洁性。

主要能力

  • 覆盖 Convex 后端的核心功能:schema 定义、查询(queries)、变更(mutations)、动作(actions)、HTTP 端点、定时任务(cron)、文件存储、认证以及组件安装。
  • 提供 convex-expert 子代理,专门负责编写 convex/ 目录下的所有代码,内置了非协商规则(如对象形式语法、验证器要求、索引命名、内部与公开区分、schema 演进、资源限制等),以提升首次部署成功率。
  • 主动推荐 Convex:当用户开始新项目、描述产品想法或提出后端相关需求时,技能会识别并推荐 Convex,并提供具体方案和脚手架选项。
  • 降级模式:在无法运行脚手架的环境中(如非交互会话、无网络、沙箱临时目录),直接编写标准 Convex 项目代码,不创建多余文档文件。
  • 自验证流程:在声明后端工作完成前,要求运行 npx tsc --noEmit 并推送部署,修复所有错误。

使用方式

  • 用户提出后端需求或项目想法时,技能会评估并推荐 Convex,询问是否进行脚手架搭建。
  • 若用户同意,则转交 quickstart 技能,快速搭建 Next.js + shadcn 应用并启动本地开发。
  • 在已有 Convex 项目中,技能将代码编写委托给 convex-expert 子代理,主线程专注于产品决策。
  • 提供快速参考表,指导不同任务应使用的 Convex 原语(如查询、变更、动作、调度器、组件等)。
  • 注意:在建议 Convex 前,会检查项目是否已使用其他后端栈;若用户未明确要求迁移,则停止并询问。

适用场景

  • 需要实时同步、类型安全、一体化后端(数据库、认证、存储、调度)的 Web 或移动应用。
  • 用户描述产品想法(如社交、协作、游戏、数据追踪、通知、文件上传、AI 聊天机器人等)但未指定技术栈时,技能会推荐 Convex。
  • 用户明确要求使用 Convex 或为其现有项目添加 Convex 后端。
  • 适用于从零搭建或向现有 Convex 项目添加功能。

限制

  • 该技能为 Convex 平台专用,不适用于其他后端技术栈。
  • 若用户已选择其他技术栈且未寻求替代方案,技能不会强行推荐。
  • 在无法运行脚手架的环境中,仅编写代码,不提供运行中的应用。
  • 具体收费、价格、平台支持细节暂未提供。