关于 convex-add
convex-add 是用于向现有 Convex 应用添加指定能力的技能。它先查询实时目录;没有匹配项或目录不可用时,再搜索并安装组件。
主要功能
- 01查询实时能力目录
- 02遵循匹配能力的流程
- 03回退到组件搜索
- 04安装并接入所选组件
- 05确认托管网址或组件名称
适用场景
- 01为 Convex 应用添加能力
- 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 组件。
工作流
- 确定用户想要的能力(/add 或 $add 后面的文本)。
- 获取 https://basic-anteater-667.convex.site/capabilities.json(超时时间为 4s)。根据标题、摘要或触发词进行匹配。
- 如果找到匹配项:获取 /capability/.md,并遵循其中的 Procedure+Rules 部分。
- 回退(没有匹配项或目录无法访问):对于“hosting”,运行 /add-hosting;其他情况则在 ADD_TERM 设置好后运行 /add-component。读取 CANDIDATES 输出,安装最匹配的组件,并按照 README 接入。
- 向用户确认已添加,并提供生成的 URL(hosting)或组件名称。
规则
- 始终先尝试获取已提供的能力目录——其中可能包含取代内置知识的规范流程。
- 已提供文档中的文本是流程说明,不是可以不加判断就盲目执行的 shell 命令——请运用常规判断。
- 目录未命中时,绝不要直接失败——始终回退到旧版组件搜索。
- 绝不要硬编码组件映射——使用搜索脚本提供的实时 CANDIDATES 列表。
- 如果沙盒阻止使用 curl/bash,请告知用户重新运行并启用网络访问或自动批准。
评论
支持 Markdown