DeepSeek Harness 第一条任务怎么写:官方示例的四要素、中英模板与先总结后修改
DeepSeek Harness 官方 Quickstart 只给了一句首条任务:「Summarize this repository and identify its main packages.」 这句话短,但不是随手写的:它限定了对象、动作、范围和产出,agent 能据此判断什么算完成(来源)。第一条任务写得好不好,直接影响你能否把「配置问题」和「模型能力问题」分开。
DeepSeek Harness 官方示例到底在说什么
这句话做了三件事:让 agent 看当前仓库、做总结、指出主要包。 它没有要求改文件,也没有要求跑测试,属于典型的只读任务。对第一次使用的人来说,只读任务是最合适的:失败时你能确定问题在配置或读取,而不是在修改质量。(来源)
官方同时说明,agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划,按当前权限策略需要审批的操作会先询问你(来源)。这意味着第一条任务其实可以很复杂,但第一条不建议复杂,因为复杂任务会把多个变量混在一起。
把官方示例当成模板,而不是唯一答案。它的价值不在英文措辞,而在结构:先限定看哪里,再限定做什么,最后限定输出什么。你换成中文、换成自己的项目,只要结构不变,任务就仍然清晰。
如果英文读起来不顺,不必硬背原句。把「this repository」换成「当前仓库」、「Summarize」换成「总结」、「main packages」换成「主要包」,句子仍然成立。关键是不要把这些限定词省掉。
DeepSeek Harness 把一句话拆成四要素
把官方示例拆开,可以看到对象、动作、范围、产出四个部分。 这不是官方术语,而是一个便于检查的描述框架(来源):
| 要素 | 官方示例里的对应 | 作用 | 缺了会怎样 |
|---|---|---|---|
| 对象 | this repository | 告诉 agent 对什么动手 | 它可能泛泛而谈,或去读无关目录 |
| 动作 | Summarize | 告诉它做什么 | 它可能只描述目录,不给结论 |
| 范围 | main packages | 限定重点 | 它可能把每个文件都讲一遍 |
| 产出 | identify ... packages | 定义什么算完成 | 它可能停在半路,或反复追问 |
四要素不要求写成四句话。官方示例只用一句话就装下了四件事,靠的是「this repository」「Summarize」「main packages」这些限定词。写中文任务时,同样可以用一句话完成,只要四个部分都在。
检查方法:写完一句话后,依次问「对什么」「做什么」「重点是什么」「交什么」。四问都有答案,任务就够清楚了;有一问答不上来,agent 大概率也会在这里卡住。
DeepSeek Harness 缺一个要素会怎样
缺不同要素,失败表现不同;根据表现反推缺了什么,比反复改写更快。 常见对应关系如下(来源):
- 缺对象 — 回复不引用任何具体文件,像是在做通用科普;或者 agent 反问你「要看哪个目录」。
- 缺动作 — 回复列了一堆目录和文件名,但没有总结、比较或结论;它不知道你要的是「看」还是「判断」。
- 缺范围 — 回复很长,把依赖、脚本、文档全讲一遍;重点被淹没,你看不出它是否真的理解了项目。
- 缺产出 — 回复停在中途,或者反复确认「这样可以吗」;它没有一个明确的完成条件。
这四种表现也能反过来用:如果你看到某一种,不要急着换模型,先检查任务描述缺了哪一要素。很多「模型不行」其实是「任务没说清」。
两个要素同时缺时,先补对象和产出。对象决定它看哪里,产出决定它什么时候停;动作和范围可以在第一轮回复后再收窄。这个顺序的好处是,即使第一次回复不完美,你也能看出它有没有真的读到工作区。
还要注意,四要素是下限,不是上限。你可以加约束,例如「不要修改文件」「只读前两层目录」「用表格列出」。但第一条任务不建议加太多,约束越多,越难判断失败是哪条约束造成的。
DeepSeek Harness 三个可复用改写例
同一个四要素框架,可以套到不同首条任务上。 下面三个例子都保持只读,适合第一次使用(来源):
- 仓库总结 — 「总结当前仓库的用途,列出主要包和它们各自负责什么,不要修改文件。」
- 对象:当前仓库;动作:总结;范围:主要包;产出:用途 + 包职责。
- 单文件解释 — 「解释
src/index.ts的入口逻辑,按执行顺序列出它调用的三个关键模块,不要改代码。」- 对象:单个文件;动作:解释;范围:入口逻辑与三个模块;产出:按顺序的说明。
- 失败测试定位 — 「找出当前仓库里失败的测试,列出失败用例、报错摘要和最可能的源文件,先不要修复。」
- 对象:测试;动作:定位;范围:失败用例与源文件;产出:清单 + 判断。
三个例子的共同点是「先只读」。这不是保守,而是把第一条任务当成一次链路验证:能读到文件、能给出结论、能按你要求的形式输出,就说明模型和工作区都通了。等这条链路稳定,再让它修改文件。
改写时不要把多个目标塞进一条任务。比如「总结仓库并修复所有测试」同时包含只读和写入,失败时你无法判断是读不到、改错了,还是测试本身有问题。第一条任务只做一件事。
DeepSeek Harness 中英模板与先总结后修改
中英模板可以共用同一结构,区别只在措辞,不在要素。 下面是两个可直接套用的模板(来源):
中文模板:
请阅读当前工作区里的 {对象},{动作},重点看 {范围},最后用 {产出形式} 给出结果;先不要修改任何文件。
英文模板:
Read {object} in the current workspace, {action}, focusing on {scope}, and return {output}. Do not modify any files yet.
两个模板都保留了「先不要修改」这一句。它的作用不是限制 agent 的能力,而是把第一条任务限定在只读范围,方便你在出现问题时判断是读取失败还是修改失败。
为什么先总结后修改?因为总结任务的失败面更小:读不到文件、工作区没选中、模型没配好,都会在总结阶段暴露;而修改任务还会额外引入「改得对不对」这一层。先把前一层验证掉,再进入修改,排查成本会低很多。
总结结果也要可核对。如果回复里没有出现你点名的文件、目录或包名,先不要进入修改阶段;先让它补上引用,或者把范围缩小到一个文件。可核对的总结比漂亮的概述更有用。
DeepSeek Harness 怎么判断第一条任务写对了
判断标准不是「回复看起来不错」,而是「回复是否覆盖了你点名的四要素」。 按下面四条核对(来源):
- 对象对 — 回复引用了你指定的仓库、文件或目录,而不是泛泛而谈;
- 动作对 — 它做了总结/解释/定位,而不是只列文件名;
- 范围对 — 它聚焦在你点名的重点上,没有把无关内容全铺开;
- 产出一致 — 它给出的形式与你要求的一致,例如清单、表格、按顺序的说明。
四条都过,说明第一条任务写对了,也说明模型、工作区、执行链路都可用。若有一条不过,先改任务描述,不要急着换模型;任务描述是最便宜、最容易排除的变量。
第一条任务跑通后,再考虑让它修改文件、运行命令或使用插件。四道门的整体判据见《DeepSeek Harness 快速入门四道门》;启动到首条消息的完整路径见《dsh web 第一次打开的五分钟》。
常见问题
DeepSeek Harness 可以这样。DeepSeek Harness 官方 Quickstart 的示例是 Summarize this repository and identify its main packages. 它已经包含对象、动作、范围和产出;换成中文时保持这四件事不丢即可。
DeepSeek Harness 里,先总结能把模型是否可用、工作区是否生效、文件是否读到分开验证;直接改代码会把配置问题和修改质量问题混在一起。第一条任务先做只读总结,确认链路通了再让它动手。
DeepSeek Harness 的第一条任务太宽时,回复通常泛泛而谈、不引用具体文件,或者反复追问你想做什么。缺少对象和产出约束时,agent 无法判断什么算完成。
DeepSeek Harness 里,不需要。DeepSeek Harness 的第一条任务只要把对象、动作、范围、产出说清即可,一句话也能成立。过长会把多个目标混在一起,反而不容易判断哪一步失败。
相关术语
- 首条任务
- 首条任务是 DeepSeek Harness 新会话里发送的第一条请求,用来同时验证模型、工作区和执行链路是否可用。— DeepSeek Harness 官方文档 - 使用 Web UI
- 任务四要素
- 任务四要素是把一条任务描述拆成对象、动作、范围、产出四个部分,用来判断描述是否足够让 agent 执行。— DeepSeek Harness 官方文档 - 使用 Web UI
- 只读任务
- 只读任务是只要求 agent 读取、总结或解释,不要求修改文件的任务;适合作为首条任务,便于把配置问题和修改质量问题分开。— DeepSeek Harness 官方文档 - 使用 Web UI
- 产出约束
- 产出约束是任务描述里对结果形式的要求,例如列出主要包、给出文件路径、用表格对比;它决定 agent 什么时候可以停下。— DeepSeek Harness 官方文档 - 使用 Web UI
来源
- DeepSeek Harness 官方文档 - 使用 Web UI· deepseek-harness
- DeepSeek Harness 官方文档 - 配置模型· deepseek-harness