dsh-engineering-skills:一键挂载 Matt Pocock 的 27 个工程技能

前言

在 DeepSeek Harness(DSH)里做规格、TDD、代码评审或交接,常见做法是把技能目录放到 ~/.agents/skills 或项目下的 .agents/skills,由文件系统 provider 扫描进会话。上游 Matt Pocock’s skills 本身也支持这种安装方式,格式与 DSH 一致。若你希望用一条命令安装、卸载,并把版本钉在上游 commit、避免写入共享的 ~/.agents/skills,可以用插件包把同一套 27 个技能集中分发。

下面介绍社区插件 dsh-engineering-skills(维护者 tianji-qingtian),分类为工作流,在 SkillHub 目录页 可查看元信息。

这是什么

dsh-engineering-skills 把 Matt Pocock 的 27 个工程与生产力 agent 技能(grilling、spec/ticket 流程、TDD、code review、领域建模、handoff 等)打成 DeepSeek Harness 插件 bundle:执行一次 dsh plugin add 后,27 个技能会出现在会话技能目录和 / 菜单里;移除插件即可干净卸载。

技能 invocation 划分(与上游 frontmatter 一致):

  • 11 个 默认可由模型调用:同时进入模型 catalog、skill 工具与 /name。
  • 16 个 仅用户调用(disable-model-invocation: true):只出现在 / 菜单,模型不会自动选用。

Harness 仍处于 developer preview,迭代较快,需预期兼容性变更;README 亦提示与特定 harness 版本对齐使用。

为什么用插件而不是只拷 SKILL.md

资料说明:不装本插件也可以使用这些技能——DSH 默认会扫描 ~/.agents/skills(rank 500)与 <project>/.agents/skills(rank 200),上游安装器会把同样的 SKILL.md 树放到那里。

插件额外提供:

  1. 由 profile 管理的一键安装/卸载与可版本化更新(UPSTREAM.json、sync --check)。
  2. 不写入共享的 ~/.agents/skills。
  3. 可按 categories / skills 过滤目录,控制 catalog 体积。
  4. 加载时可选追加一段 DSH 工具映射说明(appendHarnessGuide)。

安装与启用

前置条件

dsh CLI 需在 PATH 中(例如 npm install -g @deepseek-ai/dsh,或对命令使用 npx @deepseek-ai/dsh)。该版本在 harness 0.2.1-rc.2 上做过验证。

插件以当前 dsh 进程权限运行;安装前请自行查看 GitHub 仓库 源码与许可证(插件代码 MIT;skills/ 内容来自上游 MIT,见 LICENSE-upstream 与 NOTICE)。

添加 bundle

# 1. 将 bundle 加入 web profile(仓库已提交构建产物 lib/,安装时不跑 build)
#    建议使用 release tag;#main 跟踪最新 commit
dsh plugin --profile web add "github:tianji-qingtian/dsh-engineering-skills#v0.1.2"

# 2. 用该 profile 重启 harness——add 只改 profile 文件,运行中的实例不会热加载
dsh --profile web

重启后,/ 菜单会列出全部 27 个技能;模型 catalog 携带 11 个可模型调用的技能;Settings → Plugins 中可见 dsh-engineering-skills。

本地开发检出时,可使用本地路径:

dsh plugin --profile web add <local-checkout>/dsh-engineering-skills

配置

在 profile 的插件配置中可缩小暴露的技能集合(未知 category 或 skill 名会导致 mount 失败,而不是静默缩小目录):

- id: engineering-skills
  config:
    categories: [productivity]          # engineering | productivity(默认两者)
    skills: [grilling, grill-me, tdd]   # 显式子集;非空时覆盖 categories
    appendHarnessGuide: true            # 加载时追加 DSH 工具映射说明
    providerName: engineering-skills    # registry provider 名称

非空的 skills 列表会完全覆盖 categories。若担心每次请求常驻 11 条模型可调用技能的描述成本,可用 categories 或 skills 裁剪。

典型用法

通过 / 菜单区分手动与模型技能

README 截图说明:grill-me、grill-with-docs 带仅用户标记,模型不能自动调用;grilling 为模型可调用,也会出现在模型 catalog 中。日常可从 / 选用户向技能,或依赖模型在合适时机选用 catalog 中的工程类技能。

与上游行为的对应关系

上游 DSH
SKILL.md + YAML frontmatter 同格式,由 skill registry 解析
disable-model-invocation: true(16 个) modelInvocable: false,仅 / 菜单
默认(11 个) catalog + skill 工具 + /name
/name 主机注入相同 <skill_content> 块
引用的子文件(25 个) resourceBase: { kind: 'directory' }

技能正文多为英文;若希望中文输出,可在项目 AGENTS.md 中增加语言说明(README Known limits 中的建议)。

适用场景与已知限制

适合:已在用 DSH 做开发工作流,希望快速获得 grilling、规格票据、TDD、评审、领域建模、handoff 等成套技能,并希望通过 profile 管理版本与目录大小。

需注意(摘自 README Known limits,非完整列表):

  • ask-matt 需改写:DSH 不把其他仅用户技能的正文暴露给模型,应改为面向人的导航(提示用户自行 /x)。
  • implement-spec worktrees:无官方 worktree 工具,技能需自行驱动 git worktree 或串行执行。
  • triage / wayfinder / to-* 依赖 issue tracker;无 gh/glab 时可用 setup 技能的 Local-markdown 模式(.scratch/)。
  • improve-codebase-architecture 报告依赖 CDN Tailwind/Mermaid,离线环境宜自备 HTML。
  • Harness 升级:@deepseek-ai/dsh-skill peer 范围不匹配时,profile 启动会跳过该 bundle(控制台可能出现 skipping profile bundle …),需随 harness 预发布版本 bump peer 并重新测试。

上游同步由维护者通过 node scripts/sync-upstream.mjs 与 UPSTREAM.json 钉版本;仅 upstream .claude-plugin/plugin.json 列出的技能会随包发布。

结尾

dsh-engineering-skills 把 Matt Pocock 的 27 个工程技能以 DSH 插件 bundle 形式分发:一条 dsh plugin add、重启 profile 即可进目录与 / 菜单,并可用 YAML 过滤子集。社区目录与 DeepSeek / 幻方无官方从属关系,SkillHub 是独立插件索引站点。

  • 目录页:https://www.skillhub.cn/plugins/tianji-qingtian/dsh-engineering-skills
  • 源码与完整说明:https://github.com/tianji-qingtian/dsh-engineering-skills(含 README.zh.md)
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye