前言¶
DSH 的理念是「一切皆插件」。對智能體開發者來說，常見痛點不是單個提示詞不夠，而是論文閱讀、製圖、文檔轉換、安全審計等任務難以跨項目複用。Azzygoatcoder/agent-useful-skills 把這類任務組織成 skill + 腳本的模塊，併兼容 Claude Code / DeepSeek Harness。這裏按 DSH 插件生態介紹，不把社區目錄寫成官方應用商店。
這是什麼¶
Azzygoatcoder/agent-useful-skills 是 Azzygoatcoder 維護的模塊化 AI 科研/工程技能集合，許可證爲 MIT。它的目標是把“讀論文、畫圖、寫文檔、安全審計”等重複流程沉澱成可註冊、可校驗、可部署的技能模塊。資料說明設計靈感受 ARIS 啓發，但未直接使用其代碼；第三方內容歸屬見 THIRD-PARTY-NOTICES.md。
核心功能¶
下面介紹已覈實的幾類能力。
安全審計¶
支持場景分流、並行探索、深度驗證、報告、增量重審計和狀態追蹤。實際使用時可觸發 code-security-audit skill，或直接用 /audit。
論文工作流¶
覆蓋論文閱讀、論文寫作、LaTeX 模板管理和編譯頁數檢查。
Office 處理¶
支持 markdown 轉 docx/pptx、Excel 處理和提取圖片。
數據圖與矢量圖¶
支持期刊級數據圖、draw.io 復刻和矢量圖一致性檢查。
只讀磁盤存儲分析¶
提供只讀磁盤存儲分析和交互式 HTML 報告。
Git 協作與發佈¶
覆蓋 issue、PR、release、review。
跨模型驗證環¶
提供識圖渲染複覈和跨模型對抗評審，用於對生成結果做二次檢查。
DSH 插件外殼與部署腳本¶
提供 DSH 插件外殼、技能註冊、檢查和部署腳本。默認註冊技能清單當前 18 個，歸檔技能默認不註冊。
安裝與啓用¶
DSH 插件安裝¶
下面命令用於通過 DSH 安裝該插件：
dsh plugin --profile web add github:Azzygoatcoder/agent-useful-skills
插件腳本會以當前 dsh 進程權限運行，安裝前建議檢查源碼、依賴和 MIT 許可證。
DSH 技能目錄規則¶
DSH 只識別單層技能目錄：
<技能根>/<技能名>/SKILL.md
插件內技能需要逐個建 junction，不要把整個 skills/ 目錄鏈過去。
技能鏈接示例¶
Claude Code 用戶可以把單個 skill 鏈接到 ~/.claude/skills/：
ln -s "$(pwd)/superpowers/skills/paper-reading" ~/.claude/skills/paper-reading
DSH 在 Windows 上可以用 junction 指向用戶級技能根：
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\skills\paper-reading" -Target "$pwd\plugins\superpowers\skills\paper-reading"
鏈接部署下，在 DSH 技能管理界面中只用啓用/禁用，不要用刪除；刪除可能級聯到鏈接目標。
腳本調用¶
bin/ 下的腳本可以直接用 Python 調用，也可以先執行：
pip install -e .
經過上面的步驟，就可以使用：
review file.md
vision img.png "描述"
office-tools md2docx a.md b.docx
latex-build list
典型用法¶
識圖¶
先配置好環境變量，再執行：
python bin/vision.py <image_path> "描述這張圖"
識圖腳本依賴 LLM_API_URL 和 API key 環境變量。VISION_PROVIDER 可切換識圖後端，默認 siliconflow。
markdown 轉 Word¶
python bin/office_tools.py md2docx 筆記.md 報告.docx --toc
數據圖¶
python bin/data_plot.py demo
安全審計¶
觸發 code-security-audit skill，或直接用 /audit。
技能校驗與部署¶
校驗 SKILL.md 是否符合 DSH/AgentSkills 規則：
python bin/check_skills.py
自動化部署/自愈 DSH 技能鏈接：
pwsh bin/redeploy-skills.ps1
白盒自檢¶
node bin/verify-plugin.mjs
執行前需保證倉庫根 node_modules/@deepseek-ai/dsh-skill-filesystem 可解析。
配置與依賴¶
腳本優先讀環境變量，兜底 ~/.claude/settings.json。倉庫不硬編碼任何供應商端點或密鑰。以默認識圖後端爲例，可以先設置：
export LLM_API_URL="<你的 API 端點>"
# 按腳本要求設置對應的 API key 環境變量
export VISION_PROVIDER="siliconflow"
API key 只寫在環境變量或本地配置中，不要提交到倉庫。
適用場景與注意¶
適合把科研和工程中的重複任務沉澱爲可複用技能的開發者。使用前注意：
- DSH 插件會運行倉庫內腳本，建議使用前檢查源碼與 MIT 許可證。
subagent-driven-development/scripts/下 3 個無擴展名腳本是 bash，Windows 需在 Git Bash / WSL 下運行。- 鏈接部署下，DSH 技能管理界面只啓用/禁用，不刪除，避免級聯影響鏈接目標。
- DSH 只識別單層技能目錄，插件內技能逐個建立 junction。
結尾¶
agent-useful-skills 的價值在於把讀論文、畫圖、寫文檔、安全審計等流程變成可註冊、可校驗、可部署的 DSH/Claude Code 技能模塊。GitHub 倉庫：
