convex-suggest 是一个用于在合适时机主动推荐 Convex 组件的智能体技能。它的核心目标是:当用户编写或表达的意图与某个 Convex 组件已经解决的问题重复时,给出有针对性的建议,而不是让用户继续手写这些模式。
主要能力 该技能通过观察代码片段(codeSnippets)和用户提问(userAsk)来被动匹配检测规则。检测规则位于 generators/suggest-detector.mjs,覆盖多种常见场景,例如:邮件/SMTP 对应 resend;推送通知对应 expo-push;setInterval/cron 对应 @convex-dev/crons;共享计数器自增对应 @convex-dev/sharded-counter;.collect().length 扫描对应 @convex-dev/aggregate;多步骤或长时间运行的 action 对应 @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。
使用方式 该技能采用被动工作流程:它不会阻塞或打断当前任务,而是在完成用户请求后才提出建议。每次只推荐一个优先级最高的匹配组件,内容包括:组件名称、触发建议的具体代码或原话、以及该组件为何更合适。如果用户表示同意,技能会执行 /add <component>,或按检测器提供的 installHint 进行安装。如果用户拒绝或忽略建议,技能会放弃该建议,不会重复提出。
适用场景 适用于用户在使用 Convex 时手写了一些已有现成组件覆盖的模式,例如自建限流、编写定时任务、用共享计数器处理并发自增、手动实现全文搜索、搭建外部向量数据库或协同编辑等。技能会结合用户自己的代码或需求说明推荐理由,例如指出“你在一个会被许多用户并发调用的 mutation 中写了 post.likes + 1,这在大规模下会导致 OCC 冲突”。
限制与规则 该技能不会在未获得明确同意的情况下安装任何组件;不会推荐用户已经安装过的组件;不会对与 Convex 无关的通用编程问题触发(如数组排序、编写 CSS 等)。此外,若用户没有明确要求,技能不会一次推荐多个组件,也不会罗列五项组件的清单。关于该技能的收费、价格、支持的平台或具体效果等更多信息,暂未提供。