Skills Marketplace for openUBMC
Access rate limit exceeded. Please log in to continue.
OpenUBMC Skills & MCP
简介
本项目为 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 中:
- 打开扩展面板 (
Ctrl+Shift+X) - 点击右上角 "..." 菜单 → "Install from VSIX..."
- 选择
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
发布流程
标准发布模式(默认)
脚本按以下步骤自动执行:
- 前置检查 —— 验证 Node.js 版本 (≥18)、npm 登录状态、Git 工作区状态
- 版本升级 —— 根据
--bump参数自动修改package.json中的版本号 - 构建 —— TUI: 同步 Skills + 安装依赖;MCP: 编译 TypeScript + 运行测试
- 发布 —— 执行
npm publish --access public - 摘要 —— 输出发布结果与安装命令
本地安装模式(--local)
- 前置检查 —— 验证 Node.js 版本,跳过 npm 登录检查
- 构建 —— 与标准模式相同
- Link —— 执行
npm link将包注册到全局,可直接通过命令名调用(如skills-installer) - 摘要 —— 输出本地安装结果
本地安装后可通过
npm unlink <pkg>移除全局 link。
Skill 数据飞轮
项目内置了数据采集机制,用于持续评估和改进 Skills 质量。
工作原理
- 用户安装 Skills 时可选择启用使用反馈(opt-in)
- 使用完 Skill 后,在当前会话中输入
/skill-report - Shell 脚本自动分析当前会话日志,生成脱敏报告(零 token 消耗)
- 用户确认后上报到 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
- 在
skills/下创建新目录(如skills/my-skill/) - 添加
SKILL.md(技能知识文档)和skill.json(元数据配置) - 运行
npm run sync:skills同步到安装器 - 提交 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 初始化指南