hackerFish/awesome-dsh-skills

hackerFish/awesome-dsh-skills

12 个实测工程技能(git 提交、代码审查、测试优先、插件开发、排障、CHANGELOG、PR 审查、任务拆解等):每个 SKILL.md 都通过对照官方规则的格式校验与隔离环境加载冒烟。

技能包agent-skillsai-agentsawesome-list

🐋 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 的实现):

  • 位置:<目录>/<name>/SKILL.md 或扁平 <name>.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-clientDSH 插件 client 半端:slot 与标准-kit 注册、双目标构建、__ModuleLoader__ 包装与自测
dsh-plugin-i18nDSH 插件 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-sessionDSH 启动/插件异常排查流程
dsh-changelogKeep a Changelog 变更记录
dsh-chinese-docs中文技术文档写作规范
dsh-pr-reviewPR 审查清单与结构化反馈
dsh-task-breakdown复杂任务拆解与验收标准
dsh-skill-adapter将公开可移植技能适配为 DSH 技能:发现根、工具映射与安全约束
dsh-webapp-testing浏览器实证的 Web 应用测试:控制台、网络、服务端与回归检查
dsh-office-artifactsXLSX/DOCX/PPTX/PDF 生成与修复:格式感知、重开与渲染验证

贡献

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

免责声明

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

许可证

MIT