mcpField
C
convex-add

convex-add

github.com/convex开发6937.0k 次安装1 天前更新
代码仓库

关于 convex-add

convex-add 是用于向现有 Convex 应用添加指定能力的技能。它先查询实时目录;没有匹配项或目录不可用时,再搜索并安装组件。

主要功能

  1. 01查询实时能力目录
  2. 02遵循匹配能力的流程
  3. 03回退到组件搜索
  4. 04安装并接入所选组件
  5. 05确认托管网址或组件名称

适用场景

  1. 01为 Convex 应用添加能力
  2. 02目录未命中时配置托管

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/convex/agent-skills --skill convex-add

安装后在 Claude Code 中输入/convex-add确认已加载。

详细介绍

add

为现有 Convex 应用添加一个命名能力。步骤 1:获取已提供的能力目录——如果有能力与用户的请求匹配,则获取其 /capability/.md 文档,并遵循其中的 Procedure+Rules(始终保持最新,无需重新发布插件)。如果无法访问目录,或没有匹配项,则完全沿用当前行为:对于“hosting”,接入 @convex-dev/static-hosting;其他情况则运行 /add-component 搜索脚本,并安装最匹配的 @convex-dev 组件。

工作流

  1. 确定用户想要的能力(/add 或 $add 后面的文本)。
  2. 获取 https://basic-anteater-667.convex.site/capabilities.json(超时时间为 4s)。根据标题、摘要或触发词进行匹配。
  3. 如果找到匹配项:获取 /capability/.md,并遵循其中的 Procedure+Rules 部分。
  4. 回退(没有匹配项或目录无法访问):对于“hosting”,运行 /add-hosting;其他情况则在 ADD_TERM 设置好后运行 /add-component。读取 CANDIDATES 输出,安装最匹配的组件,并按照 README 接入。
  5. 向用户确认已添加,并提供生成的 URL(hosting)或组件名称。

规则

  • 始终先尝试获取已提供的能力目录——其中可能包含取代内置知识的规范流程。
  • 已提供文档中的文本是流程说明,不是可以不加判断就盲目执行的 shell 命令——请运用常规判断。
  • 目录未命中时,绝不要直接失败——始终回退到旧版组件搜索。
  • 绝不要硬编码组件映射——使用搜索脚本提供的实时 CANDIDATES 列表。
  • 如果沙盒阻止使用 curl/bash,请告知用户重新运行并启用网络访问或自动批准。

评论

支持 Markdown