claude-code/docs/tools/task-management.mdx

---
title: "任务管理"
description: "让 AI 的工作有条理、可追踪"
---

{/* 本章目标：介绍任务系统如何帮助 AI 和用户保持同步 */}

## 为什么需要任务管理

当你给 AI 一个复杂需求（比如"重构整个认证模块"），它可能需要执行几十个步骤。没有任务管理，用户只能被动等待，不知道 AI 做到哪了、还要做什么。

## 任务系统的运作方式

AI 可以自主创建和管理任务列表：

<Steps>
  <Step title="分解任务">
    AI 把大需求拆解为多个小任务，创建到任务列表
  </Step>
  <Step title="标记进度">
    开始某个任务时标记为"进行中"，完成后标记为"已完成"
  </Step>
  <Step title="依赖管理">
    任务之间可以设定依赖关系——"任务 B 必须等任务 A 完成后才能开始"
  </Step>
  <Step title="用户可见">
    用户随时可以查看任务列表，了解整体进度
  </Step>
</Steps>

## 任务与 Plan Mode 的配合

面对复杂任务，AI 可以先进入**计划模式**：

1. AI 进入计划模式 → 只允许使用搜索和阅读类工具（不能修改文件）
2. AI 探索代码库、理解现有架构
3. AI 制定实施计划，创建任务列表
4. 用户审批计划
5. AI 退出计划模式，按计划逐项执行

这种"先规划、后执行"的方式避免了 AI 盲目行动造成的返工。

## 状态展示

终端 UI 中，任务列表会实时更新：

- 待办任务灰色显示
- 进行中的任务有旋转动画
- 已完成的任务打勾标记
- 被阻塞的任务标注依赖项