第7章 提问:把愿望变成可验收任务
第 7 节 / 共 13 节
课程:DeepSeek Harness 实战课
这是全课最重要的一章。Agent 的效果,80% 取决于任务描述的质量。
同一个模型,任务描述差一句,结果差一个量级。这一章给出五要素、万能模板、十个句式和审阅清单。
五要素
- 目标:要什么结果,不是“做什么动作”;
- 上下文:相关文件、数据、背景、参考样例;
- 约束:不能碰什么、必须用什么、时间/格式/权限;
- 验收:怎么判断做完了、做对了;
- 交付:输出到哪里、什么格式、要不要说明假设。
反例:
帮我优化一下这个项目。
优化什么?性能、可读性、SEO、还是 UI?改哪些文件?允许改数据库吗?怎么算成功?
正例:
目标:把 /static 章节页的 LCP 降到 2.5s 以内(移动端 4G)。
上下文:@src/main/resources/html/study.html,@src/main/java/cn/jssp/html/HTMLGenerator.java。
约束:
- 不改页面信息架构;
- 不引入新的前端框架;
- 所有改动必须能回滚;
- 先只读分析,给我方案,不要直接改。
验收:
- 给出改动前后的 Lighthouse 数据;
- 列出每个改动的文件与原因;
- 说明可能的副作用。
交付:一份 markdown 报告 + 待确认的 diff。
万能模板
【目标】
(一句话说清交付物和成功标准)
【背景】
(项目是什么、现在什么状态、为什么要做)
【上下文】
(相关文件/目录/数据/链接;用 @ 或路径列出)
【约束】
(不能改什么、必须遵守什么、权限边界、时间/成本)
【验收】
(可测的标准:测试通过、指标、对照样例、人工检查点)
【交付】
(输出格式、存放位置、需要附带的说明)
【流程】
先复述你的理解 → 给计划 → 我确认后执行 → 每步报告结果。
十个实用句式
- 先复述:先不要动手,用你自己的话复述目标和验收标准,标出不确定的地方。
- 先只读:第一步只读定位、给证据;第二步给方案;第三步等我确认后再改。
- 要证据:每个结论附文件路径和行号;没有证据的推测标注“推测”。
- 限范围:只允许修改 src/ 下的文件;不要动数据库、不要改依赖版本。
- 最小改动:优先最小可行修改;不要顺手重构无关代码;扩大范围先说明理由。
- 可回滚:改之前确认 git 工作区干净;给我每一步的回滚命令。
- 自检:完成后自己检查是否满足每条验收标准、是否引入新报错、是否有未处理边界。
- 要对比:给我两个方案,列优缺点、成本、风险,并给出推荐;不要直接选。
- 要解释:用给新人讲的方式解释改动,包括为什么这样改、为什么不那样改。
- 停止条件:连续两次尝试都失败就停止报告,不要无限重试。
任务粒度
太大:“把这个系统重写一遍” → 不可验收、不可回滚;太小:“把这一行缩进改成 4 空格” → 浪费上下文;合适:“把这个接口的响应时间从 6s 降到 1s 以内,先分析瓶颈,再给两个方案”。
经验法则:一个任务,一次会话,一个可验证的交付物。
迭代节奏
第 1 轮只读 + 计划;第 2 轮小范围修改 + 验证;第 3 轮补边界 + 回归;第 4 轮整理交付 + 记录。不要一次让它改 20 个文件,改得越多越难审。
审阅清单
它真的读了文件吗,引用路径对吗;改动是否只在允许范围内;有没有跑测试/构建,输出是什么;有没有顺手改无关代码;有没有引入新依赖/密钥/外链;失败路径和边界处理了吗;回滚方案清楚吗;解释和代码一致吗。
七个反模式
一句话许愿;多个目标混在一起;不给上下文;不说不能碰什么;只看结果不看过程;失败就骂模型;把密钥/隐私贴进对话。
本章练习
把上周一个模糊需求改写成五要素齐全的任务;用“先复述”句式让 Agent 复述,看它漏了什么;故意给一个“不能碰”的约束,观察是否遵守;把成功任务保存为模板。
《DeepSeek Harness 实战课》课程目录
面向应用者的 DeepSeek Harness 实战课:讲清 API、Agent、Harness 三者关系,带你安装 DSH、写出可验收任务、让 Agent 读文件改代码跑测试、接 MCP/插件、做定时任务,并划清安全边界