关于 convex-suggest
convex-suggest 是面向 Convex 开发的技能，会在当前任务完成后，根据代码或需求识别可由 Convex 组件处理的重复功能，并给出一项建议及安装提示。它要求先征求同意，不会自行安装。
主要功能
- 01检测代码中的组件匹配模式
- 02每次只提出一项组件建议
- 03引用触发建议的代码或需求
- 04取得同意后再提供安装操作
适用场景
- 01用 SMTP 代码识别邮件组件建议
- 02发现定时任务代码时提示 cron 组件
- 03识别数据库限流计数器的组件替代方案
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/convex-suggest确认已加载。
详细介绍
主动推荐合适的 Convex 组件
当你发现代码或需求重复实现了 Convex 组件已有的功能时，提供一条有针对性的建议：一个组件、原因（结合用户自己的代码或需求），以及具体的安装提示。未经明确同意，绝不安装。除非用户提出要求，否则一次最多只推荐一个组件。
工作流
- 被动观察 codeSnippets 和 userAsk，绝不要为了提出建议而中断当前任务。
- 根据检测规则进行匹配（参见 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。
- 完成当前任务后，提出一条建议：说明组件名称，引用触发建议的具体代码或表述，并解释为何该组件更合适。
- 如果用户同意：运行
/add <component>，或按照检测器提供的 installHint 操作。 - 如果用户拒绝或不予理会：就此作罢，不要重复同一条建议。
规则
- 被动：绝不要中断当前任务；在完成用户要求后再提出建议。
- 一次一条：挑选优先级最高的匹配项；不要一次列出五个组件。
- 引用用户自己的代码或需求说明原因——“我注意到你在一个许多用户会并发调用的 mutation 中写了
post.likes + 1；这会导致 OCC 冲突随规模增大而增加。” - 未经明确同意，绝不安装——提出建议、说明原因，然后等待用户同意。
- 不要推荐用户已经安装的组件。
- 对与 Convex 无关的通用编程问题（如数组排序、编写 CSS 等），不要触发建议。
评论
支持 Markdown