Skills Marketplace for openUBMC
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 20 天前 | ||
| 30 天前 | ||
| 20 天前 | ||
| 20 天前 | ||
| 20 天前 | ||
| 20 天前 | ||
| 20 天前 | ||
| 20 天前 | ||
| 6 天前 | ||
| 15 天前 | ||
| 20 天前 | ||
| 26 天前 | ||
| 29 天前 | ||
| 3 个月前 | ||
| 26 天前 | ||
| 20 天前 | ||
| 26 天前 | ||
| 20 天前 |
OpenUBMC 技能市场
OpenUBMC 技能市场提供可复用的 AI 技能、TUI 安装器、VS Code 技能市场扩展，以及供编码代理使用的 Studio MCP Host。
仓库内容
| 模块 | 路径 | 用途 |
|---|---|---|
| 技能源码 | skills/ |
所有可安装 OpenUBMC 技能的唯一源码目录 |
| TUI 安装器 | packages/skills-installer/ |
将技能安装到编码工具的 npm 包 |
| VS Code 技能市场 | packages/vscode-skills-marketplace/ |
用于浏览、同步和安装技能的 UI 扩展 |
| Studio MCP Host | extensions/openubmc-mcp-host/ |
由 openUBMC Studio 启动的本地 HTTP MCP Host |
| 遥测服务 | packages/telemetry-server/ |
可选的匿名技能反馈接收服务 |
| 文档 | docs/ |
架构、MCP、数据飞轮等设计文档 |
| 脚本 | scripts/ |
同步、打包和发布辅助脚本 |
独立的 mcp-server/ 包已经废弃。MCP 运行时代码现在位于 extensions/openubmc-mcp-host/。
给编码代理的入口
开始修改前先阅读：
AGENTS.md- 最近子目录下的
AGENTS.md docs/agent-workflows.md，查看流程和验证命令docs/README.md
关键边界：
- 技能内容只修改
skills/。 - 不要直接修改包目录下生成的技能镜像。
- MCP 运行时变更放在
extensions/openubmc-mcp-host/。 - 技能市场 UI 和安装行为放在
packages/vscode-skills-marketplace/。 - TUI 安装器行为放在
packages/skills-installer/。
快速开始
先安装所需工作区的依赖，再使用根目录脚本：
npm install
npm run sync:skills
npm run build:extensions
npm run test:extensions
npm run package:extensions
本地安装打包后的 VSIX：
bash install-vscode-extension.sh
运行 TUI 安装器：
npx @openubmc/skills-installer
常用命令
| 命令 | 用途 |
|---|---|
npm run sync:skills |
将根目录 skills/ 同步到包资源目录 |
npm run capability:validate |
独立校验 capability manifest、skill、agent、hook 引用 |
npm run capability:smoke |
不依赖 Workbench 的 capability Ready/Blocked 和 RunSpec 冒烟验证 |
npm run build:extensions |
编译技能市场扩展和 MCP Host |
npm run test:extensions |
运行扩展测试套件 |
npm run package:extensions |
打包两个 VSIX |
npm run build:vscode-skills-marketplace |
只编译技能市场扩展 |
npm run build:mcp-host |
只编译 MCP Host |
npm run test:mcp-host |
只测试 MCP Host |
npm run publish:dry |
预演 TUI 发布流程 |
capability:smoke 中的 ready 表示 required skills 已安装并可从目标目录 read-back，RunSpec 也已生成；它不表示当前已经运行中的 coding agent 会热加载这些 skill。执行 RunSpec 前应启动新的 OpenCode、Claude Code、Chrys 或 Codex session，或者由后续 adapter 负责新开受控 session。
安装路径
技能可安装到以下目标工具：
| 工具 | 常见技能安装路径 |
|---|---|
| OpenCode | ~/.config/opencode/skills/ |
| Codex | ~/.agents/skills/ |
| Claude Code | ~/.claude/skills/ |
| Chrys | ~/.chrys/skills/ |
| Cursor | ~/.cursor/skills/ |
openUBMC Studio 启动时，Studio MCP Host 会自动为 Claude Code、OpenCode、Codex 和 Chrys 写入本地 MCP 配置。
技能
每个技能目录通常包含：
SKILL.md：供编码代理直接读取的指令文档。skill.json：技能市场和安装器使用的元数据。- 可选的
references/、templates/、scripts/、evals/。
技能编写指南和当前技能列表见 skills/README.md。
MCP Host
extensions/openubmc-mcp-host/ 是一个 VS Code 扩展，负责：
- 默认在
127.0.0.1:9876启动 Streamable HTTP MCP 服务。 - 复用已有的
openubmc-mcp-host实例，避免打开第二个端口。 - 发现导出
registerMcpTools的 VS Code 扩展。 - 使用当前 MCP URL 自动配置支持的编码代理。
- 将诊断日志写入 VS Code Output 面板中的
openUBMC MCP Host通道。
常用命令：
npm --workspace extensions/openubmc-mcp-host run typecheck
npm --workspace extensions/openubmc-mcp-host test
npm --workspace extensions/openubmc-mcp-host run compile
npm --workspace extensions/openubmc-mcp-host run package
开发目录
skills-marketplace/
├── AGENTS.md
├── README.md
├── QUICKSTART.md
├── docs/
├── extensions/
│ └── openubmc-mcp-host/
├── packages/
│ ├── skills-installer/
│ ├── telemetry-server/
│ └── vscode-skills-marketplace/
├── scripts/
└── skills/
大多数顶层目录都有 AGENTS.md。这些文件描述当前状态和约束；流程细节放在 docs/agent-workflows.md。
发布说明
根目录发布脚本目前覆盖 TUI 安装器流程：
npm run publish:tui
npm run publish:dry
VS Code 扩展使用以下命令打包：
npm run package:extensions
生成的 .vsix、dist/、node_modules/ 和生成的技能镜像不应提交。
更多文档
当前文档索引见 docs/README.md。