gongyijie85/mattpocock-skills-dsh

English | 简体中文

为 DeepSeek Harness (DSH) 打造的 Matt Pocock 技能插件包:把 mattpocock/skills(来自 aihero.dev/skills 的"真实工程师"技能集) 移植到 DSH 的 Cordis 插件架构上。

插件会向 ctx.skills 注册表的 host 层 注册一个技能提供者,因此每个 agent preset 的作用域链都会合并这些技能。技能正文随包分发 (skills/<name>/SKILL.md),通过 import.meta.url 定位——这是包的 组装事实,不需要任何用户配置。

非官方移植:技能内容改编自 mattpocock/skills(MIT, © Matt Pocock)。上游以 Claude Code 插件格式发布;本包做的是 DSH 适配。

快速上手:七课工作流(中英对照)

出自 Matt Pocock 的 skills 邮件——整包技能的正确打开方式,就是按下面 这条工作流从头跑到尾。Sandcastle 为外部工具,不在本包内。

Prompts are disposable. Workflows are reusable. That is the whole difference, and these seven lessons are one workflow in the order you would actually run it:

提示词用过即弃,工作流可以复用——全部区别就在于此。而这七课,合起来 就是一条按真实执行顺序运行的工作流:

Step	原文	对照中文
0	This email. Pick your path.	这封邮件就是起点:选一条路。
1	/grill-with-docs , so the agent is not building from fog	先把想法拷问清楚,agent 才不会在迷雾中开工
2	/prototype and /handoff , to test the uncertain part in a toy version	用玩具原型验证不确定的部分,并留好交接
3	/to-spec and /to-tickets , to break big work into reviewable slices	把大工作拆成可评审的切片
4	Sandcastle , to run AFK agents somewhere safe	在安全的地方跑挂机(AFK)agent(外部工具,不在本包)
5	/code-review , so each run teaches the next one	每一次评审,都让下一次运行变得更好
6	The full loop, start to finish	从起点到终点,跑完整条循环

在 DeepSeek Harness 中安装与使用

这是 DeepSeek Harness 的插件包。安装后会把技能注册进 host 技能注册表, 你 profile 里的每个 agent 会话都能在技能目录中看到它们,并可用 skill 工具加载。

前置条件

• 已安装 DeepSeek Harness,并且有 pnpm —— dsh plugin 命令内部调用 pnpm(用 pnpm --version 检查;没有的话到 https://pnpm.io 安装)

• dsh 命令行。它随 Harness 一起提供,通常以 npx @deepseek-ai/dsh web 方式启动。要么把它装成全局命令,要么在所有命令前加 npx:

  # 方式一:全局安装 dsh,永久可用(推荐)
  npm install -g @deepseek-ai/dsh
  dsh --version
  
  # 方式二:不安装,所有命令用 npx 形式
  npx @deepseek-ai/dsh --version
  

  下文所有 dsh ... 示例都可以等价写成 npx @deepseek-ai/dsh ...。

最简单:一条命令(从 GitHub 安装)

npx @deepseek-ai/dsh plugin --profile web add github:gongyijie85/mattpocock-skills-dsh

从本地文件夹安装(开发阶段)

# 任意目录下执行;文件夹安装是链接方式,改完重启 profile 即生效
dsh plugin --profile web add D:\plugins\mattpocock-skills-dsh

让 DeepSeek Harness 帮你安装

打开 DeepSeek Harness(Web 界面),新建对话,把下面这句话发给它:

帮我安装这个链接里边的插件:https://github.com/gongyijie85/mattpocock-skills-dsh

Agent 会自动完成安装(dsh plugin add → 重启 profile → 验证技能注册)。

重启并验证

bundle 层在 profile 启动时挂载,所以需要重启 profile(停掉后重新运行 dsh web / npx @deepseek-ai/dsh web,再刷新浏览器)。确认层已组合:

dsh --profile web --dump-config     # 必须出现 `mattpocock-skills-dsh` 行

之后技能会出现在 agent 技能目录中,可以用 skill 工具加载。

卸载

dsh plugin --profile web remove mattpocock-skills-dsh
# 卸载后同样需要重启 profile

技能列表(全量 25 个 = 上游 promoted 集)

productivity(7)

技能	用途(官方描述对照翻译,见 aihero.dev/skills)	调用方式
grill-me	把一个模糊的想法拷问成你能承诺的东西——以"轮"提问,每轮只问前置条件已定的完整前沿(frontier)	用户调用(指向 grilling)
grilling	在任何人行动之前压力测试计划/决策/想法的面试循环:把主题映射成设计树,逐支问到底,直到没有默认假设残留	模型/用户调用
handoff	把当前对话压缩成交接文档——写到系统临时目录(而非工作区)的单个 Markdown 文件,新 agent 读它即可接手	用户调用
teach	把所在目录变成常驻教学空间,跨多个会话用短小的自包含 HTML 课程教一个主题	用户调用
to-questionnaire	把一个人定不了的决策变成问卷——交给掌握缺失信息的人异步填,或开会一起过	用户调用
wait-what	消息没接住时输入它:agent 重讲一遍刚才的话,补上缺失的上下文、用平实的英语、采用项目 CONTEXT.md 的词汇	用户调用
writing-for-agents	写 agent 消费文档的参考(skill、AGENTS.md/CLAUDE.md、spec、运行时提示词、README):包装不同,写法相同	模型/用户调用

engineering(18)

技能	用途(官方描述对照翻译,见 aihero.dev/skills)	调用方式
ask-matt	全仓库技能的路由器:描述你的处境,它给出匹配的技能或技能序列,以及其中人类决策的位置	用户调用
code-review	按两个轴评审 HEAD 与指定基点的 diff:Standards(是否符合本仓库写法)+ Spec(是否实现了源头 issue/spec),两轴各由独立子代理运行	模型/用户调用
codebase-design	固定模块设计词汇:module、interface、depth、seam、adapter、leverage、locality,逐一精确定义并禁用松散替身词	模型/用户调用
diagnosing-bugs	对硬 bug 或性能回归跑六阶段诊断:复现→最小化→假设排序→插桩→带回归测试修复→清理	模型/用户调用
domain-modeling	设计过程中构建并打磨项目的通用语言:挑战与词汇表冲突的术语、逼出精确词、用具体场景压力测试关系	模型/用户调用
grill-with-docs	拷问计划/设计直到共享理解,同时把词汇与硬决策写进仓库(ADR + 词汇表);与 grill-me 同款面试,面向代码库	用户调用
implement	构建已决策的工作:指向 ticket/spec/刚谈定的计划,写代码、在接缝处驱动 tdd、边写边类型检查、末尾跑 code-review 并提交	用户调用
improve-codebase-architecture	扫描代码库找加深机会(浅模块→深模块),写成自包含 HTML 报告,然后拷问你选中的那个	用户调用
prototype	写一次性代码回答问题——状态模型对不对、界面该长什么样;问题先行,答错问题就是纯浪费	模型/用户调用
research	只从一手资料(官方文档/源码/spec/官方 API)读答案,在仓库留下带引用的 Markdown;每条结论追到拥有它的源头	模型/用户调用
resolving-merge-conflicts	逐块解决进行中的 git merge/rebase 冲突,跑项目自己的检查,提交收尾	模型/用户调用
setup-matt-pocock-skills	回答一个仓库的三个问题(issue 放哪、triage 标签叫什么、领域文档在哪),以 docs/agents/ 下的 markdown 记录	用户调用
tdd	测试先行构建功能/修 bug:一个失败测试→刚好能过的代码→下一个行为;并携带让测试套件值得保留的标准	模型/用户调用
to-spec	把刚谈完的对话变成 spec,作为单个 issue 发布到 issue tracker	用户调用
to-tickets	把计划/spec/对话拆成一组 ticket,每个声明阻塞边(必须先行完成的其它 ticket)	用户调用
triage	把 tracker 上的 issue 逐个走完 triage 角色状态机,留下 agent-ready 简报、给报告人的具体问题、或带原因关闭的 issue	用户调用
wayfinder	把超过一个 agent 会话的大工程画成 issue tracker 上的决策票据地图,逐条解决直到路清晰	用户调用
wizard	生成交互式 bash 脚本,一步步带人走手动流程(接三方服务/一次性迁移):打开 URL、说清点哪复制什么、捕获结果写入 .env 与 GitHub secrets	模型/用户调用

说明:/clear、/compact 是上游引用的 Claude Code 原生命令,非本包技能; DSH 中对应"开新会话"与"手动摘要续接",详见 skills/ask-matt/PHASE-BOUNDARIES.md 的移植注记。

移植说明(对比上游 mattpocock/skills)

• 格式:上游即标准 SKILL.md(YAML frontmatter:name + description,可选 whenToUse),DSH 可直接消费,正文基本零改动。
• 调用语义:上游 disable-model-invocation: true(仅用户可调,如 grill-me、wait-what)映射为 DSH 的 invocation.modelInvocable: false, 保留原意图;其余技能模型/用户均可调用。
• 工具名适配:grill-me 原文 "Call the Skill tool with 'grilling'" 的 Claude Code 工具名改为 DSH 的 skill 工具;grilling 中的"dispatch a sub-agent"对应 DSH 的 subagent 工具,原文措辞通用,未改动。
• 未移植的辅助文件:各技能目录下的 agents/openai.yaml 是 Codex 的 调用策略,DSH 不需要,已剔除;writing-for-agents 的相对引用 SKILL-MECHANICS.md 随包保留,由 resourceBase 解析。
• 相对引用:技能目录内相对文件(如 SKILL-MECHANICS.md)通过 resourceBase 指向技能所在目录,可正常加载。

工作原理

• Bundle 层 —— cordis.patch.yml 在 dsh-base 层之上插入一行 (- id: mattpocock-skills-dsh, name: mattpocock-skills-dsh)。后面的层 (profile 的 cordis.patch.yml、--patch 叠加)仍可按 id 定位这一行。
• 提供者 —— lib/index.js 调用 ctx.skills.registerProvider(...):
  • list() 扫描包内 skills/ 目录,把每个 <name>/SKILL.md 作为候选, 从 YAML frontmatter 解析出 name、description、whenToUse 与 disable-model-invocation。
  • get() 按需读取候选技能正文,返回完整技能定义,resourceBase 指向 技能所在目录,使相对引用可以正确解析。
• 零运行时依赖 —— 插件只使用 Node 内置模块,消费注入的 ctx.skills 服务接口。

添加自己的技能

往包里放一个新的 skills/<kebab-name>/SKILL.md 即可——它必须以 YAML frontmatter 开头(name + description,可选 whenToUse 与 disable-model-invocation)。无需改任何代码:list() 会自动发现它。

许可证

MIT。技能内容改编自 mattpocock/skills(MIT),© Matt Pocock;DSH 移植部分 © mattpocock-skills-dsh contributors。见 LICENSE。