skills-marketplace:基于 OpenUBMC 生态的 AI 技能库与 MCP 服务器项目

Skills Marketplace for openUBMC

Branch2Tags0

OpenUBMC Skills & MCP

OpenUBMC AI 辅助研发的 Skills 技能库与 MCP 服务器

License Node Version OpenUBMC npm version

简介

本项目为 OpenUBMC 微组件架构提供可复用的 AI Skills(技能)和 MCP 服务器,覆盖设计、编码、测试、调试等研发场景。通过 TUI 安装器可一键安装到 OpenCode、Claude Code、Cursor 等 AI 编码工具中。

快速开始

方式一:VSCode 扩展(推荐)

VSCode 扩展提供可视化界面,支持搜索、浏览、一键安装 Skills。

安装扩展

# 从 .vsix 文件安装
code --install-extension packages/vscode-skills-marketplace/openubmc-skills-marketplace-*.vsix

或者在 VSCode 中:

  1. 打开扩展面板 (Ctrl+Shift+X)
  2. 点击右上角 "..." 菜单 → "Install from VSIX..."
  3. 选择 packages/vscode-skills-marketplace/ 下的 .vsix 文件

使用扩展

  • 按 Ctrl+Shift+P 输入 Open Skills Marketplace
  • 或点击侧边栏 Skills Marketplace 图标
  • 搜索、筛选、批量安装 Skills

方式二:TUI 安装器

npx @openubmc/skills-installer

启动交互式 TUI 界面,支持:

  • 选择要安装的 Skills(多选)
  • 选择 MCP 服务器配置(多选)
  • 选择目标 AI 工具(OpenCode / Claude Code / Cursor / 自定义路径)
  • 一键完成安装

全局安装 TUI

npm install -g @openubmc/skills-installer

# 使用任一命令启动
openubmc-installer
skills-installer

Skills 技能列表

技能 描述 适用场景
lua-component Lua 微组件开发 —— MDS 建模、MDB 接口、Bingo CLI、Conan 构建 新建组件、实现接口、打包发布
mdb-interface-dev MDB 接口开发 —— mdb_interface 定义、MDS 数据建模、bingo gen 代码生成、RPC/IPMI 开发 接口定义、跨组件通信、IPMI 命令
interface-mapping 接口映射配置 —— Redfish/Web-backend/CLI/SNMP 映射、ProcessingFlow、Schema、Statements 新增北向接口、映射配置编写
testing DT 测试 —— UT、IT、覆盖率、LuaUnit 测试用例设计 编写单元/集成测试、覆盖率分析
debugging 系统调试 —— Systemd、Skynet、MDB/D-Bus、ASAN 排查 服务故障、接口异常、内存泄漏
qemu-testing QEMU 仿真测试 —— 启动验证、冒烟测试、skynet coredump QEMU 环境调试、冒烟验证
skill-analytics 使用数据采集 —— 当前会话 Skill 使用分析、脱敏报告生成、可选上报 Skill 使用反馈、数据飞轮
software-center-config software-center-config 仓库维护 —— manifest 版本同步、新增应用、PR 流程 同步应用版本、扩展软件中心配置

每个 Skill 包含:

  • SKILL.md —— 技能知识文档,AI 工具直接使用
  • skill.json —— 元数据(名称、版本、依赖、关键词等)

项目结构

skills-marketplace/
├── skills/                     # Skills 技能库(源头)
│   ├── code-inspection         # 通用代码规范排查
│   ├── lua-component/          # Lua 微组件开发
│   ├── mdb-interface-dev/      # MDB 接口开发
│   ├── interface-mapping/      # 接口映射配置
│   ├── testing/                # DT 测试
│   ├── debugging/              # 系统调试
│   ├── qemu-testing/           # QEMU 仿真测试
│   ├── skill-analytics/        # 使用数据采集
│   ├── software-center-config/ # 软件中心配置仓库维护
│   └── README.md
├── packages/
│   ├── skills-installer/       # TUI 安装器(npm 发布包)
│   ├── vscode-skills-marketplace/  # VSCode 扩展(可视化安装)
│   └── telemetry-server/       # 遥测数据接收服务
├── mcp-server/                 # MCP 服务器(开发中)
├── scripts/
│   ├── sync-skills-to-installer.mjs  # 同步 skills 到安装器
│   └── build-and-publish.sh          # 构建与发布脚本
├── .gitignore
├── package.json
└── README.md

目录说明

  • skills/ —— 所有 Skill 的源文件。这是唯一的编辑入口,修改后通过同步脚本分发到安装器。
  • packages/skills-installer/ —— TUI 安装器,发布到 npm 的包。其中 skills/ 子目录由同步脚本生成,不要直接编辑。
  • packages/vscode-skills-marketplace/ —— VSCode 扩展,提供可视化界面浏览和安装 Skills。
  • packages/telemetry-server/ —— Skill 使用数据接收服务(Node.js + SQLite),提供上报 API 和公开 Dashboard。
  • mcp-server/ —— OpenUBMC MCP 服务器,提供 Bingo CLI、组件管理、Conan 等工具集成(开发中)。
  • scripts/ —— 工具脚本。sync-skills-to-installer.mjs 将 skills/ 同步到 packages/skills-installer/skills/;build-and-publish.sh 负责构建与发布。

构建与发布

VSCode 扩展

cd packages/vscode-skills-marketplace
npm install
npm run compile    # 编译 TypeScript
npm run package    # 打包为 .vsix

打包后生成 .vsix 文件。

TUI 安装器与 MCP 服务器

项目提供了一键构建发布脚本 scripts/build-and-publish.sh,支持 TUI 安装器和 MCP 服务器的版本管理、本地安装与 npm 发布。

快捷命令

npm run publish:tui     # 仅构建发布 TUI 安装器
npm run publish:mcp     # 仅构建发布 MCP 服务器
npm run publish:all     # 构建发布所有包
npm run publish:dry     # 模拟发布(不实际上传)

脚本用法

bash scripts/build-and-publish.sh [选项]

目标选择

选项 说明
--tui 仅构建并发布 TUI 安装器 (@openubmc/skills-installer)
--mcp 仅构建并发布 MCP 服务器 (@openubmc/mcp-server)
--all 构建并发布所有包(未指定 --tui/--mcp 时的默认行为)

发布模式

选项 说明
--local 本地安装模式:仅构建 + npm link,不升级版本号、不发布到 npm。适合本地开发调试
--dry-run 模拟发布,执行全部流程但不实际上传到 npm

构建控制

选项 说明
--skip-build 跳过构建步骤,仅执行版本升级和发布
--skip-test 跳过测试步骤(仅影响 MCP 服务器构建)
--bump <type> 版本升级类型:patch(默认) / minor / major

npm 发布选项

选项 说明
--tag <tag> npm 发布 tag,如 latest、beta、next
--otp <code> npm 双因素认证一次性验证码(开启 2FA 时必填)

其他

选项 说明
--help 显示帮助信息

示例

# 本地构建并 link TUI 安装器(不发布,用于本地开发调试)
bash scripts/build-and-publish.sh --tui --local

# 本地构建并 link 所有包
bash scripts/build-and-publish.sh --all --local

# 使用 OTP 验证码发布 TUI 安装器
bash scripts/build-and-publish.sh --tui --otp 123456

# 升级 minor 版本并发布 MCP 服务器
bash scripts/build-and-publish.sh --mcp --bump minor

# 模拟发布所有包,预览效果
bash scripts/build-and-publish.sh --all --dry-run

# 发布 TUI 安装器的 beta 版本
bash scripts/build-and-publish.sh --tui --tag beta

发布流程

标准发布模式(默认)

脚本按以下步骤自动执行:

  1. 前置检查 —— 验证 Node.js 版本 (≥18)、npm 登录状态、Git 工作区状态
  2. 版本升级 —— 根据 --bump 参数自动修改 package.json 中的版本号
  3. 构建 —— TUI: 同步 Skills + 安装依赖;MCP: 编译 TypeScript + 运行测试
  4. 发布 —— 执行 npm publish --access public
  5. 摘要 —— 输出发布结果与安装命令

本地安装模式(--local)

  1. 前置检查 —— 验证 Node.js 版本,跳过 npm 登录检查
  2. 构建 —— 与标准模式相同
  3. Link —— 执行 npm link 将包注册到全局,可直接通过命令名调用(如 skills-installer)
  4. 摘要 —— 输出本地安装结果

本地安装后可通过 npm unlink <pkg> 移除全局 link。

Skill 数据飞轮

项目内置了数据采集机制,用于持续评估和改进 Skills 质量。

工作原理

  1. 用户安装 Skills 时可选择启用使用反馈(opt-in)
  2. 使用完 Skill 后,在当前会话中输入 /skill-report
  3. Shell 脚本自动分析当前会话日志,生成脱敏报告(零 token 消耗)
  4. 用户确认后上报到 Telemetry Server

Telemetry Server

cd packages/telemetry-server
npm install
npm start

或使用 Docker:

cd packages/telemetry-server
docker build -t openubmc-telemetry .
docker run -d -p 3000:3000 -v telemetry-data:/app/data openubmc-telemetry

访问 http://localhost:3000 查看公开 Dashboard。

隐私保护

  • 所有数据采集完全 opt-in,用户主动触发
  • 仅分析当前会话,不扫描历史记录
  • 报告中不含任何用户输入内容、代码片段或文件路径
  • 仅采集结构化统计:Skill 名称、触发次数、工具调用计数、成功/失败状态
  • 上报前必须经用户确认

贡献新 Skill

  1. 在 skills/ 下创建新目录(如 skills/my-skill/)
  2. 添加 SKILL.md(技能知识文档)和 skill.json(元数据配置)
  3. 运行 npm run sync:skills 同步到安装器
  4. 提交 Pull Request

可参考现有 Skill 的格式,详见 skills/README.md。

许可证

木兰宽松许可证 第2版 (Mulan PSL v2)

详见 LICENSE 文件。

相关链接

pre-commit 使用说明

本项目已配置 pre-commit 钩子,用于在提交代码时自动进行代码规范检查和格式化。

安装与初始化

pip install pre-commit
pre-commit install --hook-type commit-msg
pre-commit install

手动运行检查

pre-commit run --all-files
pre-commit run --hook-stage commit-msg --commit-msg-filename .git/COMMIT_EDITMSG

配置详情

本项目使用 openUBMC pre-commit-hooks 提供的钩子,包括:

  • conventional-commit: 检查提交消息是否符合 Conventional Commits 规范
  • add-signoff-and-change-id: 自动添加 Sign-off-by 和 Change-Id
  • python-format: Python 代码格式化
  • flake8: Python 代码风格检查
  • clang-format: C/C++ 代码格式化
  • trailing-whitespace / end-of-file-fixer: 通用代码卫生

更多使用说明参考:pre-commit-hooks 初始化指南

Introduction

Skills Marketplace for openUBMC

Customize your domain