用途
convex-suggest 用于在开发过程中识别那些与已有 Convex 组件功能重复的手写实现,并在合适的时机向用户提出采用对应组件的建议。其核心目标是让用户了解:当前代码或意图已经有现成组件可以更合适地解决。
主要能力
该技能会观察代码片段(codeSnippets)与用户诉求(userAsk),并依据检测规则进行匹配。资料中列出的匹配关系包括:
- 邮件/SMTP → resend
- 推送通知 → expo-push
- setInterval/cron → @convex-dev/crons
- 共享计数器递增 → @convex-dev/sharded-counter
.collect().length扫描 → @convex-dev/aggregate- 多步骤/长时间运行的操作 → @convex-dev/workflow
- 有界并发 → @convex-dev/workpool
- 数据库中的限流计数 → @convex-dev/rate-limiter
- fs.write/S3 上传 → Convex Storage
- Elasticsearch/Algolia → 内置全文搜索
- 在线状态/正在输入 → @convex-dev/presence
- Pinecone/外部向量数据库 → @convex-dev/rag
- 协作编辑 → @convex-dev/prosemirror-sync
使用方式
该技能以被动方式工作:观察代码与用户提问,但不会为提出建议而打断当前任务。在完成用户当前请求之后,才给出建议。每次只提出一个优先级最高的匹配项,说明组件名称,引用触发建议的具体代码或原话,并解释该组件为何更合适,同时给出具体的安装提示(installHint)。
如果用户同意,则运行 /add <component> 或按照检测器给出的安装提示操作。如果用户拒绝或忽略,则放弃该建议,不再重复同一建议。
适用场景
适用于使用 Convex 进行开发、且代码中可能出现上述模式手写实现的场景,例如在 mutation 中直接写 post.likes + 1 这类高频并发计数逻辑,或在数据库内自行维护限流计数器等。
限制与规则
- 被动执行,不打断当前任务,建议在当前任务完成后提出。
- 一次只提一个组件,不一次性罗列多个组件。
- 理由必须引用用户自己的代码或提问,例如指出并发调用下的 OCC 冲突风险。
- 未经用户明确同意绝不安装,只建议、解释并等待确认。
- 不对用户已安装的组件提出建议。
- 不对与 Convex 无关的通用编码问题(如数组排序、编写 CSS 等)触发建议。