前言¶
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 仓库：
