xiaoxiaosrm/dsh-mattpocock-skills

Matt Pocock 工程技能 — 适用于 DeepSeek Harness (DSH)

License: MIT
Unofficial adaptation
DSH plugin
Release v0.4.0
GitHub stars

⚠️ 非官方社区改编版。 本包是一个改编版，而非
上游项目。技能正文由 Matt Pocock 撰写
（mattpocock/skills，MIT，© Matt Pocock）
——我们并未创作这些内容。我们只是将它们重新整理为 DSH 的技能布局，
并将其封装为一个 DSH bundle 插件。如果你觉得它们有用，请给上游仓库点星。
许可证与署名：LICENSE。

一个 DeepSeek Harness bundle 插件，将 Matt Pocock 的
_"Skills for Real Engineers" / Engineering — straight from my .agents directory_
技能集移植为原生、可被发现的 DSH 技能。

这是一个技能集改编版，而非 Claude Code 插件 harness 的 fork：
SKILL.md 正文按原样保留（相同的提示词、相同的流程），
仅重新整理，以便 DSH 的单层技能发现机制（//SKILL.md）能够找到它们。

内容 — 27 个技能（18 个工程 + 7 个生产力 + 2 个实验性）

工程（18）

| 技能 | 作用 |
|---|---|
| ask-matt | 将请求路由到正确的技能/工作流及阶段边界 |
| code-review | 对 diff 进行双轴审查（标准 + 规范），HEAD 对比固定点，通过并行子代理执行 |
| codebase-design | 先设计后实现的代码库架构（DEEPENING.md、DESIGN-IT-TWICE.md） |
| diagnosing-bugs | 系统化 bug 诊断，带有人工介入模板 |
| domain-modeling | 通过 ADR + CONTEXT 格式对领域建模 |
| grill-with-docs | 快速、以文档为中心的问答 |
| implement | 聚焦的实现简报 |
| improve-codebase-architecture | 重构，并附上发现的 HTML 报告 |
| prototype | 原型开发，附带 LOGIC.md / UI.md 配套文件 |
| research | 将主题研究作为结构化任务 |
| resolving-merge-conflicts | 引导式合并冲突解决 |
| setup-matt-pocock-skills | 安装时设置：issue-tracker 提供方、triage 标签、domain.md |
| tdd | 红/绿/重构纪律，附 mocking.md + tests.md 指南 |
| to-spec | 严格按书面规范实现 |
| to-tickets | 将工作拆分为工单 |
| triage | 根据范围对传入工作进行分诊（AGENT-BRIEF、OUT-OF-SCOPE） |
| wayfinder | 当你不知道下一步时使用的导航/决策技能 |
| wizard | 由 template.sh 驱动的多步骤引导式工作流 |

生产力 (7)

| 技能 | 功能说明 |
|---|---|
| teach | 仅限用户调用。 在持久化教学工作区（MISSION.md、lessons/、learning-records/、reference/）中向用户教授一项新技能或概念。从 / 斜杠菜单中选取，或输入 /teach  —— 模型无法自行调用它。 |
| grill-me | 用户接受拷问，以打磨自己的方案 |
| grilling | 以不间断的追问拷问一份方案/设计 |
| handoff | 为另一个智能体或人类生成一份清晰的交接摘要 |
| to-questionnaire | 将对话转化为结构化问卷 |
| wait-what | 对某项主张或方案进行“等等，什么？”式的二次审视 |
| writing-for-agents | 编写针对智能体优化的文档/指令（SKILL-MECHANICS.md） |

实验性 (2 个，来自上游进行中的 beta 渠道)

| 技能 | 功能说明 |
|---|---|
| retro | 仅限用户调用。 对一次编码会话进行回顾，并就编码智能体环境的未来运行提出改进建议。 |
| implement-spec | 仅限用户调用。 将一份书面规格实现为单个 PR，以任务图的方式推进其工单，并保持一个可随时抓取的前沿。 |

这两个技能均来自上游的 skills/in-progress/ beta 渠道 —— 它们
属于实验性内容，其内容可能随上游迭代而变化。

关于 teach： 它带有 disable-model-invocation: true（上游
设计）—— 模型无法自行加载它，因此它不会出现在
模型的技能目录中。它是一个用户可调用的技能：它会出现在
/ 斜杠菜单中，且前置步骤的手势边界也会识别消息中手动输入的
/teach ... 标记。

每个技能都是一个单层级的 skills//SKILL.md 目录，其资源
（agents/openai.yaml、scripts/、参考 .md）与它放在一起。DSH 发现
它们的方式与任何本地技能完全相同。

如何调用每个技能

DSH 按谁可以加载它们来对技能进行分类。此捆绑包中的 27 个技能分为
两组（已对照真实的 skill-filesystem 提供程序验证）：

| 分组 | 技能 | 如何使用 |
|---|---|---|
| 模型 + 用户 (11) | code-review、codebase-design、diagnosing-bugs、domain-modeling、grilling、prototype、research、resolving-merge-conflicts、tdd、wizard、writing-for-agents | 当任务匹配时，模型可以自行加载它们；它们也会出现在 / 斜杠菜单中，供你强制调用。 |
| 仅限用户 (16) | teach、ask-matt、grill-me、grill-with-docs、handoff、implement、implement-spec、improve-codebase-architecture、retro、setup-matt-pocock-skills、to-questionnaire、to-spec、to-tickets、triage、wait-what、wayfinder | 只有你可以启动它们 —— 在 / 斜杠菜单中选取它们，或在编辑器中输入 /name 。模型不会自行调用这些技能（其中若干项在上游为 disable-model-invocation）。 |
为什么这么多技能仅限用户调用： 上游将交互式教练流程
（teach、grill-me、wait-what、to-questionnaire）和工作接收流程
（to-spec、to-tickets、triage、wayfinder）标记为仅限用户手势触发，这样
模型就不会在未经提示的情况下启动多会话流程。如果你希望模型能够自行
选用其中某个技能，请复制该技能的 SKILL.md 并删除
disable-model-invocation: true 这一行。

生产力技能详解

这七个生产力技能是围绕你的工作风格的流程助手，
而非编码任务。最好从 / 菜单调用，或在消息中点名该流程。

- /teach  —— 旗舰技能。在当前目录中创建一个教学工作区：
MISSION.md（你为何想学习）、RESOURCES.md
（高可信度来源）、lessons/.html（每课一个范围紧凑的课程）、
learning-records/.md（以编号 ADR 风格记录你所学到的内容）、
reference/.html（可打印的速查表）、NOTES.md（偏好设置）。
教学是跨会话有状态的：文件会持久保存，因此下一次
/teach 会话会从你的学习记录继续，并计算出你的
最近发展区。
- /grill-me —— 智能体采访你，在你
投入之前帮你打磨计划。当你有一个半成形的想法时使用。
- /grilling —— 反过来：你（或你的规格说明）会被持续
盘问，以找出计划或设计中的漏洞。
- /handoff —— 为另一个智能体或人类队友写一份干净的交接摘要
（状态、决策、下一步）。
- /to-questionnaire —— 将当前对话提炼为一份结构化的
问卷（适用于需求收集或用户研究）。
- /wait-what —— 在你接受某个主张、估算或
计划之前，强制对其进行怀疑性的二次审视。
- /writing-for-agents —— 指导撰写智能体能够
真正遵循的文档/指令；附带 SKILL-MECHANICS.md 解释其机制。

新项目的典型首次运行流程

1. 运行一次 /setup-matt-pocock-skills 来配置你的问题跟踪器
（GitHub/GitLab/本地）和分类词汇。
2. 使用 /to-spec 或 /to-tickets 来捕获传入的工作。
3. 使用 /triage 和 /wayfinder 来路由和规划大块工作。
4. 在实现过程中使用 /code-review、/tdd、/diagnosing-bugs、/resolving-merge-conflicts。
5. 使用 /teach、/grill-me、/writing-for-agents 来满足你自己的学习和
文档需求。

安装

需要已安装 DeepSeek Harness（dsh 在 PATH 中，或使用仓库的 pnpm dsh）。

从 GitHub release 安装（最新发布的 tarball）
dsh plugin --profile web add https://github.com/xiaoxiaosrm/dsh-mattpocock-skills/releases/download/v0.4.0/mattpocock-community-dsh-engineering-skills-0.4.0.tgz

或从本地检出 / tarball 安装
dsh plugin --profile web add file:./mattpocock-dsh-engineering

然后重启该 profile。验证该 bundle 已加载且其技能可见：

dsh --profile web --dump-config | grep -A5 'skill-filesystem-mattpocock'

这些技能会与您正常的本地技能一起出现在模型目录中——
在每一个 DSH 界面（web、TUI、无头模式）上都是如此。仅用户级技能还会在
配置文件重启且会话（重新）打开后，出现在 / 斜杠菜单中。

关于 agent 资源文件的说明。 agents/.yaml 配套文件是 Claude
Code 接口描述符，不会被 DSH 解释。它们随包发布仅是为了忠实于源集合，
本身是惰性的。若干技能还引用了 /setup-matt-pocock-skills 斜杠命令和
docs/agents/issue-tracker.md，它们位于原始仓库根目录；请在您的项目中
运行一次该技能（或提供一个 issue-tracker），以便依赖跟踪的技能
（code-review、triage、to-tickets）能够解析出规范来源。

为什么用插件，而不是直接复制到 ~/.dsh/skills/

- 从一个交付物分发技能并对其进行版本管理，跨机器/仓库通用。
- 位于您配置文件的 node_modules 下，因此 dsh plugin remove 可以将其清理干净。
- 单个 cordis.patch.yml 将自身专用的宿主
skill-filesystem 实例*（skill-filesystem-mattpocock）注册到 DSH 的
全局技能层——因此该技能集会在每一个界面（web、TUI、
无头模式）中加载。该捆绑包不会修补共享的
skill-filesystem 行：web 配置文件将该行以 disabled 状态发布（“预设
拥有本地发现”），因此向其追加 customSkillDirs 会导致整个
技能集在 web 上不可见。取而代之，该捆绑包插入一个独立实例，带有
providerName: mattpocock 和 includeDefaultRoots: false，将其发现范围
隔离到恰好是该捆绑包的 skills/ 目录（该机制自 v0.3.0 起未变）。

注意： npm tarball 有意只发布运行时文件
（skills/、cordis.patch.yml、LICENSE、README.md）。完整的变更
历史位于 GitHub 上仓库的 CHANGELOG.md 中。

许可证与署名

MIT。技能正文改编自
mattpocock/skills（MIT，© Matt Pocock）。
参见 LICENSE。如果您觉得原始版本有用，请给上游
仓库点星；本包仅是社区分发改编版。