第一章　先搞懂 skill：怎么装、怎么用

为什么先讲“怎么装”

很多人在 DeepSeek Harness 里遇到的第一个卡点，不是“怎么写技能”，而是“为什么我装的技能模型根本看不到”。根因几乎都落在三处：装错了目录层级、description 写得含糊、或者压根没走对加载路径。本章先把地基打牢——先说清 skill 到底是什么，再讲清它该放进哪一层目录、三种装法分别怎么落地、装完怎么验证、最后怎么卸载和更新。

四个认知台阶

本章四节是按“先懂概念，再会操作”的顺序排的，建议顺着读：

台阶 小节 你要建立的认知
是什么 1.1 skill 是什么 skill 是按需加载的指令包，不是插件也不是工具
放哪 1.2 装到哪个目录 六层优先级决定同名技能谁能赢
怎么装 1.3 三种装法与装后验证 目录包、扁平文件、组合包各有适用场景
怎么管 1.4 卸载、更新与重名裁决 增删改与重名谁赢的明确规则

一个贯穿全章的心法

官方对 skill 的定位只有一句话：可选的指令而非会话事件。把它记住，后面所有规则都有出处——技能不新建进程、不打开端口、也不在后台自行触发，只在你或模型选中它时，把一段 Markdown 文本送进上下文。

正因如此，模型目录里只展示 name 与 description 两条摘要，而 description 写得好不好，直接决定这个技能“装了到底有没有用”。这是新手“装了没反应”的头号原因。

两个最常见的误区

  1. 把技能当插件装。 插件是代码模块，启动时随组合装载；技能是纯文本指令，按任务加载。混为一谈会导致你以为“装了就该有函数可调”，结果模型根本没选中它。
  2. description 只写功能不写触发条件。 例如“Excel 处理技能”——模型知道它能干什么，却不知道什么时候该找它，于是永远不触发。

给新手的两条建议

  1. 先装一个你已经理解其正文逻辑的简单技能，跑通“装上 → 模型选中 → 看到效果”这条完整链路，再谈精雕细琢。
  2. 把 description 当成唯一广告位来写：说清“什么时候该用”，而不是“里面有什么”。

延伸阅读