convex-suggest

主动推荐合适的 Convex 组件

当你发现代码或需求重复实现了 Convex 组件已有的功能时，提供一条有针对性的建议：一个组件、原因（结合用户自己的代码或需求），以及具体的安装提示。未经明确同意，绝不安装。除非用户提出要求，否则一次最多只推荐一个组件。

工作流

1. 被动观察 codeSnippets 和 userAsk，绝不要为了提出建议而中断当前任务。
2. 根据检测规则进行匹配（参见 generators/suggest-detector.mjs）：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。
3. 完成当前任务后，提出一条建议：说明组件名称，引用触发建议的具体代码或表述，并解释为何该组件更合适。
4. 如果用户同意：运行 /add <component>，或按照检测器提供的 installHint 操作。
5. 如果用户拒绝或不予理会：就此作罢，不要重复同一条建议。

规则

• 被动：绝不要中断当前任务；在完成用户要求后再提出建议。
• 一次一条：挑选优先级最高的匹配项；不要一次列出五个组件。
• 引用用户自己的代码或需求说明原因——“我注意到你在一个许多用户会并发调用的 mutation 中写了 post.likes + 1；这会导致 OCC 冲突随规模增大而增加。”
• 未经明确同意，绝不安装——提出建议、说明原因，然后等待用户同意。
• 不要推荐用户已经安装的组件。
• 对与 Convex 无关的通用编程问题（如数组排序、编写 CSS 等），不要触发建议。