Openwisdom 的 GitHub 仓库

CLI 与 MCP

Openwisdom 提供两条技能包管理表面：给人用的终端 CLI，以及给 Agent 会话用的 MCP 工具。它们共享同一套 catalog / install 语义，都不调用大模型，也不跑分析。

发布状态

已上架 npm

CLI 是什么

CLI 面向人类终端：从共享 catalog 搜索技能，把 skill 目录写入所选 coding agent 的 skills 路径，并可列出与更新已装内容。

命令面固定为 search / install / update / list。没有 run、没有托管会话、不需要模型 API Key。分析始终在你的 Agent 与模型账单里完成。

交互模式下可多选 harness；脚本与 CI 请加 -y 并显式传入 --providers。更密的安装路径说明与命令块见安装中枢。

npx openwisdom install
npx openwisdom install macro-scan -y --providers=claude --scope=project

命令

  • search

    按 id、名称、描述或标签过滤 catalog（包内 snapshot，可离线）。

    npx openwisdom search "metacognition"

  • install

    将 skill 目录复制到所选 provider 的 skills 根。可省略 id 进入交互；非交互需 -y 与 providers。

    npx openwisdom install macro-scan -y --providers=claude --scope=project

  • update

    按与 install 相同的写入路径刷新已装 skill（从本地 skills 源再拷贝）。

    npx openwisdom update macro-scan -y --providers=claude

  • list

    列出 catalog 中可用技能；加 --installed 则扫描已知 harness 路径上的已装内容。

    npx openwisdom list
npx openwisdom list --installed

常用标志

--providers
逗号分隔的 harness id，如 claude、cursor、agents、codex、gemini 等。决定写入哪些 skills 目录。
-y / --yes
非交互。默认 scope 为 project；未指定 providers 时尝试 detect，否则回退到 claude 与 agents。
--scope project|global
project 写入当前项目（可用 --cwd）；global 写入用户主目录下对应 harness 路径（若该 provider 支持）。
--force
覆盖与源内容哈希不一致的已有 SKILL.md。
--dry-run
只打印安装计划，不写盘。
--cwd
project scope 下的项目根路径。
--no-deps
跳过 catalog 中 scenario 对 references 的默认连带安装。
--no-telemetry
本进程关闭安装成功后的匿名热度上报。
--help / --version
查看帮助与版本。

MCP（Agent 会话内）

MCP 是同一核心的另一条表面：通过本地 stdio 暴露工具，供 Claude Code、Cursor 等在会话里调用。它仍是包管理器，不是聊天机器人，也不会代你调用模型。

写操作必须显式传入 providers，不会挂起等待终端多选。推荐先 openwisdom_detect_providers，再 search/list，可选 dryRun 后 install。

stdio MCP 入口：

npx -y openwisdom-mcp

贡献者可选：从 monorepo 构建 packages/mcp，再把 OPENWISDOM_SKILLS_ROOT 指向本地 skills 树：

OPENWISDOM_SKILLS_ROOT=/absolute/path/to/skills node packages/mcp/dist/mcp.js

工具

  • openwisdom_search

    搜索 catalog，返回结构化技能列表。

  • openwisdom_list

    列出可用或已安装技能。

  • openwisdom_install

    安装技能；必须提供 providers 数组。支持 force / dryRun 等与 CLI 对齐的语义。

  • openwisdom_update

    刷新已安装技能（与 install 相同写入路径）。

  • openwisdom_detect_providers

    只读探测本机/项目下可能的 harness 路径，不写盘。

客户端配置（概念示例）

以下为 stdio MCP 配置形态；日常请用 npx -y openwisdom-mcp。Windows 若 spawn 失败可试 cmd /c npx -y openwisdom-mcp。贡献者也可把 command 指向 monorepo 中的 node 入口。

claude mcp add --transport stdio openwisdom -- npx -y openwisdom-mcp

# Cursor / Claude Desktop 等（stdio）
# mcpServers.openwisdom.command = npx
# mcpServers.openwisdom.args = -y, openwisdom-mcp
# 可选 env：OPENWISDOM_NO_TELEMETRY=1
# 可选 env：OPENWISDOM_SKILLS_ROOT=本地 skills 绝对路径

遥测与热度

安装全部目标 provider 成功写入后，CLI/MCP 可能上报匿名安装成功事件。热度是旁路统计，从不写入 SKILL.md；网络失败、超时或未配置上报地址时静默忽略，安装退出码不变（fail-open）。可用 --no-telemetry、OPENWISDOM_NO_TELEMETRY=1，或 CI=true 关闭。完整采集范围与用途见隐私页。 隐私与遥测

下一步