Convex可复用后端组件构建
根据业务需求与数据模型,自动创建具备隔离数据表、独立Schema与边界API的Convex后端组件并接入主应用。
功能与用途
该能力专为Convex后端架构设计,指导并自动生成具有严格数据隔离与类型安全边界的后端组件。它会协助开发者规划独立的数据表结构、配置组件内部的schema与函数,明确鉴权与环境变量等边界传递规则,并通过在主应用中挂载包装层函数,帮助开发者将通知系统、第三方集成或跨项目业务逻辑以模块化方式安全落地。
适用场景
- 通用业务功能独立封装:将应用中的通知中心、审计日志等独立功能封装为带隔离数据表和私有逻辑的 Convex 模块。
- 多项目共享后端组件发布:把跨多个全栈项目共用的持久化状态逻辑抽象为独立组件包,明确出入参接口以便多处复用。
- 第三方集成与主应用隔离:接入需持久化事件流的第三方服务,在隔离表空间完成计算并通过薄包装层向外暴露受控接口。
适用人群
- 使用Convex进行全栈开发的工程师
- 需要重构单体后端架构的TypeScript开发者
- 希望在多个Convex项目间共享业务模块的架构师
使用步骤
- 明确需要组件化的业务目标,评估是否需要独立数据表与持久化状态,并确定是本地组件还是跨工程发布组件。
- 规划组件私有数据表结构(schema.ts)及对外暴露的公开函数与参数验证器(v.validator)。
- 在 convex/components/<name>/ 目录下生成组件定义与业务逻辑代码,所有函数严格从组件私有的 _generated/server 导入。
- 在主应用的 convex/convex.config.ts 中通过 app.use 引入该组件。
- 在主应用中编写处理认证(ctx.auth)与环境变量(process.env)的包装函数,并通过 ctx.runQuery/runMutation 调用组件内部接口。
- 运行 npx convex dev 校验类型生成与边界契约,修复潜在的类型报错。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Builds reusable Convex components with isolated tables and app-facing APIs.
依赖与权限
- OPENAI_API_KEY
- 读取用户主动提供的内容