MCP 技能桥接 SpamX-dev/dsh-skills-over-mcp-plugin

@deepseek-ai/dsh-skill-mcp

DeepSeek Harness 的技能服务商，把 MCP 资源 skill:// 变成 dsh 技能——不用把技能打包成插件。

设计思路（DRY）：技能只存一处，放在 MCP 服务器上；这个适配器充当可复用的桥，把「MCP skill:// 资源」接到「dsh 技能」。任何 MCP 服务器，只要实现 skill:// 契约，就能把自己的技能「广播」到 dsh，无需手动打包。

工作原理

适配器是一个 Cordis 插件，带技能服务商：

- 不自己维护 MCP 连接。 它从 mcpResources 服务读取资源，也就是从已经打开的 @deepseek-ai/dsh-mcp-client 连接读取。服务器只在 dsh-mcp-client 里配置一次，不会再起第二个 MCP 进程。
- list() 列出 scope 内可见的服务器（或取 config.servers），请求 resources/list，筛出 skill://<name> 形式的 URI，逐个读取资源，再用其中的 SKILL.md 构造候选。
- get() 重新读取资源，返回完整技能定义。
- 服务器或单个资源出错不会拖垮整个目录：适配器把这次观测标记为不完整（complete: false），避免注册表缓存部分结果，同时记录诊断日志。

同一份 SKILL.md（YAML frontmatter 的 name/description/whenToUse/disable-model-invocation/user-invocable/metadata 加 markdown 正文），既能当文件技能用（dsh-skill-filesystem），也能当 MCP 资源用。

安装

把包加为配置档依赖（通过 Plugin Manager，或写进配置档的 package.json），再在 cordis.yml 里加一行插件。

包可以直接从这个仓库取，不用发布到 npm：

npm install github:SpamX-dev/dsh-skills-over-mcp-plugin

配置

两步：(1) 给服务器配常规的 dsh-mcp-client；(2) 加一行适配器。

1) MCP-сервер: инструменты и ресурсы (стандартный dsh-mcp-client).
- id: mcp-ast-index
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: ast-index
transport: stdio
command: ast-index-mcp # команда запуска вашего MCP-сервера
args: ['serve']

2) Адаптер скиллов: один раз на весь профиль.
- id: skill-mcp
name: '@deepseek-ai/dsh-skill-mcp'
config:
servers: ['ast-index'] # необязательно; пустой массив = все видимые серверы

启动后，技能 ast-index 会出现在 available_skills 目录里，skill 工具会像加载任何文件技能一样加载它的说明（SKILL.md 正文）。

配置字段

| 字段 | 默认值 | 用途 |
| providerName | mcp | 候选/定义里 provider 的取值（在 skill 的结果里可见） |
| servers | [] | 允许「技能化」的服务器名称白名单；留空则自动发现所有可见服务器 |
| rank | 650 | 候选排序值（越小优先级越高；650 高于内置的 600，即让位于本地技能） |

用参考服务器验证

仓库里带了一份测试夹具 fixtures/skill-mcp-fixture——一个小型 MCP 服务器，以 skill:// 资源的形式提供两个技能。

cd fixtures/skill-mcp-fixture && npm install

然后在 cordis.yml 中：

- id: mcp-fixture
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: fixture
transport: stdio
command: node
args: ['fixtures/skill-mcp-fixture/src/server.mjs']

- id: skill-mcp
name: '@deepseek-ai/dsh-skill-mcp'
config:
servers: ['fixture']

启动后，技能目录里会出现 ast-index 和 code-review。

不依赖外部依赖的逻辑

纯辅助函数抽到了 lib/skill-frontmatter.js，并有 smoke 测试覆盖，运行时不需要 Cordis/MCP 客户端：

node test/smoke.test.mjs

限制

- 适配器只读取 URI 严格为 skill://<name> 的资源；其他资源模型可以通过标准工具 list_mcp_resources / read_mcp_resource 访问。
- 服务器自动发现依赖 mcpResources 的 scoped 层（服务系统提示词用的也是同一层）。如果需要严格限定范围，请显式设置 servers。
- MCP 技能不参与文件系统的热重载；改动会在下一次刷新技能目录时生效（由注册表失效触发）。