# 原子任务模板

用于把用户确认后的方案交给执行 Agent。一次只写一个任务。

```text
【一、任务背景与目标】

说明当前问题是什么、为什么要改、希望达到什么效果。

【二、修改范围】

只允许修改：
- path/to/file-a
- path/to/file-b

不要修改：
- path/to/unrelated-file
- 数据文件 / 样式文件 / 配置文件 / 文档，除非本任务明确要求

【三、具体修改要求】

1. 明确第一项修改，尽量精确到函数名、变量名、组件名、字段名或数据 ID。
2. 明确第二项修改。
3. 明确兼容旧数据、旧路径或异常输入的要求。

【四、限制与注意事项】

1. 不要重构无关代码。
2. 不要扩大修改范围。
3. 不要顺手处理技术债。
4. 不要改变已有用户路径，除非任务明确要求。
5. 如果发现任务外问题，只记录，不要修改。

【五、验收标准】

1. 验收点 1。
2. 验收点 2。
3. 涉及 UI / 交互 / 状态恢复 / 外部系统时，列出真实环境验证路径。

【六、自测命令或检查方式】

根据项目类型填写，例如：
- 语法检查
- 单元测试
- 数据校验脚本
- 构建命令
- 手动检查路径

【七、输出要求】

完成后只输出：
1. 修改文件列表
2. 关键改动摘要
3. 自测结果
4. 风险点
5. 是否修改了禁止修改的范围
6. 建议的人工验证路径

不要贴完整大文件内容。
```

## 写任务单的检查项

| 检查项 | 标准 |
|---|---|
| 是否原子 | 一个任务只解决一个问题 |
| 路径是否明确 | 精确到文件、函数、组件或字段 |
| 禁止范围是否明确 | 写清楚不要改什么 |
| 验收是否可操作 | 能人工复现或检查 |
| 输出是否低成本 | 执行 Agent 返回摘要，不贴大文件 |
| 风险是否可控 | diff 过大则拆分 |

## 反例

不要写：

```text
帮我优化一下这个页面。
```

可以改成：

```text
只修改 path/to/page.css 中 .submit-button 的样式，让按钮在禁用态降低透明度；不要修改 JS、HTML 和其他样式选择器。
```

不要写：

```text
看看这个 bug 怎么修最好。
```

可以改成：

```text
只检查 path/to/file.js 中 calculateTotal() 的空值处理，修复 items 为空数组时返回 NaN 的问题；不要修改调用方。
```