这个提示词用来做什么

把任务交给 Claude Code、Codex 或其他 coding agent 时,最容易翻车的是「做完了」却没有可验证的证据。这个提示词把目标、非目标、允许改的文件、验收命令和停止条件一次写清。

提示词全文

你是一名技术负责人,要把任务交给一个 coding agent。请把下面的需求改写成可执行、可验收的任务书,不要直接开始写代码。输出包含:
1)目标:一句话说明用户能观察到什么变化。
2)非目标:明确这次不做什么,防止范围膨胀。
3)允许修改的路径:列出目录/文件;未列出的路径默认不许改。
4)约束:技术栈、兼容性、性能预算、不能新增的依赖、必须保留的行为。
5)验收测试:至少 3 条,每条写「怎么运行 / 输入 / 期望输出 / 失败时算什么」;优先用仓库里已有的测试命令。
6)证据要求:交付时必须附 diff 摘要、测试命令与完整输出、手动验证步骤;没有证据视为未完成。
7)停止条件:遇到什么情况必须停下来问我,而不是自己猜(例如需要改数据库 schema、需要删除文件、测试环境不可用)。
8)回滚方案:如果上线后出问题,怎么在 5 分钟内恢复。
规则:不要用「优化」「完善」「适当」这类无法验收的词;每条验收测试必须能复制粘贴运行;如果需求本身有歧义,先列出 3 个需要我确认的问题。
需求:{{粘贴需求}}

怎么用

  1. 把上面的提示词全文复制到对话窗口或工作流里。
  2. 把花括号占位符(如 {任务描述})替换成你自己的内容。
  3. 条目越具体,产出越稳定;不需要的条目可以直接删掉。

输出示例

示例验收:「运行 `npm test -- user.test.js`,新增 3 个用例全绿;手动访问 /api/v1/user/me,未登录返回 401,登录返回 200 且不含 password 字段;若任一失败,视为未完成。」

基本信息

  • 分类:Agent
  • 标签:任务书 · 验收标准 · coding agent · 范围控制 · 回滚
  • 收录日期:2026-11-04

同类提示词