dsh-skill-adapter：将 Claude Code 技能导入 DeepSeek Harness

DeepSeek Harness 原生支持 <name>/SKILL.md，且 frontmatter 键名与 Anthropic 规范对齐。DSH 缺少的是导入、归一化与分发工具链。dsh-skill-adapter 提供这套工具，把 agent-skills 等现有库搬到 DSH。

本插件由 zp-home 维护，MIT 许可证。核心包含：零依赖解析库、CLI 导入器、DSH SkillProvider 插件。

核心功能¶

该插件提供三部分能力：

1. 解析与归一化：@dsh-skill-adapter/core。解析 SKILL.md（零依赖手写 YAML 子集），归一化 frontmatter。归一化规则包括：name 和 description 为必需，非法 name 转为 kebab-case，when-to-use/when_to_use 统一为 whenToUse。
2. CLI 导入工具：dsh-skill-import。支持批量抓取、校验、归一化、写入磁盘，并生成兼容性报告。
3. 运行时挂载：DSH 插件 SkillProvider。在运行时动态挂载 GitHub 或本地目录的技能，无需手动复制文件。

安装与启用¶

安装插件使用官方命令：

dsh plugin --profile web add github:<你的用户名>/dsh-skill-adapter

安装后，编辑已安装包的 cordis.patch.yml，配置技能源。支持 GitHub 仓库和本地目录两种类型：

- insert:
    - id: dsh-skill-adapter
      name: dsh-skill-adapter
      config:
        cacheTtlMs: 300000   # 列表缓存毫秒数（默认 5 分钟）
        sources:
          - type: github
            owner: addyosmani
            repo: agent-skills
          - type: local
            root: /path/to/my/skills

重启 dsh web 后，DSH 的 skill 工具即可发现这些技能。

CLI 导入器用法¶

若需一次性批量导入并写入磁盘，使用 CLI 工具。命令位于 packages/cli/src/cli.js。

从 GitHub 技能库导入：

node packages/cli/src/cli.js \
  --source github:addyosmani/agent-skills \
  --verbose

多源导入并预览：

node packages/cli/src/cli.js \
  --source github:ckorhonen/claude-skills \
  --source local:./my-skills \
  --out ~/.dsh/skills \
  --dry-run --verbose

输出 JSON 兼容性报告：

node packages/cli/src/cli.js --source local:./examples/skills --json

环境与依赖¶

• 需要 Node.js 版本 >= 18.17。
• 依赖 @deepseek-ai/cordis（可选依赖）。
• 若需被 dsh-recommend registry 收录，必须在 GitHub 仓库打上话题 dsh-plugin。

该插件填补了 DSH 生态中从 Claude Code/Codex 迁移技能的空白，提供了从解析到分发的一站式方案。