Coder 技能预设 yuanshuoSY/dsh-coder-preset

dsh-coder-preset

一个 DeepSeek Harness bundle：提供 Coder agent preset 和 35 个 Matt Pocock 工程技能。技能只在 Coder 会话可见，安装后不会改变同一 profile 里其他 agent 的技能目录。

- 35 个技能：13 个 model-invocable（任务匹配时自动加载）和 22 个 user-invoked（输入 /技能名）
- 仅 Coder 会话可见：standard 会话加载不了
- 安装时不执行代码，也没有运行时依赖：只有配置、Markdown，以及少量技能自带的脚本和模板
- 随包技能来自 mattpocock/skills 的 5beb35b 提交（v1.3.1 加 47 个提交）
- 用 engines.dsh 门禁加每周 DSH canary（Ubuntu 和 Windows）报告插件 API 漂移

安装

1. 从 releases 页面 下载 dsh-coder-preset-1.2.0.tgz。
2. 打开 DSH 插件管理，选择安装本地 bundle，选中该 tarball。
3. 重启 DSH。
4. 新建会话，agent 选择 Coder。

CLI 托管的 profile（不适用于 Electron 托管的 desktop profile）：

dsh plugin --profile <profile> add /path/to/dsh-coder-preset-1.2.0.tgz

Windows 上 DSH 运行时升级可能报 EPERM。在插件管理里先禁用 bundle，安装新版本，再重新启用。

使用

- model-invocable 技能在任务匹配时自动加载，也可以手动输入，例如 /tdd。
- user-invoked 技能对模型不可见，需要你自己输入，例如 /ask-matt、/to-spec、/chief-of-staff。
- 每个项目第一次使用工程流前，跑一次 /setup-matt-pocock-skills。
- 技能只在 Coder 会话可见。

常用命令：

| 命令 | 作用 |
| /ask-matt | 把当前处境路由到合适的技能或流程 |
| /grill-with-docs | 追问并打磨计划或设计，同时写 ADR 和术语表 |
| /to-spec | 把对话整理成 spec 并发布到 issue tracker |
| /to-tickets | 把 spec 拆成带阻塞关系的 tracer-bullet 工单 |
| /implement | 根据 spec 或工单实现功能 |
| /tdd | 测试先行：红、绿、重构 |
| /code-review | 从 Standards 和 Spec 两个维度审查改动 |
| /pr | 按模板撰写 PR 正文 |
| /retro | 对一次编码会话做复盘 |

全部 35 个技能

| user-invoked（22） | model-invocable（13） |
| ask-matt, chief-of-staff, grill-me, grill-with-docs, handoff, implement, implement-spec, improve-codebase-architecture, loop-me, retro, setup-matt-pocock-skills, setup-ts-deep-modules, teach, to-questionnaire, to-spec, to-tickets, triage, wait-what, wayfinder, writing-beats, writing-fragments, writing-shape | code-review, codebase-design, diagnosing-bugs, domain-modeling, grilling, migrate-to-shoehorn, pr, prototype, research, setup-pre-commit, tdd, wizard, writing-for-agents |

兼容性

已在 Windows 上的 DSH 0.2.1-rc.3 验证：安装、Coder 会话看到 13 个 model-invocable 技能、/ask-matt 触发、standard 会话隔离。

CI 每次 push 到 main 和每个 pull request 都会把构建出的 tarball 装进临时 DSH profile：先检查组合后的 preset 条目，再用 DSH 自己的 loader 求值随包的技能目录表达式，并在结果上挂载真实的技能注册表和文件系统 provider。它会断言 35 个技能（13 个 model-invocable、22 个 user-invoked）并加载示例正文，因此 bundledSkillDir 或技能 provider 坏了会直接让 CI 失败。模型回合需要凭证，不在 CI 范围内；CI 证明的是技能目录，不是一次 agent 回合。

bundle 声明了 engines.dsh >=0.2.1-rc.3 <0.3.0。DSH 在安装 bundle 时检查这个范围，超范围时拒绝并给出具体要求和 dsh plugin allow-version 的补救方式；CI 用一个故意不兼容的构建端到端证明这次拒绝，并确认被拒绝的 bundle 不会贡献 preset。这个范围接受所有 0.2.x 版本，因为 semver 把 0.2.x 的补丁版本视为兼容，同时拒绝 0.3.0。范围内的 DSH 升级仍会挂载这份 pinned preset，所以 npm run verify-dsh 会比较全部 32 个插件行（含嵌套行和模块名），按名字报告漂移；每周 canary 在 Ubuntu 和 Windows 上跑同一套 diff。只有新 DSH 上 canary 和 smoke 都通过后，才在 package.json 里放宽这个范围。

定期 canary 会安装最新发布的 DSH（含预发布版本），运行 npm run verify-dsh（兼容性门禁，加上把全部 32 个 pinned 插件行与 DSH 自带 standard preset 做 diff），再跑完整 smoke，在 Ubuntu 和 Windows 上进行。GitHub Actions 全部按 commit SHA 固定，Dependabot 负责更新这些 pin 和开发依赖。

- issue tracker 类技能需要 gh、glab，或通过 /setup-matt-pocock-skills 配置的本地 markdown tracker。
- /implement-spec 需要 git worktree，尚未端到端验证。
- Windows 上基于 bash 的技能（例如 /wizard）需要 Git Bash 或 WSL。
- /ask-matt 会引用 /clear，DSH 没有该命令，请新建会话。
- 有 3 个上游技能没有随包：claude-handoff 需要 Claude Code CLI，git-guardrails-claude-code 需要 Claude Code hooks，scaffold-exercises 需要 ai-hero CLI。

从源码构建

npm ci
npm run validate
npm test
npm run build

npm run smoke 会构建 tarball、装进临时 DSH profile、检查组合后的 preset 条目，并通过 DSH 自己的注册表挂载技能目录。运行前需要 pnpm 和 DSH CLI，例如 npm install -g @deepseek-ai/dsh@0.2.1-rc.3。npm run build 会写出 tarball 和 dist/SHA256SUMS；npm run validate 会用 skills.manifest.json 校验每个随包技能文件，改过的技能正文在发布前就会失败。

npm run verify-dsh 会检查已安装的 DSH 是否满足 engines.dsh 门禁，并把全部 32 个 pinned 插件行（含嵌套行和模块名）与 DSH 自带 standard preset 做 diff；canary workflow 每周对最新 DSH 跑一次。npm run verify-gate 会构建一个故意不兼容的 bundle 副本，断言 DSH 拒绝安装它，是这道门禁的反向验证。

这些检查需要一个可导入的 DSH。Windows 桌面版把 DSH 放在 app.asar 里，普通 Node 无法导入，所以要么安装 CLI，要么用 ELECTRON_RUN_AS_NODE=1 运行脚本并把桌面可执行文件作为 --dsh 传入；解析器会把它映射到 resources/app.asar/dsh/node_modules/@deepseek-ai/dsh。没有该运行方式时，传入 asar 路径会得到同样的提示。在受限的 agent 沙箱里 npm test 无法派生测试进程时，npm run test:in-process 会在同一进程里跑同一批测试文件。

许可与署名

MIT。35 个技能来自 Matt Pocock 的 mattpocock/skills，以 MIT 许可分发。署名和未包含的上游技能见 NOTICE。本项目与 DeepSeek、Matt Pocock 均无隶属或背书关系。