目标
明确要解决的用户或业务问题，而不只写“加一个功能”。
任务规格至少包含六块
范围
列出本次要改的页面、接口、数据和边界，不让任务无限扩大。
现状
说明现有代码、数据模型、接口或限制，避免 Agent 从错误假设开始。
约束
包含兼容性、权限、性能、隐私、第三方服务与不可改动部分。
验收
写成可以测试的条件：输入、操作、预期结果和异常处理。
不包含
明确本期不做什么，是控制 AI 任务规模最直接的方式。
可直接复制的 AI Coding Agent 任务规格模板
将方括号内容替换为你的项目事实。复杂需求按功能拆成多份独立任务，每份都可以单独验证。
# 开发任务：[任务名称]
## 目标
- 用户问题：[要解决什么]
- 成功结果：[用户完成什么动作后算成功]
## 本次范围
- 页面或模块：[具体路径/模块]
- 数据与接口：[需要读写什么]
- 交付物：[代码、测试、文档或截图]
## 当前现状
- 相关代码位置：[仓库路径或模块]
- 已有行为：[当前如何工作]
- 已知限制：[不能改动的接口、兼容要求、依赖]
## 实现约束
- 权限与安全：
- 错误和空状态：
- 性能与兼容：
## 验收标准
1. [输入/前置条件] 时，[操作] 后应看到 [明确结果]。
2. [异常条件] 时，应 [明确提示或降级行为]。
3. [测试或检查命令] 必须通过。
## 本期不包含
- [明确排除的功能和重构]
不要把密钥、真实用户数据或未授权的内部信息放进任务规格。涉及支付、账号、权限和数据迁移时，先由负责人确认边界，再交给 Agent 实现。
常见问题
给 AI Coding Agent 需要写完整 PRD 吗？
不一定，但至少需要目标、范围、现状、关键约束、验收和不包含事项。复杂项目再拆成可独立验证的小任务。
为什么 AI Coding Agent 容易做偏？
通常是任务只有目标没有边界，缺少代码与接口上下文，或者没有可验证的验收条件。
Codex、Claude Code、Cursor 的任务规格能通用吗？
核心规格可以通用；不同工具的命令、规则文件和权限配置，再按团队环境补充。