前言¶
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
