先分享一个近期很多朋友都在问的问题模型跑通了、Agent 框架也搭起来了但实际做 PPT、做 UI 设计、写日报的时候总觉得 Agent 不够“听话”能力边界也很难统一管理。大家提到的 DeepSeek Harness 和 Agent Skill恰好是解决这一整类问题的组合方案。本文会把 DeepSeek Harness 的安装、Agent Skill 的核心概念、skill 的创建与分享、PPT skill 和 UI 设计 skill 的实战思路一次讲清楚并且把安装过程中容易踩的坑一并列出来。1. 背景与核心概念1.1 DeepSeek Harness 是什么DeepSeek Harness 是一个围绕大模型 Agent 使用场景打造的工作台。通俗地讲它像一个“Agent 管理系统”把模型配置、工具调用、技能包、会话记录、插件管理都集中在一个界面里。对比直接写脚本调用大模型 APIHarness 这类工具更强调“可编排”和“可复用”你可以把一次完整的工作流拆成多个能力模块之后在不同项目里反复调用。常见应用场景包括本地管理多个大模型 Agent统一配置模型参数和提示词。组织和管理 Agent Skill让不同 Agent 复用同一套技能。通过插件中心扩展能力例如 PPT 生成、UI 设计规范生成、数据分析等。归档和回顾对话方便查看历史任务执行情况。需要注意的是DeepSeek Harness 目前迭代速度较快不同版本的安装方式、命令和界面布局可能有差异。本文以常见的本地部署方式为例重点讲思路和排错方法具体操作建议以你安装版本的官方文档为准。1.2 Agent Skill 是什么Agent Skill 可以理解成“给 Agent 装上的技能包”。一个 Skill 通常包含一段清晰的技能说明告诉 Agent 这个技能什么时候该被触发。输入参数定义例如标题、主题、页数、风格。可执行的逻辑可能是提示词模板也可能是 Python/Node.js 脚本。附带资源例如模板文件、示例图片、参考文档。举个例子你希望 Agent 能根据主题生成 PPT 大纲。你可以创建一个ppt_outline_skill里面写好 PPT 大纲生成的规则、结构模板和示例。之后只要告诉 Agent “帮我用 PPT skill 生成一份关于 AI 落地的大纲”Agent 就会自动匹配这个 skill并按照里面定义的结构来输出。1.3 Skill 与 Agent 的区别很多人会把 Skill 和 Agent 弄混这里做一个简单区分维度AgentSkill定位一个能够自主完成任务的执行体一个可复用的单项能力组成模型、提示词、工具、Skill 组合提示词模板、脚本、资源文件举例日报撰写 Agent、PPT 设计 Agent日报模板生成 Skill、PPT 大纲 Skill关系Agent 可以调用多个 SkillSkill 可以被多个 Agent 共享简单来说Agent 是“员工”Skill 是“员工掌握的技能”。一个员工可以会写日报、会做 PPT、会写代码一个 Agent 也可以挂载多个 Skill。在 DeepSeek Harness 中你可以先创建或安装 Skill再把这些 Skill 配置到具体的 Agent 中。1.4 Agent Skill 与 MCP 有什么区别MCPModel Context Protocol模型上下文协议是一种标准化的协议用来让大模型连接外部工具和数据源比如数据库、文件系统、第三方 API。而 Agent Skill 更偏向上层的能力封装。可以这样理解MCP 解决的是“模型怎么拿到外部数据和调用外部工具”的问题。Skill 解决的是“模型如何按照一套成熟的方法论完成任务”的问题。两者并不冲突。Skill 内部可以通过 MCP 连接工具也可以单纯依赖提示词和脚本。所以你在安装 Agent Skill 时不需要把它当成 MCP Server 来对待。优先看 Skill 的目录结构和说明文件只要符合 Harness 的规范就能直接使用。2. 环境准备与版本说明2.1 操作系统与运行环境DeepSeek Harness 的常见使用方式有三种桌面版、命令行版、Docker 版。无论哪种方式建议环境满足以下条件操作系统Windows 10/11、macOS 12、Ubuntu 20.04 均可。Node.js建议 18 或更高版本部分新功能需要较新的运行时。包管理器pnpm安装命令为npm install -g pnpm。Git用于克隆官方仓库或你的技能仓库。Docker可选如果你希望隔离运行环境可以使用 Docker 部署。版本说明不要盲目追求最新版。如果你的 Node.js 版本较老先升级 Node.js如果安装遇到依赖错误优先检查 Node.js 和 pnpm 版本是否匹配。2.2 初始化示例项目结构为了便于后续创建 Skill建议先建立一个工作区目录my-ai-workspace/ harness-data/ skills/ agents/ logs/其中skills目录专门存放你创建或下载的 Skillagents目录放 Agent 配置logs放运行日志。这样的目录结构可以让你在 DeepSeek Harness 里快速导入也能避免把不同项目混在一起。3. 安装 DeepSeek Harness 与启动3.1 获取 DeepSeek HarnessDeepSeek Harness 的获取方式主要有两种官方网站或 GitHub Releases 下载桌面版安装包。克隆官方仓库后使用 pnpm 本地运行。如果你处于内网环境或下载速度较慢建议优先使用 Git 克隆再切换镜像源安装依赖。整个安装流程中最常遇到的问题就是pnpm安装依赖时卡住下文会在常见问题章节单独说明。3.2 使用 pnpm 启动 Web 端在命令行中执行git clone https://github.com/你的仓库地址/deepseek-harness.git cd deepseek-harness pnpm install pnpm dsh web这里需要解释一下各步骤的作用git clone是把代码下载到本地。cd deepseek-harness进入项目目录。pnpm install安装项目依赖包括前端和后端运行所需的包。pnpm dsh web启动 Web 工作台。dsh是 DeepSeek Harness 常见的 CLI 缩写不同版本可能会有所不同。启动成功后终端通常会显示一个本地访问地址例如http://localhost:3000。打开浏览器访问该地址就能看到 Harness 的主界面。3.3 桌面版启动与工作区导入如果你使用的是桌面版安装完成后第一次启动需要指定工作区目录。建议直接选择你在 2.2 节创建的my-ai-workspace目录。工作区的作用是保存 Agent、Skill、对话记录和日志避免数据散落在系统各处。进入主界面后一般会有几个核心入口Agent 列表用于管理和启动 Agent。Skill 中心用于浏览已安装的 Skill。插件中心用于下载官方或社区插件。对话记录用于查看历史会话和归档。3.4 验证安装是否成功判断安装是否成功可以看三点Web 界面能正常打开且没有明显报错。左侧导航能看到 Agent、Skill、插件等菜单。在界面中创建一个测试 Agent能正常发起对话或调用模型。如果以上都正常说明 DeepSeek Harness 已经可以使用。这个阶段先不要急着配置复杂插件先跑通最小流程更重要。4. Agent Skill 基础结构与运行原理4.1 Skill 包的典型目录一个规范的 Agent Skill 通常长这样my-skill/ SKILL.md scripts/ assets/ README.md各文件职责如下SKILL.md技能描述文件是 Agent 判断何时调用该 Skill 的核心依据。scripts/存放可执行脚本比如 Python、JavaScript 脚本。assets/存放模板、图片、配置文件等静态资源。README.md面向人类开发者的说明文档方便其他人理解和使用。4.2 SKILL.md 元信息示例下面是一个简化版的SKILL.md示例目的是让 Agent 知道这个 Skill 的名称、用途和参数--- name: daily-report description: 根据今日工作内容生成结构化日报适用于研发、产品、运营等岗位。 version: 1.0.0 author: your-name tags: [report, daily, productivity] arguments: - name: work_content type: string description: 当天完成的工作内容可以写多条。 required: true --- # Daily Report Skill 当用户要求生成日报、日报总结、每日工作汇报时使用本技能。 ## 输出格式 - 今日完成 - 明日计划 - 风险与问题这个示例的作用很直观description和tags让 Agent 在遇到“写日报”类似请求时能联想到该 Skillarguments定义输入参数正文部分是给 Agent 的输出规则。实际使用中可以根据自己的需求扩展。4.3 Skill 的调用方式在 DeepSeek Harness 中Skill 的调用通常有两种方式自动匹配当用户输入的意图和SKILL.md中的描述匹配时Agent 自动加载该 Skill。手动指定在 Prompt 中显式提到技能名称例如“使用 daily-report skill 生成日报”。理解这一点很重要。如果你发现安装的 Skill 没有被触发优先检查SKILL.md里的description是否写得足够明确。描述越精确Agent 越容易在合适的场景下选中它。5. 实战创建并运行第一个 Skill下面我们创建一个“日报生成 Skill”完整走一遍创建、注册、测试的流程。5.1 创建 Skill 目录在my-ai-workspace/skills下创建目录mkdir -p my-ai-workspace/skills/daily-report cd my-ai-workspace/skills/daily-report mkdir scripts assets目录结构这样设计是为了把技能描述、脚本和静态资源分开保持项目整洁。5.2 编写 SKILL.md在daily-report目录下创建SKILL.md--- name: daily-report description: 根据用户输入的工作内容生成日报。当用户要求写日报、日报总结、每日汇报时使用。 version: 1.0.0 author: your-name tags: [daily-report, report] arguments: - name: work_content type: string description: 用户填写的今日工作内容 required: true --- # Daily Report ## 任务 根据用户提供的 work_content生成一篇简短的日报。 ## 输出结构 ### 今日完成 - 逐条列出完成事项 ### 明日计划 - 给出 2-3 条合理计划 ### 风险与问题 - 如果没有风险写“无”注意description中的关键词覆盖了“日报”“日报总结”“每日汇报”这能提升自动匹配准确率。5.3 编写辅助脚本为了使效果更稳定可以增加一个脚本用来对用户输入做简单格式化处理。在scripts目录下创建generate_daily_report.pyimport datetime import sys def main(): work_content sys.argv[1] if len(sys.argv) 1 else 暂无输入 today datetime.date.today().isoformat() report f# {today} 日报\n\n## 今日完成\n{work_content}\n\n## 明日计划\n- 继续跟进未完成事项\n- 整理今日文档\n\n## 风险与问题\n无 print(report) if __name__ __main__: main()这个脚本本身很简单但体现了 Skill 的一个重要思路不一定每个 Skill 都要写复杂代码能稳定产出结果即可。5.4 在 DeepSeek Harness 中注册 Skill进入 Harness 工作台找到 Skill 管理页选择“导入本地 Skill”然后选择my-ai-workspace/skills/daily-report目录。导入后在 Skill 列表中应该能看到daily-report。如果你使用命令行可以尝试以下形式dsh skill add ./skills/daily-report不同版本命令有差异具体以你安装版本的帮助命令为准。5.5 运行与验证创建一个新的 Agent在提示词中粘贴如下内容我今天完成了 1. 修复了登录模块的 Bug。 2. 完成订单列表接口联调。 请为我生成日报。如果 Skill 生效Agent 会按照SKILL.md中的输出结构生成日报而不是自由发挥。这一步验证的重点是Skill 是否被正确加载、输出格式是否统一。如果 Agent 没有自动使用该 Skill可以尝试在 Prompt 里显式指定“使用 daily-report skill”。6. 安装他人 Skill 与分享个人 Skill6.1 从本地目录导入从 GitHub 或其他渠道下载某个 Skill 到本地后回到 Harness 的 Skill 管理页选择“导入本地 Skill”选中对应的SKILL.md所在目录即可。导入后可以先在测试 Agent 中调用一次确认输出符合预期再正式投入使用。6.2 从插件中心安装DeepSeek Harness 的插件中心会收录一些常用 Skill比如 PPT 生成、UI 设计规范、代码审查等。安装方式通常是在插件中心搜索关键字点击“安装”然后在 Skill 列表中启用。需要提醒的是插件中心的 Skill 质量参差不齐。安装后一定要先查看 Skill 的文档确认它不会读取或上传你的敏感数据再在核心项目中大规模使用。6.3 分享个人 Skill 的正确姿势如果你想把自己的 Skill 分享给其他人建议按照以下步骤整理在仓库根目录放一个清晰的README.md说明 Skill 的用途、适用场景和快速开始方式。保留SKILL.md作为唯一入口并确保描述准确。不要把小工具脚本和 Skill 混在一个目录中保持结构单一。在SKILL.md中写清楚输入参数和输出格式降低使用门槛。尽量附带一个示例输出文件方便别人验证效果。分享到 GitHub 后你可以把仓库地址发给需要的人也可以把它提交到插件中心。个人分享 Skill 时命名尽量统一规范例如xxx-skill避免使用无意义的名称。7. PPT Skill 与 UI 设计 Skill 实战7.1 PPT Skill 设计思路很多人需要的“PPT Skill”并不是让 Agent 直接生成一份.pptx文件而是先让它生成结构化的大纲、页面文案和配图建议。这样在本地再用 Keynote、PowerPoint 或其它工具渲染可控性更高。一个 PPT Skill 的SKILL.md可以这样设计--- name: ppt-outline description: 根据主题生成PPT大纲包括封面、目录、章节页、总结页。 version: 1.0.0 author: your-name tags: [ppt, presentation, outline] arguments: - name: topic type: string description: PPT主题 required: true - name: pages type: integer description: 预期页数 required: false - name: style type: string description: 风格例如商务、学术、极简 required: false --- # PPT Outline Skill 当用户需要制作PPT、生成演示文稿大纲时使用。 ## 输出结构 1. 封面标题 2. 目录页 3. 每页标题与要点 4. 总结页 5. 配图建议实战中我建议你把“输出结构”写得再细一点例如每一页需要有几条要点、每页配图风格是什么。这样才能减少后续返工。7.2 UI 设计 Skill 设计思路UI 设计 Skill 的核心不是让 Agent 直接画图而是让它输出一套设计规范、页面布局建议、组件使用提示。比如当用户说“帮我设计一个登录页”时Skill 会输出页面布局Logo、输入框、按钮位置。色彩方案主色、辅助色、背景色。字体规范标题字号、正文字号。交互说明加载状态、错误提示、按钮禁用状态。这样 Agent 生成的内容可以被设计师直接用于确认方案也可以让开发同学按照规范进行前端实现。下面是一个简化的ui-design-skill的SKILL.md示例--- name: ui-design-guideline description: 生成UI设计规范适用于网页、移动端应用界面设计。 version: 1.0.0 author: your-name tags: [ui, design, prototype] arguments: - name: screen type: string description: 需要设计的页面名称 required: true - name: user_group type: string description: 目标用户群体 required: false --- # UI Design Guideline Skill 当用户需要设计页面、原型图、界面规范时使用。 ## 输出内容 1. 页面目标 2. 信息架构 3. 布局方案 4. 色彩与字体 5. 组件与状态7.3 组合多个 Skill 的流程单个 Skill 解决单一问题但实际工作中往往是多个 Skill 配合使用。例如在一个产品提案任务中用ppt-outlineSkill 生成 PPT 大纲。用ui-design-guidelineSkill 补充几个核心页面的 UI 设计规范。用daily-reportSkill 把当天进展整理成日报。在 DeepSeek Harness 中你可以在一个 Agent 的配置里同时挂载这三个 Skill。Agent 会根据用户输入的意图在合适的环节调用合适的 Skill。这种组合方式比把所有逻辑写进一个 Prompt 更清晰也更容易维护。8. 常见问题与排查思路下面整理了一些高频问题尤其是社区中反馈较多的安装和调用问题问题现象常见原因解决思路安装依赖时卡在pnpm dsh web或pnpm install网络问题导致依赖下载不完整或 Node/pnpm 版本不匹配使用镜像源重新安装升级 Node.js 和 pnpm删除node_modules后重装DeepSeek Harness 下载慢文件较大或网络波动使用 Git 克隆替代压缩包下载或配置代理合法网络环境下导入 Skill 后 Agent 没有调用SKILL.md的 description 写得模糊或 Skill 格式不标准重新编写 description加入更多触发词确认目录结构完整Agent 调用 Skill 报错脚本依赖缺失或参数没有正确传递在本地先运行脚本确认脚本本身无错误再检查 Skill 参数配置插件中心找不到某个 Skill插件源未更新或 Skill 还未上架使用“导入本地 Skill”方式手动安装启动桌面版后工作区为空未正确指定工作区目录在设置中重新导入工作区或手动创建目录后重启应用对话记录找不到归档位置归档目录配置在用户目录或工作区内部在设置中查看存储路径定期备份对应数据目录如果你第一次启动就遇到异常最有效的排查顺序是检查终端日志找到准确的报错关键字。确认 Node.js、pnpm、Harness 三者版本兼容。删除依赖目录并重新安装。在官方仓库 Issues 中搜索相同报错。如果是自建 Skill尝试最小化复现只保留一个最简单的 Skill。9. 最佳实践与工程建议9.1 Skill 命名与目录规范推荐使用kebab-case或snake_case命名 Skill例如daily-report、ppt-outline。目录结构保持一致方便脚本化和自动化处理。每个 Skill 必须包含SKILL.md不建议把多个 Skill 塞在同一个目录里。9.2 参数设计与校验在SKILL.md中定义参数时尽量指明类型、是否必填、默认值。这样 Agent 在调用前就能自我检查减少因缺少参数导致的运行错误。实际使用中也可以让脚本对缺失参数做兜底处理避免整个流程中断。9.3 环境隔离与安全边界DeepSeek Harness 支持 Docker 部署时应把 Harness 数据目录挂载到命名卷中方便备份。如果你创建的 Skill 需要读取本地文件或调用外部 API建议在 Skill 文档里明确权限说明并在 Harness 配置中限制 Skill 可访问的目录避免一个 Skill 误删整个工作区。9.4 日志与可观测性生产环境下建议定期查看运行日志尤其是 Skill 调用失败时的堆栈输出。日志可以包含Skill 名称、触发时间、输入参数摘要、输出结果状态。如果社区版没有很好的日志功能可以自己在脚本中把关键信息写入文件。9.5 版本管理与发布个人 Skill 建议用 Git 管理每个版本打一个 tag。更新SKILL.md中的version字段并在README.md中说明变更内容。这样别人使用时能看到版本演进也方便回滚。9.6 从项目早期就培养 Skill 意识很多开发者习惯把一次性 Prompt 写得又长又杂其实更好的方式是把那些固定流程沉淀成 Skill。比如你每次都要写“周报生成”“接口文档生成”“SQL 审查”那就把它们分别做成 Skill。长期下来你的 Agent 工作台会变成一个越来越强大的私有能力库。10. 总结与学习路线写到这里DeepSeek Harness 与 Agent Skill 的核心用法已经完整梳理了一遍。你可以先安装好 DeepSeek Harness跑通一个最简单的daily-reportSkill再尝试做一个 PPT outline Skill 或 UI design Skill。之后逐步把日常重复性工作拆解成 Skill让 Agent 真正用起来。如果你在安装或创建 Skill 时遇到新问题可以先从日志入手再检查SKILL.md的描述是否准确。个人推荐从最熟悉的场景开始比如日报、周报、会议纪要因为这些场景输入输出都很明确最容易做成高质量 Skill。等积累了几个 Skill 之后再尝试把多个 Skill 组合到一个 Agent 中实现更复杂的自动化工作流。希望这篇文章能帮你少走一些弯路。 DeepSeek Harness与Agent Skill实战：从安装到PPT和UI设计技能包
先分享一个近期很多朋友都在问的问题模型跑通了、Agent 框架也搭起来了但实际做 PPT、做 UI 设计、写日报的时候总觉得 Agent 不够“听话”能力边界也很难统一管理。大家提到的 DeepSeek Harness 和 Agent Skill恰好是解决这一整类问题的组合方案。本文会把 DeepSeek Harness 的安装、Agent Skill 的核心概念、skill 的创建与分享、PPT skill 和 UI 设计 skill 的实战思路一次讲清楚并且把安装过程中容易踩的坑一并列出来。1. 背景与核心概念1.1 DeepSeek Harness 是什么DeepSeek Harness 是一个围绕大模型 Agent 使用场景打造的工作台。通俗地讲它像一个“Agent 管理系统”把模型配置、工具调用、技能包、会话记录、插件管理都集中在一个界面里。对比直接写脚本调用大模型 APIHarness 这类工具更强调“可编排”和“可复用”你可以把一次完整的工作流拆成多个能力模块之后在不同项目里反复调用。常见应用场景包括本地管理多个大模型 Agent统一配置模型参数和提示词。组织和管理 Agent Skill让不同 Agent 复用同一套技能。通过插件中心扩展能力例如 PPT 生成、UI 设计规范生成、数据分析等。归档和回顾对话方便查看历史任务执行情况。需要注意的是DeepSeek Harness 目前迭代速度较快不同版本的安装方式、命令和界面布局可能有差异。本文以常见的本地部署方式为例重点讲思路和排错方法具体操作建议以你安装版本的官方文档为准。1.2 Agent Skill 是什么Agent Skill 可以理解成“给 Agent 装上的技能包”。一个 Skill 通常包含一段清晰的技能说明告诉 Agent 这个技能什么时候该被触发。输入参数定义例如标题、主题、页数、风格。可执行的逻辑可能是提示词模板也可能是 Python/Node.js 脚本。附带资源例如模板文件、示例图片、参考文档。举个例子你希望 Agent 能根据主题生成 PPT 大纲。你可以创建一个ppt_outline_skill里面写好 PPT 大纲生成的规则、结构模板和示例。之后只要告诉 Agent “帮我用 PPT skill 生成一份关于 AI 落地的大纲”Agent 就会自动匹配这个 skill并按照里面定义的结构来输出。1.3 Skill 与 Agent 的区别很多人会把 Skill 和 Agent 弄混这里做一个简单区分维度AgentSkill定位一个能够自主完成任务的执行体一个可复用的单项能力组成模型、提示词、工具、Skill 组合提示词模板、脚本、资源文件举例日报撰写 Agent、PPT 设计 Agent日报模板生成 Skill、PPT 大纲 Skill关系Agent 可以调用多个 SkillSkill 可以被多个 Agent 共享简单来说Agent 是“员工”Skill 是“员工掌握的技能”。一个员工可以会写日报、会做 PPT、会写代码一个 Agent 也可以挂载多个 Skill。在 DeepSeek Harness 中你可以先创建或安装 Skill再把这些 Skill 配置到具体的 Agent 中。1.4 Agent Skill 与 MCP 有什么区别MCPModel Context Protocol模型上下文协议是一种标准化的协议用来让大模型连接外部工具和数据源比如数据库、文件系统、第三方 API。而 Agent Skill 更偏向上层的能力封装。可以这样理解MCP 解决的是“模型怎么拿到外部数据和调用外部工具”的问题。Skill 解决的是“模型如何按照一套成熟的方法论完成任务”的问题。两者并不冲突。Skill 内部可以通过 MCP 连接工具也可以单纯依赖提示词和脚本。所以你在安装 Agent Skill 时不需要把它当成 MCP Server 来对待。优先看 Skill 的目录结构和说明文件只要符合 Harness 的规范就能直接使用。2. 环境准备与版本说明2.1 操作系统与运行环境DeepSeek Harness 的常见使用方式有三种桌面版、命令行版、Docker 版。无论哪种方式建议环境满足以下条件操作系统Windows 10/11、macOS 12、Ubuntu 20.04 均可。Node.js建议 18 或更高版本部分新功能需要较新的运行时。包管理器pnpm安装命令为npm install -g pnpm。Git用于克隆官方仓库或你的技能仓库。Docker可选如果你希望隔离运行环境可以使用 Docker 部署。版本说明不要盲目追求最新版。如果你的 Node.js 版本较老先升级 Node.js如果安装遇到依赖错误优先检查 Node.js 和 pnpm 版本是否匹配。2.2 初始化示例项目结构为了便于后续创建 Skill建议先建立一个工作区目录my-ai-workspace/ harness-data/ skills/ agents/ logs/其中skills目录专门存放你创建或下载的 Skillagents目录放 Agent 配置logs放运行日志。这样的目录结构可以让你在 DeepSeek Harness 里快速导入也能避免把不同项目混在一起。3. 安装 DeepSeek Harness 与启动3.1 获取 DeepSeek HarnessDeepSeek Harness 的获取方式主要有两种官方网站或 GitHub Releases 下载桌面版安装包。克隆官方仓库后使用 pnpm 本地运行。如果你处于内网环境或下载速度较慢建议优先使用 Git 克隆再切换镜像源安装依赖。整个安装流程中最常遇到的问题就是pnpm安装依赖时卡住下文会在常见问题章节单独说明。3.2 使用 pnpm 启动 Web 端在命令行中执行git clone https://github.com/你的仓库地址/deepseek-harness.git cd deepseek-harness pnpm install pnpm dsh web这里需要解释一下各步骤的作用git clone是把代码下载到本地。cd deepseek-harness进入项目目录。pnpm install安装项目依赖包括前端和后端运行所需的包。pnpm dsh web启动 Web 工作台。dsh是 DeepSeek Harness 常见的 CLI 缩写不同版本可能会有所不同。启动成功后终端通常会显示一个本地访问地址例如http://localhost:3000。打开浏览器访问该地址就能看到 Harness 的主界面。3.3 桌面版启动与工作区导入如果你使用的是桌面版安装完成后第一次启动需要指定工作区目录。建议直接选择你在 2.2 节创建的my-ai-workspace目录。工作区的作用是保存 Agent、Skill、对话记录和日志避免数据散落在系统各处。进入主界面后一般会有几个核心入口Agent 列表用于管理和启动 Agent。Skill 中心用于浏览已安装的 Skill。插件中心用于下载官方或社区插件。对话记录用于查看历史会话和归档。3.4 验证安装是否成功判断安装是否成功可以看三点Web 界面能正常打开且没有明显报错。左侧导航能看到 Agent、Skill、插件等菜单。在界面中创建一个测试 Agent能正常发起对话或调用模型。如果以上都正常说明 DeepSeek Harness 已经可以使用。这个阶段先不要急着配置复杂插件先跑通最小流程更重要。4. Agent Skill 基础结构与运行原理4.1 Skill 包的典型目录一个规范的 Agent Skill 通常长这样my-skill/ SKILL.md scripts/ assets/ README.md各文件职责如下SKILL.md技能描述文件是 Agent 判断何时调用该 Skill 的核心依据。scripts/存放可执行脚本比如 Python、JavaScript 脚本。assets/存放模板、图片、配置文件等静态资源。README.md面向人类开发者的说明文档方便其他人理解和使用。4.2 SKILL.md 元信息示例下面是一个简化版的SKILL.md示例目的是让 Agent 知道这个 Skill 的名称、用途和参数--- name: daily-report description: 根据今日工作内容生成结构化日报适用于研发、产品、运营等岗位。 version: 1.0.0 author: your-name tags: [report, daily, productivity] arguments: - name: work_content type: string description: 当天完成的工作内容可以写多条。 required: true --- # Daily Report Skill 当用户要求生成日报、日报总结、每日工作汇报时使用本技能。 ## 输出格式 - 今日完成 - 明日计划 - 风险与问题这个示例的作用很直观description和tags让 Agent 在遇到“写日报”类似请求时能联想到该 Skillarguments定义输入参数正文部分是给 Agent 的输出规则。实际使用中可以根据自己的需求扩展。4.3 Skill 的调用方式在 DeepSeek Harness 中Skill 的调用通常有两种方式自动匹配当用户输入的意图和SKILL.md中的描述匹配时Agent 自动加载该 Skill。手动指定在 Prompt 中显式提到技能名称例如“使用 daily-report skill 生成日报”。理解这一点很重要。如果你发现安装的 Skill 没有被触发优先检查SKILL.md里的description是否写得足够明确。描述越精确Agent 越容易在合适的场景下选中它。5. 实战创建并运行第一个 Skill下面我们创建一个“日报生成 Skill”完整走一遍创建、注册、测试的流程。5.1 创建 Skill 目录在my-ai-workspace/skills下创建目录mkdir -p my-ai-workspace/skills/daily-report cd my-ai-workspace/skills/daily-report mkdir scripts assets目录结构这样设计是为了把技能描述、脚本和静态资源分开保持项目整洁。5.2 编写 SKILL.md在daily-report目录下创建SKILL.md--- name: daily-report description: 根据用户输入的工作内容生成日报。当用户要求写日报、日报总结、每日汇报时使用。 version: 1.0.0 author: your-name tags: [daily-report, report] arguments: - name: work_content type: string description: 用户填写的今日工作内容 required: true --- # Daily Report ## 任务 根据用户提供的 work_content生成一篇简短的日报。 ## 输出结构 ### 今日完成 - 逐条列出完成事项 ### 明日计划 - 给出 2-3 条合理计划 ### 风险与问题 - 如果没有风险写“无”注意description中的关键词覆盖了“日报”“日报总结”“每日汇报”这能提升自动匹配准确率。5.3 编写辅助脚本为了使效果更稳定可以增加一个脚本用来对用户输入做简单格式化处理。在scripts目录下创建generate_daily_report.pyimport datetime import sys def main(): work_content sys.argv[1] if len(sys.argv) 1 else 暂无输入 today datetime.date.today().isoformat() report f# {today} 日报\n\n## 今日完成\n{work_content}\n\n## 明日计划\n- 继续跟进未完成事项\n- 整理今日文档\n\n## 风险与问题\n无 print(report) if __name__ __main__: main()这个脚本本身很简单但体现了 Skill 的一个重要思路不一定每个 Skill 都要写复杂代码能稳定产出结果即可。5.4 在 DeepSeek Harness 中注册 Skill进入 Harness 工作台找到 Skill 管理页选择“导入本地 Skill”然后选择my-ai-workspace/skills/daily-report目录。导入后在 Skill 列表中应该能看到daily-report。如果你使用命令行可以尝试以下形式dsh skill add ./skills/daily-report不同版本命令有差异具体以你安装版本的帮助命令为准。5.5 运行与验证创建一个新的 Agent在提示词中粘贴如下内容我今天完成了 1. 修复了登录模块的 Bug。 2. 完成订单列表接口联调。 请为我生成日报。如果 Skill 生效Agent 会按照SKILL.md中的输出结构生成日报而不是自由发挥。这一步验证的重点是Skill 是否被正确加载、输出格式是否统一。如果 Agent 没有自动使用该 Skill可以尝试在 Prompt 里显式指定“使用 daily-report skill”。6. 安装他人 Skill 与分享个人 Skill6.1 从本地目录导入从 GitHub 或其他渠道下载某个 Skill 到本地后回到 Harness 的 Skill 管理页选择“导入本地 Skill”选中对应的SKILL.md所在目录即可。导入后可以先在测试 Agent 中调用一次确认输出符合预期再正式投入使用。6.2 从插件中心安装DeepSeek Harness 的插件中心会收录一些常用 Skill比如 PPT 生成、UI 设计规范、代码审查等。安装方式通常是在插件中心搜索关键字点击“安装”然后在 Skill 列表中启用。需要提醒的是插件中心的 Skill 质量参差不齐。安装后一定要先查看 Skill 的文档确认它不会读取或上传你的敏感数据再在核心项目中大规模使用。6.3 分享个人 Skill 的正确姿势如果你想把自己的 Skill 分享给其他人建议按照以下步骤整理在仓库根目录放一个清晰的README.md说明 Skill 的用途、适用场景和快速开始方式。保留SKILL.md作为唯一入口并确保描述准确。不要把小工具脚本和 Skill 混在一个目录中保持结构单一。在SKILL.md中写清楚输入参数和输出格式降低使用门槛。尽量附带一个示例输出文件方便别人验证效果。分享到 GitHub 后你可以把仓库地址发给需要的人也可以把它提交到插件中心。个人分享 Skill 时命名尽量统一规范例如xxx-skill避免使用无意义的名称。7. PPT Skill 与 UI 设计 Skill 实战7.1 PPT Skill 设计思路很多人需要的“PPT Skill”并不是让 Agent 直接生成一份.pptx文件而是先让它生成结构化的大纲、页面文案和配图建议。这样在本地再用 Keynote、PowerPoint 或其它工具渲染可控性更高。一个 PPT Skill 的SKILL.md可以这样设计--- name: ppt-outline description: 根据主题生成PPT大纲包括封面、目录、章节页、总结页。 version: 1.0.0 author: your-name tags: [ppt, presentation, outline] arguments: - name: topic type: string description: PPT主题 required: true - name: pages type: integer description: 预期页数 required: false - name: style type: string description: 风格例如商务、学术、极简 required: false --- # PPT Outline Skill 当用户需要制作PPT、生成演示文稿大纲时使用。 ## 输出结构 1. 封面标题 2. 目录页 3. 每页标题与要点 4. 总结页 5. 配图建议实战中我建议你把“输出结构”写得再细一点例如每一页需要有几条要点、每页配图风格是什么。这样才能减少后续返工。7.2 UI 设计 Skill 设计思路UI 设计 Skill 的核心不是让 Agent 直接画图而是让它输出一套设计规范、页面布局建议、组件使用提示。比如当用户说“帮我设计一个登录页”时Skill 会输出页面布局Logo、输入框、按钮位置。色彩方案主色、辅助色、背景色。字体规范标题字号、正文字号。交互说明加载状态、错误提示、按钮禁用状态。这样 Agent 生成的内容可以被设计师直接用于确认方案也可以让开发同学按照规范进行前端实现。下面是一个简化的ui-design-skill的SKILL.md示例--- name: ui-design-guideline description: 生成UI设计规范适用于网页、移动端应用界面设计。 version: 1.0.0 author: your-name tags: [ui, design, prototype] arguments: - name: screen type: string description: 需要设计的页面名称 required: true - name: user_group type: string description: 目标用户群体 required: false --- # UI Design Guideline Skill 当用户需要设计页面、原型图、界面规范时使用。 ## 输出内容 1. 页面目标 2. 信息架构 3. 布局方案 4. 色彩与字体 5. 组件与状态7.3 组合多个 Skill 的流程单个 Skill 解决单一问题但实际工作中往往是多个 Skill 配合使用。例如在一个产品提案任务中用ppt-outlineSkill 生成 PPT 大纲。用ui-design-guidelineSkill 补充几个核心页面的 UI 设计规范。用daily-reportSkill 把当天进展整理成日报。在 DeepSeek Harness 中你可以在一个 Agent 的配置里同时挂载这三个 Skill。Agent 会根据用户输入的意图在合适的环节调用合适的 Skill。这种组合方式比把所有逻辑写进一个 Prompt 更清晰也更容易维护。8. 常见问题与排查思路下面整理了一些高频问题尤其是社区中反馈较多的安装和调用问题问题现象常见原因解决思路安装依赖时卡在pnpm dsh web或pnpm install网络问题导致依赖下载不完整或 Node/pnpm 版本不匹配使用镜像源重新安装升级 Node.js 和 pnpm删除node_modules后重装DeepSeek Harness 下载慢文件较大或网络波动使用 Git 克隆替代压缩包下载或配置代理合法网络环境下导入 Skill 后 Agent 没有调用SKILL.md的 description 写得模糊或 Skill 格式不标准重新编写 description加入更多触发词确认目录结构完整Agent 调用 Skill 报错脚本依赖缺失或参数没有正确传递在本地先运行脚本确认脚本本身无错误再检查 Skill 参数配置插件中心找不到某个 Skill插件源未更新或 Skill 还未上架使用“导入本地 Skill”方式手动安装启动桌面版后工作区为空未正确指定工作区目录在设置中重新导入工作区或手动创建目录后重启应用对话记录找不到归档位置归档目录配置在用户目录或工作区内部在设置中查看存储路径定期备份对应数据目录如果你第一次启动就遇到异常最有效的排查顺序是检查终端日志找到准确的报错关键字。确认 Node.js、pnpm、Harness 三者版本兼容。删除依赖目录并重新安装。在官方仓库 Issues 中搜索相同报错。如果是自建 Skill尝试最小化复现只保留一个最简单的 Skill。9. 最佳实践与工程建议9.1 Skill 命名与目录规范推荐使用kebab-case或snake_case命名 Skill例如daily-report、ppt-outline。目录结构保持一致方便脚本化和自动化处理。每个 Skill 必须包含SKILL.md不建议把多个 Skill 塞在同一个目录里。9.2 参数设计与校验在SKILL.md中定义参数时尽量指明类型、是否必填、默认值。这样 Agent 在调用前就能自我检查减少因缺少参数导致的运行错误。实际使用中也可以让脚本对缺失参数做兜底处理避免整个流程中断。9.3 环境隔离与安全边界DeepSeek Harness 支持 Docker 部署时应把 Harness 数据目录挂载到命名卷中方便备份。如果你创建的 Skill 需要读取本地文件或调用外部 API建议在 Skill 文档里明确权限说明并在 Harness 配置中限制 Skill 可访问的目录避免一个 Skill 误删整个工作区。9.4 日志与可观测性生产环境下建议定期查看运行日志尤其是 Skill 调用失败时的堆栈输出。日志可以包含Skill 名称、触发时间、输入参数摘要、输出结果状态。如果社区版没有很好的日志功能可以自己在脚本中把关键信息写入文件。9.5 版本管理与发布个人 Skill 建议用 Git 管理每个版本打一个 tag。更新SKILL.md中的version字段并在README.md中说明变更内容。这样别人使用时能看到版本演进也方便回滚。9.6 从项目早期就培养 Skill 意识很多开发者习惯把一次性 Prompt 写得又长又杂其实更好的方式是把那些固定流程沉淀成 Skill。比如你每次都要写“周报生成”“接口文档生成”“SQL 审查”那就把它们分别做成 Skill。长期下来你的 Agent 工作台会变成一个越来越强大的私有能力库。10. 总结与学习路线写到这里DeepSeek Harness 与 Agent Skill 的核心用法已经完整梳理了一遍。你可以先安装好 DeepSeek Harness跑通一个最简单的daily-reportSkill再尝试做一个 PPT outline Skill 或 UI design Skill。之后逐步把日常重复性工作拆解成 Skill让 Agent 真正用起来。如果你在安装或创建 Skill 时遇到新问题可以先从日志入手再检查SKILL.md的描述是否准确。个人推荐从最熟悉的场景开始比如日报、周报、会议纪要因为这些场景输入输出都很明确最容易做成高质量 Skill。等积累了几个 Skill 之后再尝试把多个 Skill 组合到一个 Agent 中实现更复杂的自动化工作流。希望这篇文章能帮你少走一些弯路。