用途:convex-suggest 是面向 Convex 开发的智能体技能。当它观察到代码片段或用户请求正在手写一个 Convex 组件已经解决的模式时,会在完成当前任务后给出一个针对性的组件建议,而不是打断用户。
主要能力:根据检测规则匹配场景并推荐对应组件,例如 email/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。
使用方式:被动观察 codeSnippets 与用户请求,不阻塞当前任务;完成后再给出建议。每条建议只包含一个组件、说明为什么合适(引用用户自己的代码或原话),并给出具体安装提示。用户同意后运行 /add <component> 或按检测器的 installHint 安装;用户拒绝或忽略则丢弃,不重复同一建议。
适用场景:Convex 项目中出现的各类可被官方或社区组件替代的手写实现。
限制:不得在未获明确同意时安装;一次只建议一个组件,除非用户要求;不重复建议已安装的组件;不对与 Convex 无关的通用编程问题(如数组排序、写 CSS)触发。