Agent Skill 这段时间热度很高。除了 Claude Code、Codex 这类工具之外DeepSeek 也提供了自己的 Agent 框架 DeepSeek Harness并且带了一套完整的 Skill 安装与开发机制。简单说你可以给 Agent 装上 PPT 生成、UI 设计、文档整理这些技能包也可以把自己整理的流程做成 Skill 分享给团队。很多人在评估 Agent 工具时核心问题就三个好不好装、能不能按需加技能、能不能接到真实工作流里。这篇文章就把这三件事一次性讲透。本文会围绕 DeepSeek Harness 的安装启动、Skill 的搜索与安装、自定义 Skill 创建以及两个实际高频场景——PPT 生成 Skill 和 UI 设计 Skill 展开。如果你正在做 Agent 开发选型或者想把日常重复的 PPT、页面出图工作交给 Agent这篇文章可以直接收藏照着做基本能跑通。先说结论DeepSeek Harness 本质上是一个 Agent 编排层资源占用不高不需要专门显卡跑推理真正消耗资源的是背后的 LLM API 调用以及 Skill 内部脚本执行时的 CPU 开销。1. 核心能力速览先把最关键的规格信息放在前面方便你快速判断这个项目适不适合自己。能力项说明项目类型Agent 开发与运行框架DeepSeek Harness核心能力多 Agent 任务编排、Skill 安装与开发、Web 管理面板、插件扩展Skill 机制以SKILL.md为入口的技能包可包含参考文档、脚本、模板、资源文件启动方式命令行启动 /pnpm dsh web启动 Web 界面 / 桌面版社区反馈存在依赖环境Node.js、pnpm具体版本以官方仓库 README 为准模型接入通过 Agent 执行提供方调用 LLM API支持自定义模型配置接口能力支持 API/服务方式调用 Agent具体接口路径参考官方文档批量任务可通过 Skill 工作流批量处理文档、生成 PPT、生成 UI 原型硬件要求无需独立 GPU普通办公电脑可跑大规模批量任务需关注内存适合场景本地 Agent 开发、报告生成、PPT 制作、UI 设计稿输出、文档批处理从社区反馈来看DeepSeek Harness 的工作方式类似 Claude Code 的 Skill 机制一个 Skill 就是一个目录里面有SKILL.md描述文件外加可选的references/参考文档目录和scripts/脚本目录。Agent 根据用户输入自动判断需要加载哪个 Skill再按 Skill 里的工作流执行。值得强调的是这个架构有一个明显优势Skill 不只是一段提示词它还能携带脚本和模板。这意味着 Skill 不是让大模型凭空想象一份 PPT 或 UI 设计稿而是调用真实的代码生成.pptx文件或 HTML 页面输出结果的可控性和工程化程度比纯 Prompt 高出不少。2. Agent Skill 是什么能解决什么问题如果把 Agent 比作一个员工Skill 就是他的岗位技能包。没有 Skill 的 Agent 只会通用对话装了 Skill 之后它才知道怎么按照你的工作流整理会议纪要、生成标准 PPT、绘制符合企业规范的 UI 页面。Skill 与普通 Prompt 有两个本质区别。第一Skill 是结构化的目录可以包含多份参考文档和可执行脚本Prompt 只是其中一段描述文字。第二Skill 的触发机制更精准Agent 会根据用户意图自动选择匹配的 Skill而不是每次都在同一段超长 Prompt 里找指令。目前社区里常见的 Skill 类型包括PPT 生成类如用 Hermes 辅助编写的 PPT Skill核心原理是让 Agent 生成python-pptx代码再自动运行脚本产出.pptx文件。UI 设计类如ui-ux-pro-maxSkill约束 Agent 按照政府/企业级设计规范输出高保真 HTML 原型。文档整理类把会议记录、零散笔记整理成结构化 Markdown 或 Word 报告。代码审查类让 Agent 按团队规范检查代码仓库输出问题清单。知识库问答类结合企业内部的文档目录做定向检索和问答。对 DeepSeek Harness 来说Skill 生态的意义在于它把模型能力和业务规范解耦。模型负责理解和生成Skill 负责承载公司内部的流程、模板、脚本和设计标准。换模型时Skill 不用重写换 Skill 时模型也不用重调。这是 Agent 工程化落地时很重要的一环。3. 适用场景与使用边界适合使用 DeepSeek Harness Skill 的场景通常是这几类个人或小团队需要自动化生成文档、PPT、页面原型且对格式一致性有要求。工程师在做 Agent 应用开发需要一个支持自定义 Skill 和脚本的本地编排框架。UI 设计师需要快速产出多个候选方案再用专业工具精修。企业内部有大量模板化内容需要批量产出例如周报、项目计划、培训课件。不适合的场景也要说清楚。第一追求完全无人值守的自动化流程目前还做不到尤其是生成 PPT 或 UI 这类需要审美判断的内容必须人工复核。第二如果业务对输出格式有严格审核要求正式报告不能直接由 Agent 输出建议把 Agent 定位为初稿生成器。第三DeepSeek Harness 是编排层不是模型推理引擎如果你希望不依赖外部 API、用本地 GPU 跑大模型那还需要额外接入本地推理服务。使用边界方面有几个合规原则需要特别注意。生成 PPT 时如果引用了第三方版权图片、设计素材必须确认授权范围。UI 设计 Skill 如果涉及企业 VI、政府标志、政务系统界面任何正式场景下都要获得对应机构的授权。使用 Agent 自动执行批量任务时要限定执行范围和访问权限避免在未授权环境中运行脚本。4. 环境准备与前置条件DeepSeek Harness 是 Node.js 技术栈的项目从社区使用的pnpm dsh web命令可以判断所以环境准备主要围绕 Node 生态展开。4.1 基础软件清单依赖用途建议Node.jsHarness 运行时建议安装 LTS 版本本机测试时用 18 或 20pnpm包管理器注意 pnpm 版本要和项目兼容过旧会安装失败Git拉取项目源码必备Python 3Skill 脚本运行如 python-pptx生成 PPT 类 Skill 必需LLM API KeyAgent 模型调用需要准备一个可用的模型 API Key4.2 环境检查命令安装前先确认本机环境node -v pnpm -v git --version python --version如果还没有 pnpm用 npm 安装npm install -g pnpm4.3 目录规划建议按照下面的结构管理 Agent 相关工作区这样 Skill 和生成产物不会混在一起agent-workspace/ ├── deepseek-harness/ # DeepSeek Harness 项目源码 ├── skills/ # 个人 Skill 开发目录 ├── inputs/ # 测试输入素材 ├── outputs/ # Agent 生成产物 └── logs/ # 任务日志4.4 网络与端口安装时会拉取 npm 依赖确保网络可用。启动 Web 界面时如果遇到端口冲突需要检查哪个进程占用了端口并在配置中修改端口号。这一步做不好后面启动阶段很容易卡住。5. DeepSeek Harness 安装与启动DeepSeek Harness 的安装启动流程社区普遍反馈是先拉取源码、安装依赖、再用pnpm dsh web打开 Web 管理面板。下面是这套通用流程具体命令以官方仓库 README 为准。5.1 拉取并安装# 克隆项目代码实际仓库地址以官方文档为准 git clone project-url deepseek-harness cd deepseek-harness # 安装依赖 pnpm installpnpm install这一步要等一段时间依赖数量不少。如果网络不稳定可以配置 npm 镜像源后再执行。5.2 启动 Web 管理面板# 启动 Web 管理面板 pnpm dsh web启动成功后终端会打印访问地址。但这里要注意默认端口是多少没有统一答案不同版本可能不同一定要以终端日志输出的 URL 为准不要凭经验猜端口。5.3 配置模型 API第一次启动后需要配置 Agent 执行提供方。这里要对应到你在4.1里准备的 LLM API Key。打开 Web 面板的设置页填写模型提供方的接口地址、API Key 和模型名称。保存后建议先发起一个最简单的对话测试确认模型调用链路通了再继续。5.4 启动阶段常见卡点社区反馈最多的问题是卡在 pnpm dsh web。这个现象通常对应以下几种情况Node.js 版本过低或过高和项目要求不匹配。pnpm install没有完整执行依赖缺失。端口被占用服务启动后立即退出了。首次启动需要下载额外依赖或模型配置网络超时。排查时先看终端最后输出的错误信息再做对应的版本检查和依赖重装。不要一上来就怀疑代码有问题大部分启动失败都是环境问题。6. Skill 的安装与搜索技巧Skill 的来源主要有两个社区分享的现成 Skill以及你自己创建的私人 Skill。安装方式也分命令安装和手动安装两种。6.1 命令安装# 通用示例从 Harness 的 Skill 仓库安装 dsh skill install skill-name # 从本地目录安装自定义 Skill dsh skill install ./my-skill安装完成后用下面的命令确认 Skill 是否被正确加载dsh skill list6.2 手动安装目录结构如果命令安装不可用也可以直接把 Skill 目录复制到 Harness 的 skills 目录下。手动安装的好处是方便调试你可以随时修改SKILL.md里的描述和指令再重启 Harness 让它生效。~/.deepseek-harness/skills/ └── ppt-generator/ ├── SKILL.md ├── references/ │ ├── ppt-layout-guide.md │ └── style-example.pptx └── scripts/ └── generate_ppt.py6.3 判断 Skill 是否加载成功验证 Skill 有没有生效最直接的方法是新建一个 Agent 会话输入一个与该 Skill 强相关的任务。比如装了 PPT Skill 后直接输入帮我把这段内容做成一页 PPT 大纲观察 Agent 是否按照 Skill 里的流程执行。如果 Agent 表现得像没有这个 Skill多半是SKILL.md中的 description 描述写得不够准确导致意图匹配失败。另外要注意Skill 社区里的质量参差不齐。安装前先打开SKILL.md看一遍里面的指令和脚本确认没有恶意命令再决定是否交给 Agent 执行。这是 Agent 工具使用的基本安全习惯。7. 创建自己的 Skill从结构到完整流程自己创建 Skill 并不复杂核心就三件事设计目录结构、写清楚SKILL.md、提供必要的参考文档和脚本。7.1 Skill 目录结构一个标准 Skill 目录建议包含以下内容my-skill/ ├── SKILL.md # Skill 入口必填 └── references/ # 参考文档可选 │ └── guidance.md └── scripts/ # 脚本可选 └── process.pySKILL.md是 Skill 的入口文件一般包含 name 和 description 两个关键字段以及详细的 instructions。7.2 SKILL.md 模板下面是一个会议纪要 Skill 的示例--- name: meeting-notes description: 将会议录音转写文本整理成结构化会议纪要 --- # 会议纪要 Skill 当用户输入一段会议文字记录时按以下步骤处理 1. 提取本次会议的议题和讨论过程 2. 整理关键结论逐条列出 3. 提取待办事项标注负责人和截止时间 4. 输出 Markdown 格式的会议纪要 5. 如果用户要求导出 PPT引用 ppt-generator Skill 生成演示文稿 注意 - 不要修改原文中没有出现的结论 - 待办事项必须保留原时间表述这里最关键的是description字段。Agent 会靠它判断什么时候触发这个 Skill所以 description 里要写清楚处理什么类型的输入、输出什么结果。7.3 创建和安装步骤完整流程如下# 1. 创建 Skill 目录 mkdir -p my-skill/references my-skill/scripts # 2. 编写 SKILL.md 文件用编辑器打开 cd my-skill vim SKILL.md # 3. 安装到 Harness dsh skill install ./安装后再运行dsh skill list确认然后新建会话测试。7.4 一个实用示例批量文档整理 Skill如果团队里经常需要把零散的技术笔记整理成统一格式的周报可以做一个weekly-reportSkill。它的参考文档里放一份周报模板脚本里放一个 Markdown 拼接脚本Agent 拿到原始笔记后先按模板生成周报再调用脚本把多份周报合并成一个总文件。这种 Skill 的好处是后续团队改模板时只需改 references 里的文件不需要改 Agent 逻辑。8. PPT Skill 实战让 Agent 自动产出演示文稿PPT 生成是 Agent Skill 社区里最常用的场景之一。社区里有很多现成方案其中一个比较流行的方法是使用 Hermes 辅助编写 PPT Skill。它可以读取用户的需求然后编排生成逻辑核心思路是通过python-pptx程序化地生成.pptx文件而不是让模型直接输出一段不可执行的描述。8.1 工作原理PPT Skill 的工作链路大致是这样的用户输入需求 - Agent 调用 PPT Skill - Skill 生成 python-pptx 脚本 - 脚本执行并输出 .pptx 文件 - Agent 校验文件生成结果这样做的好处很明显生成出来的 PPT 是真正可以打开的.pptx文件不是一段参考代码。而且脚本可以被反复修改改一次参数就能生成一版新 PPT非常适合批量制作培训课件、汇报模板。8.2 测试流程安装 PPT Skilldsh skill install ppt-generator新建 Agent 会话输入一个具体需求。例如生成一份关于 YOLO 算法讲解的 PPT共 10 页包含目标检测发展脉络、YOLO 核心思想、网络结构、训练流程和效果对比。等待 Agent 编写脚本并执行观察终端输出或 Web 面板日志。到输出目录检查生成的.pptx文件。8.3 预期结果与判断标准成功的判断标准只有一个目录下出现可正常打开的.pptx文件并且页数、标题层级和内容基本符合需求。如果脚本报错Agent 通常会尝试修复但有些错误需要人工介入常见的有python-pptx未安装执行pip install python-pptx。中文字体乱码脚本中需要指定系统已安装的中文字体例如 Windows 上使用微软雅黑。文本框溢出减少文字量或调整文本框的位置和字号。图片无法插入如果 PPT 需要配图先让 Agent 用 matplotlib 生成图表再插入演示文稿。8.4 效果优化建议首次跑通之后可以把风格要求写进 Skill 的 references 里例如页边距、标题字号、主色调。这样后续生成的 PPT 能保持统一风格不会每页长得都不一样。这个细节决定了 PPT Skill 是玩具还是生产力工具。9. UI 设计 Skill 实战UI-UX-Pro-Max 的规范化输出UI 设计是另一类高频场景。社区里讨论较多的ui-ux-pro-maxSkill核心价值在于把让大模型直接写页面升级成让大模型按设计规范写页面。尤其是政府/企业级界面对栅格、色彩、字体层级、组件间距都有明确要求随便让模型自由发挥很容易产出看似花哨但不实用的页面。9.1 这个 Skill 能做什么使用ui-ux-pro-maxSkill可以让 Agent 按照设计规范输出高保真 HTML/CSS 原型。典型输入包括政务服务系统的用户列表页要求包含搜索、筛选、分页、批量操作。企业内部后台管理系统的侧边栏和内容布局。Windows 风格列表页的 UI 设计。输出结果通常是一个可以浏览器打开预览的 HTML 文件后续设计师可以在这个基础上继续精修。这种先按规范出原型再人工精修的流程比从空白画布开始效率高很多。9.2 测试流程安装 Skilldsh skill install ui-ux-pro-max输入一个具体的设计需求例如生成一个 Windows 风格列表页 UI包含顶部导航、搜索区域、数据表格、分页器和批量操作按钮。Agent 会按照 Skill 中的设计规范生成 HTML 文件。用浏览器打开生成的 HTML 文件检查布局是否完整、样式是否符合预期。9.3 判断成功标准成功的标准包括页面布局完整、交互按钮可用、文字没有被截断、整体风格保持一致。如果页面结构混乱说明 Skill 的描述可能没有被正确触发或者 references 里的设计规范不够详细。可以在 Skill 目录里补充一份页面元素布局规范文档让模型在生成前先阅读规范再动手。9.4 合规提醒做 UI 设计 Skill 测试时如果涉及真实机构的界面必须注意不要使用未授权的企业 Logo、政府标志不要生成与真实系统完全一致的页面用于对外发布。Skill 输出的内容只适合作为内部原型参考正式落地前还需要设计团队和法务确认。10. 资源占用与性能观察DeepSeek Harness 这类 Agent 框架本身对硬件要求并不高。它本质上是 Node.js 进程主要工作是把用户请求转发给模型提供方再调度 Skill 脚本执行。普通办公电脑跑起来没有压力。真正的资源消耗点是下面几个地方LLM API 调用量每次任务都会消耗 Token生成 PPT 或 UI 的脚本编排过程会有多轮模型调用批量任务时 Token 消耗会很明显。python-pptx脚本执行生成 PPT 是 CPU 密集型任务页数多或插入大量图片时会占用较多内存。HTML/CSS 生成UI Skill 输出页面时由模型生成代码不消耗本地渲染资源浏览器预览时才占用内存。批量任务如果一次跑 50 份文档建议设置每份任务超时时间和重试次数避免某一任务卡死影响整批结果。观察运行状态时可以使用dsh log查看任务日志也可以在 Web 面板中查看当前任务队列。如果使用本地模型作为 Agent 执行提供方才需要额外关注显存占用如果使用云 API那么本机只关心内存和网络。11. 常见问题与排查方法把社区里反馈较多的问题整理成下面这个表方便遇到问题时直接对照。问题现象可能原因排查方式解决方案卡在pnpm dsh webNode 版本不匹配 / 依赖未装完 / 端口占用查看终端日志、node -v、检查端口升级 Node、删除node_modules重装、更换端口出现 the agent execution provider did not respond in timeAgent 执行提供方超时检查 API Key 和网络、查看 provider 日志降低上下文长度、增大超时时间、更换模型提供方Skill 不触发description描述不准确查看 skill 列表和触发日志重写description加入明确功能关键词生成的 PPT 打不开python-pptx版本问题或脚本报错查看脚本日志重新安装python-pptx检查脚本输出PPT 中文字体乱码脚本未指定中文字体打开文件检查字体属性脚本中指定系统已装中文字体UI 输出样式混乱Skill 未加载 / 设计规范不足检查 skill 列表、查看 references确认安装路径补充布局规范文档批量任务卡住单任务无超时 / 输出路径权限问题查看队列日志和文件目录权限增加超时和重试机制统一输出目录遇到问题时记住一个原则先看日志再改环境最后才怀疑 Skill 代码。大多数问题都是环境或配置造成的不是框架本身的 bug。12. 最佳实践与使用建议到这里DeepSeek Harness 的安装、Skill 安装、Skill 创建、PPT 和 UI 实战都讲完了。最后给几组工程化建议会让你后续用得更稳。第一次接触时不要直接跑大型批量任务。先用最小参数跑通一个 Skill确认输出正常再逐步扩大规模。保留一套最小可运行配置包括 Harness 的启动命令、模型 API 配置、常用 Skill 列表。这样换机器或者同事协作时能快速复现环境。模型文件、输入素材、输出结果要分目录管理。不要把 Agent 生成的临时文件和源素材混在一起否则批量任务一多产物定位会非常痛苦。批量任务一定要加日志和失败重试。建议给每次任务加一个唯一 ID任务日志里记录开始时间、结束时间、使用的模型和 Skill、输出文件路径。接口服务要限制访问范围如果 Harness 提供了 HTTP 接口建议绑定到127.0.0.1避免局域网内任意设备随意调用。涉及人脸、声音、版权素材、企业标志、政务界面时必须确认授权。这在 PPT 生成、UI 设计这两个场景里尤其重要。不管是自己写 Skill 还是安装社区 Skill都要定期审查脚本内容确保没有超出预期的危险操作。13. 总结与下一步DeepSeek Harness 最值得尝试的点是它的 Skill 机制让 Agent 从通用问答助手变成了可插拔的领域工具。装上 PPT Skill它就是你的演示文稿生产助手装上 UI 设计 Skill它就能按企业规范输出高保真原型。这套机制对个人开发者和团队都有实际落地价值。建议你先验证两件事第一能否用pnpm dsh web正常启动并完成一次模型对话第二能否安装一个现成 Skill并成功触发它。跑通这两步之后再动手写自己的 Skill。最容易踩的坑集中在环境版本不一致、Agent 执行提供方超时、以及中文字体三处。遇到问题不要慌按第十一节的排查表逐项对照即可。后续可以继续扩展的方向也不少把团队知识库做成一个检索型 Skill把测试报告生成流程做成标准 Skill让 QA 定期批量运行或者把 UI-UX-Pro-Max 的设计规范和你们公司的设计系统进一步绑定生成更贴合实际产品的页面。Skill 的维护成本并不高核心在于把规范沉淀成文档和脚本剩下的重复劳动可以逐步交给 Agent。