hackerFish/awesome-dsh-skills

🐋 awesome-dsh-skills — DSH 技能库

实测可用的 DeepSeek Harness 技能（skills）精选库：每个 SKILL.md 都通过格式校验与加载冒烟，复制即用。

与 dsh-lab（插件实测实验室）共用同一套标准：先验证，再发布。dsh-lab 回答"这个插件能不能装、代码里有什么"，本库回答"模型按什么流程干得更好"。兄弟仓库：dsh-restart（启动/重启/检查 dsh Web 服务，独立项目）。

什么是 DSH 技能

DSH 会扫描技能目录，把 SKILL.md 注册进模型可见的技能目录（catalog），模型按需加载正文作为指令。规则（对照官方 @deepseek-ai/dsh-skill-filesystem 的实现）：

- 位置：//SKILL.md 或扁平 .md，只发现一层；
- frontmatter 必填：name（kebab-case）与 description；可选：whenToUse、metadata、disable-model-invocation、user-invocable；
- 默认根目录（按优先级）：项目 .dsh/skills、项目 .agents/skills、用户 ~/.dsh/skills、~/.agents/skills。

安装

git clone https://github.com/hackerFish/awesome-dsh-skills ~/dsh-skills
mkdir -p ~/.dsh/skills
cp -r ~/dsh-skills/skills/* ~/.dsh/skills/     # 全部
或只复制你需要的单个技能目录，例如：
cp -r ~/dsh-skills/skills/dsh-git-commit ~/.dsh/skills/

新会话创建时生效（技能目录在启动时被扫描，运行中也会被 watch 跟踪）。

质量保证（禁得起推敲）

每个技能入库前必须通过两道关：

1. 格式校验：node tools/validate-skills.mjs 全绿——name 规则、frontmatter 字段白名单、布尔字段取值、单层结构，逐条对照官方实现规则。
2. 加载冒烟：node tools/smoke-load.mjs——用真实 DSH 的官方 @deepseek-ai/dsh-skill-filesystem provider 在隔离 DSH_HOME 中实载全部技能，断言无缺失/无解析拒绝。需要本机装有 DSH（包路径自动解析，或 --pkg  显式指定）。最近一次实测 dsh-skill-filesystem@0.1.1-rc.2（2026-09）。

内容红线：只写验证过的事实；涉及 DSH 的命令与结构以官方包为准；不收录未经检验的"魔法提示词"。

技能清单（19）

| 技能 | 用途 |
|---|---|
| dsh-git-commit | 约定式提交 + 提交前最小自检 |
| dsh-code-review | 六维结构化代码审查 |
| dsh-test-first | 先写失败测试，再最小实现 |
| dsh-doc-sync | 改动后同步文档与版本号 |
| dsh-plugin-dev | 按已验证结构开发/调试 DSH 插件 |
| dsh-plugin-client | DSH 插件 client 半端：slot 与标准-kit 注册、双目标构建、__ModuleLoader__ 包装与自测 |
| dsh-plugin-i18n | DSH 插件 UI 国际化（中/英）：locale 命名空间、slot locale 声明、t() 取词与即时切换 |
| dsh-plugin-publish | 发布 DSH 插件并收录进生态：构建产物入库、GitHub 建仓与 topics、awesome 列表 PR、编码陷阱 |
| dsh-preset-authoring | 编写/修改 DSH agent 预设（agent.cordis.yml + preset.yml）：已验证行结构、id 规则、.agent-presets 落位与 harness 校验 |
| dsh-dependency-audit | 依赖审计与升级回滚预案 |
| dsh-refactor-safe | 先立测试基线，小步安全重构 |
| dsh-debug-session | DSH 启动/插件异常排查流程 |
| dsh-changelog | Keep a Changelog 变更记录 |
| dsh-chinese-docs | 中文技术文档写作规范 |
| dsh-pr-review | PR 审查清单与结构化反馈 |
| dsh-task-breakdown | 复杂任务拆解与验收标准 |
| dsh-skill-adapter | 将公开可移植技能适配为 DSH 技能：发现根、工具映射与安全约束 |
| dsh-webapp-testing | 浏览器实证的 Web 应用测试：控制台、网络、服务端与回归检查 |
| dsh-office-artifacts | XLSX/DOCX/PPTX/PDF 生成与修复：格式感知、重开与渲染验证 |

贡献

见 CONTRIBUTING.md。投稿必须通过校验器与冒烟，并遵守原创红线。

免责声明

技能是文档型指引，本身不执行代码、不产生副作用；但模型会按技能正文行事，请只安装你读过并信任的技能。本库与 DeepSeek 官方无隶属关系。

许可证

MIT