工程师技能包 YuKimCai/dsh-mattpocock-skill

dsh-mattpocock-skills

本项目封装 mattpocock/skills v1.3.1，并适配 DeepSeek Harness。
27 个技能的正文版权归 Matt Pocock，MIT 许可；本项目新增的是 Agent 预设、插件封装与平台词汇适配。
取用版本、对应 commit、具体改了什么，见 NOTICE.md。

Matt Pocock 的 mattpocock/skills（27 个工程技能）做成 DeepSeek Harness 的 Agent 预设：一个真正的智能体，不是一个技能目录。

装好之后，模式下拉里多出一个 「Matt Pocock 工程师」。选中它开会话，这个会话就带着 27 个技能、配套人格、以及技能流程依赖的完整工具面（bash / 读写文件 / 搜索 / 子智能体 / Web / 提问 / todo）。

文档

- SKILLS.md — 27 个技能按实际用途分类：需求定型 / 可执行化 / 实施 / 识别整理 / 协作 / 入口，含主流程图、接入点、触发方式和一张总表。想搞清楚「这些技能到底能干嘛」读这一份就够。
- NOTICE.md — 上游出处、取用版本与 commit、本项目具体改了什么。二次开发或分发前必读。
- README.md（本文）— 怎么装、装了什么、从 Claude Code 到 DSH 改了什么。

它做了什么

| 层 | 内容 |
| Agent 预设 | presets/mattpocock/agent.cordis.yml（20 行插件组合）+ preset.yml（显示名/描述） |
| 人格 | 一段 prefix，把 27 个技能的组织方式和主流程写进去，模型不必先读技能就知道什么时候该用哪个 |
| 技能 | 27 个 skill 全部转换好，放在 skills/，随包发布 |
| 插件 | lib/index.js：落地技能树 + 向 ctx.agentPresets 声明预设 + 暴露状态接口 |
| 状态接口 | GET/POST /mattpocock-skills/status（回环 Web 服务） |

技能清单（27 个）

模型可自主调用（11）：code-review、codebase-design、diagnosing-bugs、domain-modeling、grilling、pr、prototype、research、tdd、wizard、writing-for-agents

仅用户点名（16）：ask-matt、grill-me、grill-with-docs、handoff、implement、implement-spec、improve-codebase-architecture、retro、setup-matt-pocock-skills、teach、to-questionnaire、to-spec、to-tickets、triage、wait-what、wayfinder

对齐上游的行为：上游 disable-model-invocation: true 的技能，在 DSH 里就是「只在用户输入 /技能名 时注入」，模型侧目录里看不到。这一点是刻意保留的，不是漏配。

安装

方式 A：装进 profile（推荐，随宿主启动自动加载）

在本仓库目录里执行（file:. 会记成你 clone 下来的绝对路径，换机器要重装）：

1. 加进 profile 的依赖
dsh plugin --profile web add file:.

2. 把包名加进 profile 的 bundle 列表（~/.dsh/profiles/web/package.json）
"dsh": { "profile": { "bundles": [ ..., "dsh-mattpocock-skills" ] } }

3. 重启宿主

不想动 profile？用 overlay 试跑

仓库根有两个 overlay，路径全部相对它们自己的位置，clone 到哪都能跑：

只挂这个插件（新开一个宿主，不动现有 profile）
dsh --profile web --patch ./overlay.yml --port 3120 --no-open

顺手把默认预设也切过去
dsh --profile web --patch ./overlay.yml --patch ./default-preset.yml --port 3120 --no-open

--patch 的路径是相对你执行命令的目录；overlay 里那条 name: './lib/index.js' 才是相对 overlay 文件自己解析的。两个别搞混。

方式 B：只想要技能，不要智能体

把 skills/ 下的目录拷到 $DSH_HOME/skills/（或项目根的 .dsh/skills/）即可，DSH 原生的 skill 工具和 /技能名 直接可用。

用法

选中「Matt Pocock 工程师」后：

- 模型自主：说「这段 diff review 一下」→ 它自己加载 code-review；说「这个 bug 查不出来」→ diagnosing-bugs。
- 显式点名：输入 /tdd、/to-tickets、/wayfinder。用户点名的技能会作为指令注入，并在同一轮生效。
- 迷茫时：/ask-matt 是上游的路由技能，会告诉该按什么顺序调用其余技能。
- 首次用某仓库：先跑 /setup-matt-pocock-skills，它会把 issue tracker、triage 标签、领域文档布局写进 docs/agents/；后续 /to-spec、/to-tickets、/triage 都读这份配置。

从 Claude Code 到 DSH：改了什么

技能正文是从上游逐字保留的，只做了必要的平台适配：

| 上游 | DSH | 说明 |
| Skill tool | \skill\ 工具 | DSH 的原生技能加载工具 |
| /clear | 「开新会话」 | DSH 没有 /clear 命令；语义等价，旧会话可恢复 |
| disable-model-invocation: true | 同名 frontmatter | DSH 原生支持这个字段 |
| agents/openai.yaml | 删除 | Codex 专用显示元数据，DSH 不读 |

/compact、/handoff、subagent 等在两边的语义一致，保留原文。技能内引用的相对文件（GLOSSARY-FORMAT.md、脚本模板等）全部随技能目录一起搬过来了。

状态接口

curl -s http://127.0.0.1:3080/mattpocock-skills/status | jq

返回包版本、预设是否已声明、是否 broken、技能树落地位置、27 个技能名，以及当前 catalog 里实际能被模型看到的技能。

POST {"action":"resync"} 会强制把包内技能重新拷到 $DSH_HOME/mattpocock-skills/skills。

技能树的位置

技能会被拷到 $DSH_HOME/mattpocock-skills/skills，不是留在 node_modules 里。上游的整个主张就是「这些文件小到你敢改」，锁在 node_modules 里违背这一点。

- 每个包版本覆盖一次；同版本重启不动你的改动。
- 想长期保留改动：把那个技能拷到 $DSH_HOME/skills/（用户根，rank 更高，同名优先）。
- 想强制重置：POST {"action":"resync"} 或把 resyncSkills 设为 true。

目录结构

dsh-mattpocock-skills/
├── package.json # dsh.bundle.patch 指向 cordis.patch.yml ├── cordis.patch.yml # bundle 层：insert 本插件一行（按包名，无路径） ├── overlay.yml # 试用 overlay：不装 profile 直接挂（相对路径） ├── default-preset.yml # 把默认预设切到 mattpocock ├── lib/ │ ├── index.js # 落地技能 + 声明预设 + 状态路由 │ ├── composition.js # 读 agent.cordis.yml / preset.yml 的 YAML 子集解析器 │ └── sync.js # 技能树同步 ├── presets/mattpocock/ │ ├── agent.cordis.yml # 20 行插件组合（人格/工具/技能/压缩/子智能体…）
│ └── preset.yml # 显示名、描述、排序 ├── skills/ # 27 个技能（含各自引用的资源文件） ├── SKILLS.md # 27 个技能按实际用途分类（先读这个） └── scripts/ └── verify-skills.mjs # 27 个技能全量解析自检（任何目录可跑）

自检

27 个技能能否全部被 DSH 的技能 provider 解析（任意目录可跑）
npm run verify
期望： discovered 27 | model-invoked 11 | user-only 16 | failed 0

组合能否被预设注册表接受
node -e "import('./lib/composition.js').then(m=>console.log(m.readPresetDefinition('mattpocock','presets/mattpocock','/tmp').plugins.length))"
期望： 20

来源与许可

| 部分 | 归属 | 许可 |
| skills/ 下 27 个技能正文 | Matt Pocock v1.3.1 | MIT |
| Agent 预设、lib/、overlay、自检脚本、SKILLS.md | 本项目 | MIT |
| 运行平台 | DeepSeek Harness | MIT |

技能正文未作改写，只做了平台词汇替换（Skill tool → skill 工具、/clear → 开新会话）并删除了 Codex 专用的 agents/openai.yaml。
完整出处、上游 commit、二次开发注意事项见 NOTICE.md。