Matt Pocock 技能包 sceatcher3/dsh-mattpocock-skills

dsh-mattpocock-skills-bundle

Matt Pocock 的智能体技能，打包给 DeepSeek Harness 使用。

这个包收录了上游 mattpocock/skills 在自己插件清单里推广的 27 个技能（skills/engineering 和 skills/productivity），每个技能正文和配套资源文件都原样保留，并注册到 Harness 技能注册表，服务商名为 mattpocock-skills。/ 菜单和模型技能目录里的技能描述是中文；每个技能正文保持上游英文。

注册内容

- 一个技能服务商：mattpocock-skills，来源标签 mattpocock-skills，内置优先级（rank 600）。
- 27 个技能，各自沿用上游名称，各自以所在文件夹作为资源根目录。
- 每个技能既可被模型调用（skill 工具和会话技能目录），也可被用户调用（Web 输入框里的 /skill-name）。

服务商处于内置优先级，所以同名的项目技能（.dsh/skills/<name>）或用户技能（~/.dsh/skills/<name>）优先。想覆盖某个技能又不想 fork 这个包，这是受支持的做法。

技能

上游用 disable-model-invocation: true 标记用户调用的技能。本次移植让每个技能都可被模型调用，所以这个标记只记录上游的策略。

Engineering

| 技能 | 上游 |
| ask-matt | user |
| diagnosing-bugs | model |
| grill-with-docs | user |
| triage | user |
| improve-codebase-architecture | user |
| setup-matt-pocock-skills | user |
| tdd | model |
| to-spec | user |
| to-tickets | user |
| wayfinder | user |
| implement | user |
| implement-spec | user |
| prototype | model |
| research | model |
| domain-modeling | model |
| codebase-design | model |
| code-review | model |
| pr | model |
| retro | user |
| wizard | model |

Productivity

| 技能 | 上游 |
| grill-me | user |
| grilling | model |
| handoff | user |
| teach | user |
| to-questionnaire | user |
| wait-what | user |
| writing-for-agents | model |

完整描述在各 skills/<bucket>/<name>/SKILL.md 的 frontmatter 和 skills/index.json 里；/ 菜单和技能目录显示的中文文本存在 i18n/zh.json，并以 descriptionZh 写进清单。

安装

仓库是公开的，所以这个包可以直接从 URL 安装。不需要 npm 账号，也不需要 release 资源。

在 Web UI 里打开 Settings，进入 Plugins，点 Add plugin，粘贴仓库 URL：

https://github.com/sceatcher3/dsh-mattpocock-skills

在终端里，同一个 URL 直接交给插件命令：

dsh plugin --profile web add https://github.com/sceatcher3/dsh-mattpocock-skills
插件管理器会从仓库读取 dsh.bundle.patch，把包安装到配置档，并把这一行列为 dsh-mattpocock-skills；如果安装后它处于关闭状态，请手动启用。

技能目录会在智能体的下一步重建，所以能正常激活的包无需重启，就会在会话的可用技能列表和 / 菜单里显示它的技能。

如果安装返回 restart-required 和 module-comparison，说明运行中的进程无法把已加载的插件模块与对应文件做比对。包仍会写入配置档；重启 DSH 一次，新模块就会加载。把包安装到已在运行的配置档时，这是预期路径。

有两个细节能让服务商在重启后依然可见：

- list() 故意写成异步。注册表会给每次 provider.list() 调用套一个能感知中止的辅助函数：只要调用方传入 AbortSignal（skill 工具总是会传），它就对结果调用 .then()。同步返回的数组会被静默丢弃，并报 skill provider "mattpocock-skills" skipped。
- 注册本身已经让目录缓存失效，所以 apply() 只调用 ctx.skills.registerProvider()。

针对真实 @deepseek-ai/dsh-skill 注册表的离线验证已通过：列出 27 个技能，tdd 能加载完整的 3440 字符正文，带 AbortSignal 和不带都通过。

卸载方式：

dsh plugin --profile web remove dsh-mattpocock-skills-bundle

调用技能

- 模型：skill({ name: "tdd" })。
- 用户：在输入框里输入 /tdd（或任意技能名）。
- 两条路径返回同样的指令，外面包一层资源基目录。技能内部的相对引用（tests.md、scripts/hitl-loop.template.sh）都相对该目录解析。

目录结构

dsh-mattpocock-skills-bundle/
index.js provider registration
cordis.patch.yml bundle patch (one insert row)
package.json dsh.bundle.patch, exports, icon
icon.svg package artwork
locale/en.json, zh.json display title and description
i18n/zh.json Chinese skill descriptions for the / menu
skills/index.json generated skill manifest (27 entries)
skills/engineering/... upstream skill folders, verbatim
skills/productivity/... upstream skill folders, verbatim
tools/ manifest generator and upstream re-sync script

调用策略

上游把 27 个技能中的 16 个设为仅限用户调用，也就是模型不能选它们。本次移植有意放宽了策略：模型可以选其中任意一个，用户也仍能按名字调用每一个。skills/index.json 里每条记录都用 upstreamModelInvocable 保存了原始标记。

要恢复上游行为，把 skills/index.json 中这些条目的 invocation.modelInvocable 设为 false，然后重启 harness。注意 tools/build-manifest.mjs 总是写入宽松策略，所以重新运行它会覆盖手动修改。

上游内容：保留与舍弃

保留：

- 每个 SKILL.md 都按发布原样保留，包括 pr 技能里嵌套的 metadata.credits 和 CREDITS.md。
- 技能正文引用的全部配套资源：格式、模板、脚本和模式文档。

舍弃：

- in-progress（7 个技能）和 misc（4 个技能）两个分类。上游自己的插件清单里没有推广它们；上游 README 称 in-progress 是 beta 材料。
- 每个技能的 agents/openai.yaml。该文件承载 Codex 和 Claude Code 的展示与调用元数据；Harness 注册表从本包的清单里拿到同样的信息。
- 上游的 docs/、市场清单，以及其他智能体的安装说明。

技能里提到 Claude Code 约定（CLAUDE.md、.claude/、子代理）的地方，文本按发布原样保留。有几个技能已经在读写 AGENTS.md，setup-matt-pocock-skills 也明确接受这两种文件。

从上游更新

git clone https://github.com/mattpocock/skills /tmp/mattpocock-skills
UPSTREAM_COMMIT=$(git -C /tmp/mattpocock-skills rev-parse HEAD) \
node tools/sync-from-checkout.mjs /tmp/mattpocock-skills

脚本从上游 .claude-plugin/plugin.json 读取已推广的技能列表，复制这些技能文件夹（不含 agents/），再重新生成 skills/index.json。写清单之前，脚本会先读 i18n/zh.json，所以新推广的技能必须在那里有中文描述；否则脚本报错，并指出缺的是哪个技能。只想用现有文件夹重新生成清单，运行 node tools/build-manifest.mjs 或 npm run manifest。

检查 diff，确认 skills/index.json 列出了预期的技能，然后重新安装或重启 bundle。

许可证与署名

MIT。技能说明的版权归 Copyright (c) 2026 Matt Pocock 所有，依据 MIT License 从 mattpocock/skills 再分发。打包代码和图标是原创贡献，采用同一许可证。见 LICENSE 和 NOTICE.md。