SuperAPI AI 工具集

capability-discovery

部署与运维

查看项目

更新于 10-15 23:43

技能介绍

用途:在起草引用 GitHub Actions、Supabase、Codex 等外部依赖的 kit 之前,先确认环境中实际存在哪些能力,避免虚构工具。

主要能力:检测 $PATH 上的 CLI 工具,包括 gh、git、node、go、rustc、cargo、python3、pip、docker、vercel、supabase、firebase、wrangler、ffmpeg、playwright、codex、graphify;从项目根目录的 .mcp.json 与用户级 ~/.claude.json 解析 MCP 服务器;从 ~/.claude/plugins/installed_plugins.json 解析 Claude Code 插件;检测 codex CLI 是否存在(用于同行评审命令);检测 graphify-out/graph.json 是否存在(用于 graphify-integration 技能)。

使用方式:运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/cavekit-tools.cjs" discover,生成 .cavekit/capabilities.json,记录发现时间、各 CLI 工具布尔值、MCP 服务器列表、插件列表与 codex 可用性。其他命令会读取该文件:/ck:sketch 在提议集成前读取,若缺少工具则添加 Setup 任务或询问用户;/ck:map 将依赖缺失能力的任务标记为 blocked: setup-required;/ck:make 拒绝派发需要缺失 MCP 服务器的子代理;/ck:check 在检查报告中加入 Capability Coverage 部分。

适用场景:安装新 CLI 工具后、增删 MCP 服务器后、每个新项目开始时(通过 /ck:init)、以及任务报错 command not found 时重新运行。该文件重新生成成本低,应始终发现而非猜测。

限制:不检测需要凭据的网络 API(可用性不等于可达性,凭据应单独记录且不提交);不检测 IDE 扩展(无法从循环中脚本化,会造成虚假保证);不检测语言版本(版本固定由项目自身负责,如 package.json、go.mod、pyproject.toml,发现仅确认可执行文件存在)。