wip-universal-installer

面向 agent-native 软件的参考安装器。扫描代码仓库，自动识别其暴露的各类接口，并一次性完成全部安装。

适用场景

请在以下情况下使用 wip-install：

• 安装任何遵循 Universal Interface 模式的代码仓库
• 探测某个代码仓库提供了哪些接口
• 通过单条命令完成 CLI 工具、MCP 服务器、OpenClaw 插件及 Claude Code 钩子（hook）的配置与安装

请在以下情况下使用 detect.mjs：

• 以编程方式探测代码仓库中声明的接口
• 构建自定义安装器或 CI 流水线
• 验证代码仓库是否符合 Universal Interface 规范

不适用场景

• 安装标准 npm 包（请直接使用 npm）
• 不遵循 Universal Interface 约定的代码仓库
• 代码构建或编译任务（本工具仅执行安装操作，不涉及构建）

API 参考文档

CLI

wip-install /path/to/repo           # 安装所有检测到的接口
wip-install org/repo                 # 从 GitHub 克隆仓库并安装
wip-install --dry-run /path/to/repo  # 仅执行接口探测，不进行任何修改
wip-install --json /path/to/repo     # 以 JSON 格式输出探测结果

模块（detect.mjs）

import { detectInterfaces, describeInterfaces, detectInterfacesJSON } from './detect.mjs';

const { interfaces, pkg } = detectInterfaces('/path/to/repo');
console.log(describeInterfaces(interfaces));

const json = detectInterfacesJSON('/path/to/repo');
console.log(JSON.stringify(json, null, 2));

Universal Interface

完整规范详见 SPEC.md。

1. CLI …… 由 package.json 中的 bin 字段定义
2. Module …… 由 package.json 中的 main 或 exports 字段定义
3. MCP Server …… 由 mcp-server.mjs 文件定义
4. OpenClaw Plugin …… 由 openclaw.plugin.json 文件定义
5. Skill …… 由 SKILL.md 文件定义
6. Claude Code Hook …… 由 guard.mjs 或 claudeCode.hook 文件定义