前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。在构建智能体时，Agent Skills 的获取、验证和版本管理是常见痛点。手动筛选和验证技能文件不仅耗时，而且容易引入格式错误或不稳定的源。
Awesome DeepSeek Skills 是一个社区项目，旨在为 DSH 提供一个可浏览、可安装的 Agent Skills 精选目录。它不依赖全网抓取，而是通过人工筛选和静态验证，提供一组经过结构校验的技能清单。每个条目都锁定在特定的 Git 提交上，确保环境可复现。
插件简介¶
- 名称: Awesome DeepSeek Skills
- 所有者: Whning0513
- 许可证: MIT
- 定位: DeepSeek Harness 的精选技能目录插件
该插件解决了技能来源不可信、版本难以锁定、格式验证缺失的问题。它提供离线浏览能力，并将安装过程限制在特定的提交哈希上，防止意外更新。
核心功能¶
- 浏览与安装: 通过插件提供的工具直接在 DSH 中浏览和安装目录中的技能。
- 离线列表: 安装后，技能列表会打包在插件中，无需联网即可搜索可用技能。
- 静态验证: 安装前会对技能结构进行静态检查，确保符合 DeepSeek/DSH 的兼容性规范。
- 源码锁定: 安装器会检出目录中指定的精确提交，而不是拉取最新的
main分支。
安装与启用¶
安装前请确保已安装 DeepSeek Harness 并配置好环境。请将命令中的 demo 替换为你实际使用的 DSH 配置文件名。
dsh plugin --profile demo add github:Whning0513/awesome-deepseek-skills
安装完成后，需要重启 DSH 进程才能使插件生效。
典型用法¶
安装并重启 DSH 后，会新增两个命令工具：
deepseek_skills_list: 在本地列表中搜索技能。deepseek_skill_install: 将选中的技能安装到当前项目。
列出可用技能¶
在 DSH 中直接调用：
deepseek_skills_list
安装特定技能¶
使用安装命令指定技能 ID 和目标路径（通常为 .agents/skills）：
deepseek_skill_install obra/superpowers/verification-before-completion
若需通过 Python 脚本直接操作目录（例如在 CI 中），可以使用以下命令：
uv sync --locked
uv run python scripts/catalog.py list
安装特定技能的示例：
uv run python scripts/catalog.py install obra/superpowers/verification-before-completion --target /path/to/project/.agents/skills
验证机制与限制¶
该插件提供的“验证”仅指静态结构检查，而非安全审计。
验证流程¶
每个条目在入库前会经过以下检查：
* 使用 deepseek-skill-doctor 进行解析。
* 使用 skill-validator v1.6.0 进行结构模式验证。
* 使用 DeepSeek/DSH 兼容性配置文件进行检测。
由于外部链接检查依赖实时网络且不可复现，验证仅针对技能文件的内部结构。
安全与权限说明¶
- 不执行脚本: 插件安装器只负责复制文件，不会运行技能中的任何脚本。
- 拒绝覆盖: 安装器会检查目标目录是否存在，拒绝覆盖已有文件，并拒绝安装包含符号链接的技能。
- 源码审查: 技能可能包含不安全的指令。安装前请务必阅读源码、许可证以及报告中的风险提示。
依赖要求¶
- Git: 安装器依赖 Git 来检出精确的提交。
- Python: DSH 插件本身不需要 Python 环境，但若要使用目录仓库自带的 Python 脚本（如 catalog.py），则需要 Python 环境。
- Node.js: 插件包要求 Node.js 版本为
^22.19.0 || >=24.0.0。
结语¶
Awesome DeepSeek Skills 是一个社区维护的技能目录，用于辅助 DSH 开发者快速、安全地引入经过结构验证的 Agent Skills。所有安装记录都会写入项目根目录下的 .deepseek-skills.lock 文件中，以追踪技能来源。
- 项目主页: https://github.com/Whning0513/awesome-deepseek-skills
- 目录页面: https://www.skillhub.cn/plugins/Whning0513/awesome-deepseek-skills
