用途:这是一个“新鲜度”层技能,叠加在 convex-expert 的固定知识之上,用于解决组件新增导出、CLI 标志变化、API 跨版本改名等易过时的问题,确保写出的 Convex 代码与项目实际安装版本一致。
主要能力与工作流:
- 固定版本:读取已安装的 convex 版本,可用 node -p "require('./node_modules/convex/package.json').version",并确认 package.json 以及涉及的 @convex-dev/* 组件版本;受信任的文档必须与这些版本匹配,版本偏差是错误 Convex 代码的最大来源。
- 新鲜度层级(先取最省成本且正确的来源):优先使用已提供的文档工具或 MCP 的 search_convex_docs;否则以 Markdown 形式抓取具体页面(docs.convex.dev/<path>,站点提供时优先 .md),或按固定版本查看组件 README;最后才退回通用网络搜索,并将其版本视为未验证。当前性存疑时不得跳过检索直接凭记忆写 API。
- 必要时核对已安装包:不确定某个组件导出是否存在时,检查 node_modules/@convex-dev/<x>/ 的 package.json exports 与 .d.ts,安装的类型是当前版本的权威依据,胜过任何文档页面。
- 窄范围使用查到的事实:应用当前签名或标志,注明来源(页面与版本),再把代码交回 convex-expert 以惯用方式撰写。遇到“本应存在却不存在”的导出或标志导致版本不匹配构建错误时,应视为当前性问题,重新固定版本并抓取当前 API,而不是猜测拼写。
适用场景:在编写或修改 Convex 代码、升级组件、排查构建错误时验证 API 现状。
限制:该技能是新鲜度补充层,不替代 convex-expert 的固定知识;资料未提供具体支持的工具清单、安装命令、收费方式或平台范围。