前言¶
在 DSH 里跑智能体时,常见做法是为每个场景单独写提示词或零散脚本:交接上下文要手写摘要,从讨论落到 spec 或工单要靠人工整理,代码评审和安全加固也缺少统一流程。社区里已有成熟的技能文本(例如 mattpocock/skills),但直接搬进 DSH 往往还带着平台专属目录结构,跨 Windows、macOS、Linux 时维护成本偏高。
下面介绍维护者 snow-The 发布的 dsh-skill-pack:把一批工程向 SKILL.md 技能整理成 DSH 插件,通过宿主文件系统挂载,不依赖平台专属代码。适合希望在 Harness 里复用「交接、拷问 spec、写 spec/工单、实现、评审」等固定工作流的开发者。
这是什么¶
dsh-skill-pack(npm 包名 @snow-the/dsh-skill-pack,当前资料中版本 0.3.1)是面向 DeepSeek Harness 的工作流类插件:收录 29 个技能,涵盖工程流程、写作与 DESIGN.md 设计说明格式。插件在 SkillHub 目录 归类为工作流;源码与说明见 GitHub:snow-The/dsh-skill-pack。
定位可以概括为 README 中的一句:Curated engineering skills for DeepSeek Harness,强调 cross-platform by construction——技能是纯文本(SKILL.md 与 references),经 DSH 的 @deepseek-ai/dsh-skill-filesystem 挂载;除该宿主能力外无额外运行时依赖,也无平台专属实现代码。
核心功能¶
技能按主题分成三组(数量与名称以 README 表格为准)。
工程工作流(摘自 mattpocock/skills 的整理)¶
| 技能名 | 作用(README 原文摘要) |
|---|---|
handoff |
将对话压缩成交接文档,供其他智能体继续 |
teach |
在工作区内向用户讲解新技能或概念 |
to-spec / to-tickets / to-questionnaire |
把对话整理成 spec、工单或问卷 |
implement |
根据 spec 或工单实现一块工作 |
triage |
按 triage 角色推进 issue/PR |
wayfinder |
将大型工作规划为决策工单地图 |
loop-me |
对要落地的 workflow spec 做拷问(grill) |
ask-matt |
本包内技能的路由入口 |
zoom-out |
获取更广上下文 / 更高层视角 |
improve-codebase-architecture |
扫描可深化点,输出 HTML 报告 |
setup-ts-deep-modules |
为 deep-module 型 TS 仓库接入 dependency-cruiser |
wizard |
为手工流程生成交互式 bash wizard |
api-and-interface-design |
稳定 API/接口设计(Hyrum’s Law、契约优先) |
code-review-and-quality |
多维度代码质量评审门禁 |
code-simplification |
在不改行为的前提下简化代码 |
deprecation-and-migration |
下线旧系统 / 迁移用户 |
documentation-and-adrs |
决策、ADR 与文档 |
doubt-driven-development |
决策固化前用新鲜上下文做对抗式评审 |
incremental-implementation |
以细垂直切片交付变更 |
performance-optimization |
前端/后端/查询性能 |
security-and-hardening |
针对漏洞加固代码 |
source-driven-development |
以官方文档为据实现 |
test-driven-development |
完整 TDD 循环(跨 pack 的通用 TDD 技能) |
写作(同样来自 mattpocock/skills 整理)¶
edit-articlewriting-fragmentswriting-shape
设计¶
design-md:维护者自写,采用 google-labs 的 DESIGN.md 格式,为编码智能体提供持久化视觉身份说明。
质量与整理说明¶
README Notes 中写明:
- 技能为文本形态,在 Windows / macOS / Linux 上行为一致。
- 整理时移除了 Claude Code 的
agents/子目录结构。 - 全部技能已通过
dsh-plugin-doctor静态检查(标记为 SAFE)。
package.json 中声明的 DSH 兼容发布线包括 0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.2,verifiedAgainst 为 0.2.1-rc.2;engines.dsh 为 >=0.2.1-rc.2 <0.3.0-0。对等依赖包括 @deepseek-ai/dsh、@deepseek-ai/dsh-skill-filesystem(可选)、@deepseek-ai/dsh-tools(均 >=0.2.0-rc.1)。许可证为 MIT。
安装与启用¶
官方 README 给出的安装示例使用本地路径(请按你本机 clone 或解压位置替换路径,不要凭插件名拼接 github:owner/repo):
dsh plugin --profile web add file:~/source/repos/dsh-own-plugins/dsh-skill-pack
安装前建议:
- 确认本机 DSH 版本落在插件声明的
engines范围内。 - 阅读仓库源码与
LICENSE,插件以当前 dsh 进程权限运行,只安装你信任的来源。 - 需要文件系统技能挂载时,确保环境中具备
@deepseek-ai/dsh-skill-filesystem(README 将其作为跨平台挂载机制的一部分)。
社区目录 SkillHub 是独立站点,与 DeepSeek / 幻方无官方从属关系;安装命令以 GitHub README 原文为准。
典型用法¶
README 未提供逐步操作截图,但说明了使用形态:在 DSH 中通过技能文件系统加载各目录下的 SKILL.md,由智能体按技能说明执行流程。可按场景选用上表中的技能名,例如:
- 会话交接:在需要换 agent 或换会话时启用
handoff,产出结构化交接文档。 - 从讨论到可执行物:用
to-spec、to-tickets或to-questionnaire固化需求,再用implement或incremental-implementation落地。 - 规格与流程拷问:在定 workflow 前用
loop-me对 spec 追问;定稿前可用doubt-driven-development做对抗式检查。 - 质量与架构:合并前走
code-review-and-quality;大范围重构前可用improve-codebase-architecture或wayfinder规划。 - 不确定选哪个技能:README 提供
ask-matt作为本包内路由。
具体触发方式取决于你当前的 DSH profile(示例中为 --profile web)与技能发现配置;以你环境中的 DSH 文档为准,本文不编造未出现在资料中的 CLI 子命令。
适用场景与注意¶
更适合谁
- 已在用 DeepSeek Harness,希望用统一、可版本管理的 SKILL.md 替代零散提示词的团队或个人。
- 需要 spec/工单/交接/评审/TDD 等工程套路,且希望同一套技能跨操作系统复用。
- 关注 UI 或品牌一致性、想让智能体读取 DESIGN.md 的 front-end 或设计协作场景。
需要注意
- 插件内容是提示与流程文本,不替代你对仓库权限、密钥与合规的审查;安装与启用前请自行审阅
skills/与references/。 - 安装命令示例中的
file:~/...是维护者本地路径,你需要改为自己的目录或使用你环境中支持的等价安装方式(资料中未给出其他官方安装行)。 - 星标与社区热度以目录页为准(资料中 GitHub 星标为 0),选型时以功能列表与许可证为准即可。
结尾¶
dsh-skill-pack 把 29 个工程、写作与设计相关技能打成一份纯文本、跨平台的 DSH 插件,并经过 dsh-plugin-doctor 静态 vetting。若你正在 Harness 里搭建可复用的工作流,可以先按 README 安装到本地 profile,再从 handoff、to-spec、code-review-and-quality 等与你当前阶段最贴近的技能试起。