/ 目录 / 演练场 / convexskills
● 社区 waynesutton ⚡ 即开即用

convexskills

作者 waynesutton · waynesutton/convexskills

12个Convex专属技能,涵盖函数、schema、实时更新、定时任务、HTTP操作、文件存储、agents、安全审计和迁移。

专为Convex开发打造的精选技能集合。每个SKILL.md文件(包含有效的Agent Skill前置元数据、代码示例和最佳实践)教你Convex的地道写法:query vs mutation vs action的差异、响应式实时更新、定时任务、HTTP webhooks、schema验证器、数据迁移和安全审计。这样Claude就不会乱造Convex API了。

为什么要用

核心特性

实时演示

实际使用效果

convexskills-skill.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "convexskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "convexskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "convexskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "convexskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "convexskills-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "convexskills-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/waynesutton/convexskills",
          "~/.claude/skills/convexskills"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add convexskills-skill -- git clone https://github.com/waynesutton/convexskills ~/.claude/skills/convexskills

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: convexskills

从零开始搭建一个Convex应用,包含实时更新、认证和文件上传

👤 开始新Convex项目的全栈开发者 ⏱ ~90 min intermediate

何时使用: 你刚开始一个新项目,想从一开始就用对Convex的写法。

前置条件
  • Convex CLI — npm create convex
步骤
  1. 设计schema
    使用convex-schema-validator技能。为users、projects和files设计表格,并设置好索引。✓ 已复制
    → Schema使用v.id()、索引已声明、关系正确
  2. 连接query和mutation
    使用convex-functions技能。为projects实现CRUD操作。✓ 已复制
    → 读操作用query,写操作用mutation,不滥用action
  3. 添加实时更新和文件上传
    使用convex-realtime和convex-file-storage让projects实时更新并支持文件附件。✓ 已复制
    → React通过useQuery订阅、文件通过storage.generateUploadUrl存储

结果: 一个结构正确、可以继续开发的Convex应用。

注意事项
  • 在只需要mutation的地方使用action — 技能规则:数据库写操作用mutation,外部I/O用action

添加每日定时任务清理过期数据

👤 给Convex应用添加后台维护任务的开发者 ⏱ ~20 min beginner

何时使用: 你需要定时任务但又不想额外维护worker。

步骤
  1. 使用cron技能
    使用convex-cron-jobs。添加一个每日任务,删除sessions表中超过30天的行。✓ 已复制
    → crons.ts条目 + 用于清理的internal mutation
  2. 测试
    给我一个手动触发这个任务的方式用于测试。✓ 已复制
    → 只在开发环境使用的HTTP action或CLI命令

结果: 一个运行在Convex托管调度器上的定时任务。

注意事项
  • 定时任务运行query而不是internal mutation — 技能规则:删除操作必须用internal mutation

审计Convex应用的授权漏洞

👤 生产上线前的开发者 ⏱ ~45 min advanced

何时使用: 应用已经开发好,但你还没有做过认证安全压测。

步骤
  1. 运行审计
    在这个仓库运行convex-security-audit。检查每个public mutation是否有正确的认证。✓ 已复制
    → 每个函数的认证状态及严重程度
  2. 修复
    应用修复方案,添加身份验证,未授权的读操作返回null。✓ 已复制
    → 函数已用ctx.auth检查进行更新

结果: 上线前认证更加严格。

注意事项
  • 依赖'public=未认证'的思维模式 — Convex的public函数在互联网上可访问;技能强制要求认证检查
搭配使用: github

组合

与其他 MCP 搭配,撬动十倍杠杆

convexskills-skill + github

技能设计和实现;GitHub MCP开PR

用convex技能构建功能,然后用这些变化开一个PR。✓ 已复制
convexskills-skill + playwright-skill

构建Convex后端,然后用Playwright测试UI端到端

实现Convex后端,然后写一个playwright-skill测试来测试UI并验证实时更新。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
convex-functions 函数需求 任何函数相关工作 0
convex-schema-validator 数据模型 设计或修改表格 0
convex-realtime UI用例 添加响应式UI 0
convex-cron-jobs 定时任务 周期性后台任务 0
convex-migrations schema修改 演进现有schema 0
convex-security-audit 仓库 生产前审查 0

成本与限制

运行它的成本

API 配额
该技能不占用配额;Convex有自己的免费和付费等级
每次调用 Token 数
每加载一个技能消耗2-6k token
费用
免费——技能是本地的。Convex提供了慷慨的免费等级。
提示
指定具体的技能名称(如convex-cron-jobs)以避免加载完整集合。

安全

权限、密钥、影响范围

凭据存储: 技能中没有凭据。Convex的deploy key存储在你的.env文件中。
数据出站: 技能本身不涉及数据流出

故障排查

常见错误与修复

Claude在只需要mutation的地方写了action

技能强制的原则:仅涉及数据库 → mutation;外部I/O → action。

Schema修改破坏了现有数据

使用convex-migrations技能——它能规划安全的转换并包含回填。

useQuery没有实时更新

检查反应性:query必须读取改变的数据,而不是陈旧的索引。

替代方案

convexskills 对比其他方案

替代方案何时用它替代权衡
手动查阅Convex文档和示例你已经是有经验的Convex开发者没有技能的话入门更慢
特定框架的全栈技能你没有使用Convex不同的技术栈

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills