摘要:给 AI 派活,话怎么说决定返工几轮。本文给单兵开发者一份可抄的五段式任务书模板(目标 / 范围 / 完成定义 / 决策授权 / 交付要求),并用同一个周报 CLI 仓跑 3 任务 × 3 组对照:一句话派活与作文式 PRD 六场全部第一轮判挂(全量输出、自创表头、命令名对不上),五段式三场全部一次到位。返工后总账:一句话组单件合格 155 万 token,是五段式(81 万)的 1.9 倍;作文式 465 万、5.7 倍,还差一件未收敛。附机判口径与返工税明细。
本文要点(TL;DR)
你把需求丢给 AI:加个排行功能。二十分钟后它交付了,pnpm run check 全绿,测试齐全,交付说明写得像模像样——就是排的是全部项目而不是前五,还顺手加了一列百分比。你说「不是这个意思」,它答「那你没说」。返工一轮,又错一处;再返工,终于对了。一晚上陪它改三遍,根子只有一句:活是你派的,话没说全。
这不是「提示词技巧」问题,是交底结构缺失。上一篇的 AGENTS.md 管的是「每次进场都成立」的仓库规矩;而「这次要前五还是前三」「环比做不做百分比」「文件叫什么名」,只在这一单里成立——它们的家在任务书里。本文先给可抄的五段式模板,再用同一个周报 CLI 仓跑 9 场对照实验,回答一个问题:任务书的写法,到底值多少轮返工。
一、先给货:五段式任务书模板
模板五段:目标、范围、完成定义、决策授权、交付要求。下面是本篇实验里一次跑通的原件(示例仓 weekrep,top 排行任务),逐字可抄,把具体口径换成你的就行:
# 任务:给 weekrep 加 top 子命令(本周项目投入排行)
## 1 目标
周一晨会要口头同步各项目的投入情况。build 生成的报告太长,不适合直接贴群;
我想要一条命令,直接给出本周投入最多的项目排行。
## 2 范围
– 新增子命令 top,只做「本周项目投入排行」这一件事
– 不做导出、不加可选参数、不改动已有命令
– 代码放 src/commands/,照 build 的样子写;测试放 test/
## 3 完成定义(口径已钉死,逐条可验收)
– 跑法:`pnpm exec tsx src/cli.ts top`
– 统计本周(周定义见 AGENTS.md)各项目投入总时长,取前 5 名,按投入从多到少输出
– 每行一个项目,格式 `项目名:H:MM`(全角冒号;时长口径见




