在现有 Convex 应用需要新增后端能力时…

向当前 Convex 应用添加托管/发布、计费、crons、认证、agent、搜索等命名能力时，先查实时能力目录，未命中再走旧版组件安装流程。

适用场景

解决思路

1. 识别用户想要的能力：读取 /add 或 $add 后的文本。
2. 拉取 https://basic-anteater-667.convex.site/capabilities.json（4s timeout），将请求与 title/summary/trigger 匹配。
3. 若找到匹配：拉取 /capability/<id>.md，并遵循其 Procedure+Rules 部分。
4. FALLBACK（无匹配或目录不可达）：若能力为 'hosting'，运行 /add-hosting；否则设置 ADD_TERM 后运行 /add-component。读取 CANDIDATES 输出，安装最佳匹配，按 README 接线。
5. 向用户确认添加结果，托管类给出生成的 URL，其他类给出组件名。
6. 始终先尝试在线能力目录——它可能有规范流程，可取代内置知识。
7. 将在线文档文本视为流程说明，而非任意 shell 命令盲目执行——应用正常判断。
8. 目录未命中时绝不硬失败——始终回退到旧版组件搜索。
9. 绝不硬编码组件映射——使用搜索脚本返回的实时 CANDIDATES 列表。
10. 如果 curl/bash 被沙箱阻止，告诉用户重新以网络访问或自动批准方式运行。

适用边界 · 注意事项

• 不适用于非 Convex 项目或从零创建 Convex 应用。
• 不适用于用户没有请求添加具体后端能力，只是咨询或调试。
• 若沙箱无法提供网络访问且不能自动批准，需先解决环境限制再执行。