> ## Documentation Index
> Fetch the complete documentation index at: https://aicoding.cscitech.top/llms.txt
> Use this file to discover all available pages before exploring further.

# 如何描述一个好任务

> 掌握目标、上下文、范围、限制和验收标准五段式任务写法

# 如何描述一个好任务

Claude Code 的结果质量很大程度取决于任务是否可执行。一个好任务不必很长，但要让它知道改什么、不要改什么、怎样算完成。

## 五段式结构

1. **目标**：希望用户或系统发生什么变化；
2. **上下文**：相关目录、入口、错误日志或约束；
3. **范围**：允许读取和修改哪些文件；
4. **限制**：不升级依赖、不改变公共接口等；
5. **验收**：具体测试、命令、截图或行为。

```text theme={null}
目标：修复未登录用户访问 /reports 时返回 500 的问题。
上下文：入口在 src/routes/reports.ts，已有测试在 tests/reports.test.ts。
范围：先只查看这两个目录，允许修改路由和测试。
限制：不要改变登录中间件的公共接口，不要引入新依赖。
验收：补充未登录用例，运行该测试文件，并说明错误响应码。
```

先让 Claude 读和解释，再批准计划，最后开放最小修改范围。加上“如果缺少信息，请先列出问题，不要猜测”，可以减少业务规则误判。