Matt Pocock Skills for DSH

这是 Matt Pocock 的技能集 的 DSH 移植版：grilling、spec/ticket 流程、TDD、code review。做成一个可安装的 bundle + 一个独立 Agent 预设，可以和 Superpowers 并存。

English: README.en.md

安装

1. 装 bundle（把 25 个技能注册到全局技能层）

npx @deepseek-ai/dsh plugin --profile web add github:Meteor-system/mattpocock-skills-for-dsh

也可以从本地 clone 装：

git clone https://github.com/Meteor-system/mattpocock-skills-for-dsh.git
npx @deepseek-ai/dsh plugin --profile web add C:\path\to\mattpocock-skills-for-dsh

2. 装预设模板

在本仓库目录里跑：

node scripts/install-preset.mjs

预设会装到 %USERPROFILE%\.dsh\.agent-presets\mattpocock-skills。已有同名预设时加 --force，脚本会先备份一份带时间戳的旧版。

3. 重启，新开会话

bundle 在 profile 启动时挂载。重启 DSH，刷新页面，新开一个会话，预设选 Matt Pocock Skills。旧会话保留原来那代预设，不能拿来验收。

进新仓库之后先跑一次 /setup-matt-pocock-skills，它会配置这个仓库的 issue tracker、triage 标签和 CONTEXT.md 布局。后面一堆工程技能都要读 docs/agents/*.md，缺了它模型会停下来让你手动跑，不会自作主张。

怎么用

25 个技能就分两类，区别只在于谁能启动：

类型	启动方式	模型目录里看得见吗
User-invoked	你自己在输入框打 /技能名	看不见，打斜杠时 DSH 会把完整指令注入
Model-invoked	你打 /名，或者模型觉得合适时用 skill 工具加载	看得见

一条硬规则：user-invoked 可以调 model-invoked；反过来不行，model-invoked 之间也不能替你把 user-invoked 拉起来。所以缺 setup 的时候，模型只会提醒你手动跑。

另外说清楚：这里没有 Superpowers 那种「每句话之前先 load 一个 skill」的规定。

主流程：想法 → 上线

在正经的代码仓库里，按这个顺序走：

1. 先 /grill-with-docs，把需求一层层问透。问的过程中它顺手把术语沉淀进 CONTEXT.md，把关键决定写成 ADR。
2. 有那种纸上谈不拢的设计问题（状态机、交互），/handoff 把上下文打包，开个新会话跑 /prototype 验证一下，再 handoff 回来。
3. 一次会话装得下的活，直接 /implement。装不下的，先 /to-spec 整理成规格文档，再 /to-tickets 拆成一张张带依赖关系的工单，然后每张工单开个新会话 /implement。
4. /implement 内部会自动走 tdd，收尾自动跑 code-review，通过之后才提交。

不知道现在该走哪条，就 /ask-matt，它会告诉你。

不在仓库里、只想把脑子里的方案逼问清楚：用 /grill-me，同一套拷问，但不落盘。只要在仓库里，就优先 /grill-with-docs。

其他入口

你现在的处境	该用什么
tracker 里堆了一堆别人提的 bug 和需求	/triage
bug 很难复现、性能莫名变慢、回归查不出	直接描述症状，模型会去加载 diagnosing-bugs
活大到一次会话根本铺不开（新项目、巨型功能）	/wayfinder，地图理清之后再 /to-spec
想顺手让代码结构更清晰、更好测试、更好给 AI 导航	/improve-codebase-architecture
上一句话没接住，想让模型换个说法再讲一遍	/wait-what
要换目录、换工具、交接给别人	/handoff
卡点在别人脑子里，需要找人来填一份问卷	/to-questionnaire
只有人类能操作：配密钥、点第三方后台、一次性迁移	模型会加载 wizard

25 个技能一览

工程 · 人来触发

技能	做什么	什么时候用
/ask-matt	路由：看你现在的处境，指出该走哪条流程	不知道从哪下手
/setup-matt-pocock-skills	配置当前仓库的 issue tracker、triage 标签、领域文档布局	每个仓库一次，其他工程技能的前置
/grill-with-docs	刨根问底的访谈，边问边写 CONTEXT.md 和 ADR	在仓库里，需要把一件事彻底对齐
/to-spec	把已经聊完的内容整理成规格，发到 tracker，不再重新访谈	grill 或 wayfinder 之后，准备开工
/to-tickets	把计划/规格拆成带阻塞依赖的工单	规格有了，要拆成能排队、能并行的活
/implement	按规格或工单实现；内部走 TDD，收尾 code-review，然后提交	要写的活已经定义清楚
/triage	把外来 issue/PR 过一遍状态机，写成 agent 能直接接的 brief	处理别人提的活，/to-tickets 的产物不用再过
/wayfinder	把超大规模的工作在 tracker 上铺成决策地图，一张一张定	目标太远、一轮会话望不到头；产出是决策不是代码
/improve-codebase-architecture	扫一遍代码，找出哪些模块太浅、值得加深，输出 HTML 报告，再对你选的那个深入 grilling	想做架构级维护，不是加新功能

工程 · 模型可调用

这几个会出现在 DSH 的 available_skills 里，任务对得上时模型会自己加载，你也可以直接打 /名。

技能	做什么	什么时候用
tdd	红-绿循环，一次一条垂直切片	测试先行、提到 red-green-refactor、要写集成测试。/implement 内部会调
code-review	相对某个提交点做两轴审查：规范（Standards）+ 规格（Spec），并行开子代理	审分支、PR、未提交的改动。/implement 收尾会跑
diagnosing-bugs	先搭一个能稳定复现这个 bug 的反馈环，再缩小范围、假设、打点、修复、回归	疑难 bug、性能回退、偶发失败
research	让后台代理去查一手资料，整理成带引用的 Markdown	需要查文档/API 事实，同时自己接着干活
prototype	搭一次性原型回答一个设计问题：逻辑用单个 HTML 验证，UI 做可切换的变体	光靠想拿不准，得看见或者跑起来
domain-modeling	打磨领域语言：挑战模糊术语、写 ADR、维护 CONTEXT.md	在聊术语、改词汇表的时候。/grill-with-docs 内部会调
codebase-design	设计词汇表：module、interface、depth、seam、adapter	设计接口、找加深点、让代码可测试。tdd 和架构扫描都依赖它
resolving-merge-conflicts	按双方意图逐 hunk 解 merge/rebase 冲突，解完继续，绝不 --abort	已经卡在冲突里
wizard	生成交互式 bash 向导，领着人走完只有人能做的步骤	开通基础设施、填密钥、点陌生后台、一次性切换。Windows 上生成的脚本要放 Git Bash 或 WSL 里跑

效率 · 人来触发

技能	做什么	什么时候用
/grill-me	和 /grill-with-docs 同一套访谈，不写本地文档	不在仓库里，只想把方案问透
/handoff	把当前对话压成一份交接文档，给另一个 agent 接着干	换工具、换目录、交给同事、中途拆出去做旁路
/teach	在当前目录里跨多轮教会一个概念	想学新东西，并留下学习记录
/to-questionnaire	把问题做成问卷发给别人填；它审的是「发给谁、要什么」，不是题目本身	卡点不在你、不在代码，而在别人脑子里的信息
/wait-what	用 CONTEXT.md 的词汇、用大白话把上一条重新讲一遍	任何时候觉得话没接上，直接打

效率 · 模型可调用

技能	做什么	什么时候用
grilling	访谈原语：把决策树一轮一轮问干净	/grill-me、/grill-with-docs、/triage、/wayfinder、架构扫描的底层引擎。单独加载它 = 只要访谈，不要外壳
writing-for-agents	写给 agent 看的文档：skill、AGENTS.md / CLAUDE.md	在写或改这些文件

和 Superpowers 的关系

两个预设可以共存。一次会话只挂一个预设，工具和 prompt 不会互相叠加。

两边的技能都以 host 插件的形式全局注册，所以：

• Superpowers 会话的技能目录里会看到本套的 11 个 model-invoked 技能名（tdd、grilling…）；
• Matt Pocock 会话的目录里会看到 Superpowers 那 14 个名字。

各自的 bootstrap 会让模型忽略对方的名字。user-invoked 技能（那 14 个斜杠）两边都不会进模型目录，只有人打 /名 才出现。

本预设自己关掉了默认技能根（includeDefaultRoots: false），不会去扫 ~/.agents/skills 之类的个人目录。

想让目录彻底干净，只能二选一：不装其中一套的 host 插件，或者接受「名字在、不 follow」。

校验

node scripts/verify.mjs

上游

技能内容来自 mattpocock/skills，钉在 1.2.3 / 3cca18b，详见 UPSTREAM.md。技能正文 MIT，版权归 Matt Pocock；DSH 这边的接线和文档是这个仓库自己写的。