SuperAPI AI 工具集

convex

编程与开发

查看项目

更新于 10-16 07:22

技能介绍

用途:作为 Convex 相关任务的入口技能,先判断应加载哪个更具体的子技能;若无匹配,仍适用底部通用规则。

主要能力:按场景路由到子技能,包括 convex-best-practices(通用模式与项目结构)、convex-functions(查询、变更、动作、内部函数、错误处理)、convex-schema-validator(表、索引、校验器、v.* 类型、schema 变更)、convex-realtime(useQuery、乐观更新、分页、在线状态、重渲染抖动)、convex-http-actions(webhook、REST 端点、convex/http.ts、Stripe 或 Clerk 回调)、convex-file-storage(上传、上传 URL、文件服务、存储清理)、convex-cron-jobs(crons.ts、runAfter、runAt、批处理、定时任务不触发)、convex-migrations(回填、字段重命名、带线上数据的 schema 演进)、convex-agents(AI 智能体、线程、工具、流式、基于 @convex-dev/agent 的 RAG)、convex-component-authoring(可复用组件包、defineComponent)、convex-security-check(发布前快速审计)、convex-security-audit(深度审查)、avoid-feature-creep(范围控制)、project-workflow(多步任务、prds/ 中的 PRD、task.md、计划评审)、project-docs(同步 task.md、changelog.md、files.md)、git-safety(revert、undo、reset、checkout、clean、stash、force push)。两个技能常同时适用:领域技能管代码,流程技能管工作流,例如 convex-functions 加 project-workflow。

通用规则:每个函数都声明 args 和 returns 校验器,包括内部函数;读取用 withIndex,表扫描上的 .filter() 是隐患;变更幂等,先检查当前状态,无事可做就提前返回;调度和 cron 只用 internal.* 函数,绝不用 api.*;查询内绝不调用 Date.now(),时间作为参数传入;开发用 npx convex dev,未要求不要运行 npx convex deploy;信任记忆中的 API 前先获取 https://docs.convex.dev/llms.txt。

禁止事项:不要编辑 convex/_generated/ 下任何内容;不要用 crons.daily、crons.hourly、crons.weekly,改用 crons.interval 或 crons.cron;不要在同时导出查询或变更的文件中放 "use node";未先加载 git-safety 不要运行会丢弃工作的 git 命令。

文档:https://docs.convex.dev/llms.txt、https://docs.convex.dev/understanding/best-practices、https://docs.convex.dev/functions。

限制:资料未提供安装命令、收费、价格、平台支持或效果说明。