TaskGetTool：读取任务

发表于2026-07-07|更新于2026-06-23|Claude Code

|浏览量:

TaskGetTool：读取任务

它是任务系统里的单点查询入口

TaskGetTool 的职责很纯粹：按 ID 读取单个任务。
但它的重要性在于，它让主线程可以在复杂任务流里随时检查某个任务当前的真实状态，而不是只看 UI 记忆。

关键源码

1	const task = await getTask(taskListId, taskId)

返回内容除了标题和状态，还包括：

description
blocks
blockedBy

这说明它查询的不是“列表项”，而是带依赖关系的任务对象。

调用链

小结

TaskGetTool 让任务系统具备了正式对象查询能力，而不是只能看列表摘要。

文章作者: xhj

文章链接: https://hzhzxfs.github.io/2026/07/07/30__TaskGetTool%EF%BC%9A%E8%AF%BB%E5%8F%96%E4%BB%BB%E5%8A%A1/

版权声明: 本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 xhj的博客！

相关推荐

common-workflows

常见工作流程使用 Claude Code 探索代码库、修复错误、重构、测试和其他日常任务的分步指南。本页收集了日常开发的简短工作流程。有关提示和上下文管理的更高级指导，请参阅最佳实践。本页涵盖：提示工作流程，用于探索代码、修复错误、重构、测试、PR 和文档恢复以前的对话，以便任务可以跨越多个会话使用 worktrees 运行并行会话，以便并发编辑不会冲突编辑前规划，以在更改接触磁盘前审查更改将研究委派给 subagents，以保持主上下文清洁将 Claude 管道输入脚本，用于 CI 和批处理提示工作流程这些是日常任务的提示模式，如探索陌生代码、调试、重构、编写测试和创建 PR。每个都可以在任何 Claude Code 界面中工作；根据您的项目调整措辞。理解新的代码库有关在 monorepo 或大型代码库中配置 Claude Code 的信息，请参阅 Monorepos 和大型存储库。快速获取代码库概览假设您刚加入一个新项目，需要快速了解其结构。 theme1cd /path/to/project theme1...

ListMcpResourcesTool：列出 MCP 资源

ListMcpResourcesTool：列出 MCP 资源它让模型先获得“资源发现能力”ListMcpResourcesTool 的职责很像远程世界里的目录浏览。如果模型已经接上了 MCP server，但不知道那边具体暴露了哪些资源，第一步就应该用它先列出来。关键源码tools/ListMcpResourcesTool/ListMcpResourcesTool.ts： 123const inputSchema = z.object({ server: z.string().optional().describe('Optional server name to filter resources by'),}) 核心逻辑是： 123456const results = await Promise.all( clientsToProcess.map(async client => { const fresh = await ensureConnectedClient(client) return awai...

7.Skill with the Claude API（在Claude API使用skills）

7.Skill with the Claude API.md Introduce Skills with the Claude API(通过 Claude API 介绍技能功能) 在第一课中，你已经了解了技能（Skills）在 Claude AI 中的运作方式。现在，我们将开始使用 Claude API 来测试我们在上一课中创建了两个技能。要在 Claude API 中使用技能，我们需要用到代码执行工具和文件 API。这将让 Claude 获得文件系统的访问权限，使其能够读写文件，并通过 bash 执行代码。我们开始吧。之前我们已经聊了很多关于技能的运作原理以及创建方法。我们也简单提到了技能在 Claude 生态系统不同环境下的可移植性，以及在其他众多智能代理类应用中的表现。我们先从 Claude AI 和 Claude Desktop 中的技能讲起，现在我们要转向介绍如何通过 Claude Messages API 使用技能。重要注意事项有两点需要重点注意。第一，你在 Claude AI 和 Claude Desktop 中创建的技能不会在 Claude ...

ReadMcpResourceTool：读取 MCP 资源

ReadMcpResourceTool：读取 MCP 资源它是 MCP 世界里的远程 ReadReadMcpResourceTool 的职责非常明确：给定 server + uri，把远程 MCP 资源正文读回来。关键源码输入定义： 1234export const inputSchema = z.object({ server: z.string().describe('The MCP server name'), uri: z.string().describe('The resource URI to read'),}) 实际读取走 MCP SDK： 1234567const result = await connectedClient.client.request( { method: 'resources/read', params: { uri }, }, ReadResourceResultSchema,) 二进制资源也...

Claude Code 源码架构总览

Claude Code 源码架构总览先看整体图如果只从源码目录去看，很容易被大量文件吓住。但从主干关系看，Claude Code 的架构并不乱，它大致可以抽象成下面这张图：再看一张更贴近源码目录的分层图第一层：启动与装配main.tsx 的职责非常重，它不像普通 CLI 那样只是简单解析参数后执行一个函数。它会在启动阶段做很多装配工作：预热性能敏感模块加载配置与托管设置初始化认证、遥测、策略限制初始化 MCP、LSP、插件、Skills 汇总命令和工具根据模式启动 REPL、非交互流程或远程会话所以 main.tsx 更像一个系统引导器。对应源码片段1234567import { getSystemContext, getUserContext } from './context.js';import { launchRepl } from './replLauncher.js';import { getTools } from './tools.js...

核心循环解析：QueryEngine 如何驱动一次任务完成

核心循环解析：QueryEngine 如何驱动一次任务完成QueryEngine 为什么是核心中的核心如果只能选一个文件代表 Claude Code 的灵魂，那大概率就是 QueryEngine.ts。因为它负责的不是某个局部能力，而是整个任务生命周期：接收用户输入组装上下文驱动模型调用处理中间工具执行维护会话状态把任务一直推进到结束这就是典型的 Agent 主循环。它管理的是“会话”，不是“一次请求”源码中的注释已经把定位写得很明确： One QueryEngine per conversation. 这句话很关键。说明 QueryEngine 不是一次性 request handler，而是一个围绕会话长期存在的对象。因此它会保留很多跨轮次状态，例如： mutableMessages permissionDenials readFileState totalUsage 发现过的 skill 名称已加载的 memory 路径这也是 Claude Code 能连续工作的基础。对应源码片段123456789export class QueryE...