TaskListTool：列出任务

这个工具做什么

TaskListTool 用来查看当前任务列表的整体情况。
Claude Code 要做多步任务时，主线程经常需要靠它重新确认全局状态。

关键源码

tools/TaskListTool/TaskListTool.ts：

export const TaskListTool = buildTool({
  name: TASK_LIST_TOOL_NAME,
  searchHint: 'list all tasks',
  ...
})

核心逻辑是：

const allTasks = (await listTasks(taskListId)).filter(t => !t.metadata?._internal)

调用链

实现重点

它不仅返回任务列表，还会过滤已经 resolved 的阻塞项，让任务视图更接近“当前可行动状态”。

它和相邻工具的关系

• TaskGetTool：看单条
• TaskUpdateTool：改状态
• TaskStopTool：停止后台任务，不是停止任务记录本身