convex-expert 是针对 Convex 后端代码的开发 Skill。它从现有数据结构出发,指导 AI 编写查询、数据修改、外部调用和验证器,适合新增功能或维护 convex 目录里的代码。
它关注的一个问题是数据长大后的读取方式。测试库只有几条记录时,把整张表读出来很方便;记录持续增加后,这种无上限读取就可能成为负担。它要求为访问路径考虑索引、数量限制或分页。
另一个重点是函数边界:哪些供客户端调用,哪些只在后端内部使用,不能混在一起。参数和返回值也要有明确校验,固定的状态集合不应随便退化成任意字符串。
它还区分查询、修改和外部 I/O 的职责,避免把网络请求塞进不适合的执行环境。已有数据的表新增必填字段时,先让旧数据兼容,再回填和收紧规则。
你提供 schema、调用需求和项目版本后,它才能沿现有结构实现。完成时需要类型检查和相应环境的后端验证;具体组件接口则要以当前安装版本为准,不能只因为本地热更新没有报错就算后端完成。