convex-add 用于向当前已有的 Convex 应用添加一项具体能力。用户以 /add 或 $add 后接能力名称的方式提出请求,技能据此识别目标能力。
主要能力与使用方式:
- 识别能力:读取 /add 或 $add 之后的文本,确定用户想要添加的能力。
- 查询在线能力目录:访问 https://basic-anteater-667.convex.site/capabilities.json(超时 4 秒),将请求与目录条目的标题、摘要、触发词进行匹配,覆盖计费、定时任务(crons)、认证、agent、搜索等能力。
- 按目录文档执行:若匹配成功,获取对应的 /capability/.md 文档,依照其中的 Procedure 与 Rules 执行。文档内容被视为流程说明,需结合正常判断使用,而非盲目执行的任意 shell 命令。
- 回退机制:若目录不可达或无匹配项,则回退到原有行为——对 hosting 请求运行 /add-hosting,接入 @convex-dev/static-hosting;其他请求设置 ADD_TERM 后运行 /add-component 搜索脚本,读取 CANDIDATES 输出,安装最匹配的 @convex-dev 组件并按该组件 README 完成接线。
- 结果确认:向用户确认添加结果,提供生成的 URL(hosting 场景)或组件名称。
规则要点:始终优先尝试在线能力目录;不得硬编码组件映射,应使用搜索脚本返回的实时 CANDIDATES 列表;目录未命中时不得直接失败;若 curl/bash 被沙箱阻止,应提示用户以网络访问权限重新运行或自动批准。
适用场景:在已有 Convex 项目中快速引入计费、定时任务、认证、agent、搜索或静态托管等能力,并希望获得始终最新的标准流程。
限制:依赖在线能力目录与网络访问;目录不可用时仅能依赖回退的组件搜索;具体可用能力以目录实时内容为准。