● 社区
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了。
为什么要用
核心特性
- 12个Convex专属技能，包含真实代码示例
- 涵盖函数类型（query/mutation/action/HTTP）、schema、实时更新、定时任务、文件存储、agents
- 两个安全技能：convex-security-check 和 convex-security-audit
- schema演进的迁移模式
- convex-component-authoring 用于创建可复用组件
实时演示
实际使用效果
convexskills-skill.replay
▶ 就绪
使用场景
实战用法： convexskills
何时使用： 你刚开始一个新项目，想从一开始就用对Convex的写法。
前置条件
- Convex CLI — npm create convex
步骤
-
设计schema
使用convex-schema-validator技能。为users、projects和files设计表格，并设置好索引。✓ 已复制
→ Schema使用v.id()、索引已声明、关系正确
-
连接query和mutation
使用convex-functions技能。为projects实现CRUD操作。✓ 已复制
→ 读操作用query，写操作用mutation，不滥用action
-
添加实时更新和文件上传
使用convex-realtime和convex-file-storage让projects实时更新并支持文件附件。✓ 已复制
→ React通过useQuery订阅、文件通过storage.generateUploadUrl存储
结果： 一个结构正确、可以继续开发的Convex应用。
注意事项
- 在只需要mutation的地方使用action — 技能规则：数据库写操作用mutation，外部I/O用action
何时使用： 你需要定时任务但又不想额外维护worker。
步骤
-
使用cron技能
使用convex-cron-jobs。添加一个每日任务，删除sessions表中超过30天的行。✓ 已复制
→ crons.ts条目 + 用于清理的internal mutation
-
测试
给我一个手动触发这个任务的方式用于测试。✓ 已复制
→ 只在开发环境使用的HTTP action或CLI命令
结果： 一个运行在Convex托管调度器上的定时任务。
注意事项
- 定时任务运行query而不是internal mutation — 技能规则：删除操作必须用internal mutation
何时使用： 应用已经开发好，但你还没有做过认证安全压测。
步骤
-
运行审计
在这个仓库运行convex-security-audit。检查每个public mutation是否有正确的认证。✓ 已复制
→ 每个函数的认证状态及严重程度
-
修复
应用修复方案，添加身份验证，未授权的读操作返回null。✓ 已复制
→ 函数已用ctx.auth检查进行更新
结果： 上线前认证更加严格。
注意事项
- 依赖'public=未认证'的思维模式 — Convex的public函数在互联网上可访问；技能强制要求认证检查
组合
与其他 MCP 搭配，撬动十倍杠杆
技能设计和实现；GitHub MCP开PR
用convex技能构建功能，然后用这些变化开一个PR。✓ 已复制
构建Convex后端，然后用Playwright测试UI端到端
实现Convex后端，然后写一个playwright-skill测试来测试UI并验证实时更新。✓ 已复制
成本与限制
运行它的成本
- API 配额
- 该技能不占用配额；Convex有自己的免费和付费等级
- 每次调用 Token 数
- 每加载一个技能消耗2-6k token
- 费用
- 免费——技能是本地的。Convex提供了慷慨的免费等级。
- 提示
- 指定具体的技能名称（如convex-cron-jobs）以避免加载完整集合。
安全
权限、密钥、影响范围
凭据存储： 技能中没有凭据。Convex的deploy key存储在你的.env文件中。
数据出站： 技能本身不涉及数据流出
- Convex的public函数在互联网上可访问。上线前务必运行convex-security-audit。
故障排查
常见错误与修复
Claude在只需要mutation的地方写了action
技能强制的原则：仅涉及数据库 → mutation；外部I/O → action。
Schema修改破坏了现有数据
使用convex-migrations技能——它能规划安全的转换并包含回填。
useQuery没有实时更新
检查反应性：query必须读取改变的数据，而不是陈旧的索引。
替代方案
convexskills 对比其他方案
| 替代方案 | 何时用它替代 | 权衡 |
|---|
| 手动查阅Convex文档和示例 | 你已经是有经验的Convex开发者 | 没有技能的话入门更慢 |
| 特定框架的全栈技能 | 你没有使用Convex | 不同的技术栈 |