欢迎光临
我们一直在努力

怎么给 AI 派活:一份可抄的任务书模板,让它一次写对(附对照实验数据)

摘要:给 AI 派活,话怎么说决定返工几轮。本文给单兵开发者一份可抄的五段式任务书模板(目标 / 范围 / 完成定义 / 决策授权 / 交付要求),并用同一个周报 CLI 仓跑 3 任务 × 3 组对照:一句话派活与作文式 PRD 六场全部第一轮判挂(全量输出、自创表头、命令名对不上),五段式三场全部一次到位。返工后总账:一句话组单件合格 155 万 token,是五段式(81 万)的 1.9 倍;作文式 465 万、5.7 倍,还差一件未收敛。附机判口径与返工税明细。

本文要点(TL;DR)

  • 同一仓库、同一份 AGENTS.md、同样三件事:五段式任务书三场全部一次到位(610 / 525 / 393 秒),一句话与作文式六场全部第一轮判挂——任务书写法是九场实验里唯一的人为变量;
  • 一句话派活,AI 替你做产品决策:top 排行它全量输出 7 个项目还带编号;CSV 导出自创 7 列表头;环比只给时长丢掉条数——没钉的口径就是让它抽签,猜错了就得用返工轮买单;
  • 作文式更冤:591 字 PRD 比 397 字五段式长 49%,却连「本周」和命令名都没写——AI 统计了全仓 21 条日志、自加百分比列,t5 的命令起名 compare,返工一轮后仍死在名字上未收敛;
  • 返工税实测:返工意见恰好就是五段式口径的口语版,晚说一遍多付一倍——一句话组单件合格 155 万 token(五段式 81 万的 1.9 倍),作文式 465 万(5.7 倍);
  • 判别法一条:每个任务都成立的进 AGENTS.md(写一次、每次生效),只这一单成立的进任务书(五段写清、交付作废);同一句口径要写第二次,就升格进说明书。
  • 你把需求丢给 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`(全角冒号;时长口径见

    赞(0)
    未经允许不得转载:171主机测评 » 怎么给 AI 派活:一份可抄的任务书模板,让它一次写对(附对照实验数据)
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址