文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载导读本文基于 system-prompts/system-reminder-deferred-tools-available.md 这份系统提示模板结合仓库内 ToolSearch 工具描述、Chrome 浏览器自动化提示与 CHANGELOG完整解析 Claude Code 中延迟工具Deferred Tools的加载机制工具为何会被延迟声明、Agent 为何必须通过 ToolSearch 加载 schema 后才能调用、直接调用为何会失败以及如何用一条select:查询批量加载多个工具。读完本文你将掌握这套机制的工作原理、查询语法与最佳实践并能准确理解 Claude Code 提示词体系中各类 System Reminder 与工具描述的真实调用关系。一、机制全景从按名宣布到按需加载在 Claude Code 的提示词体系中并非所有工具都会在会话开始时完整加载。部分工具以延迟工具deferred tools的形式存在系统只告知工具的名字不附带其参数 Schema。当这些工具变为可用时系统会通过一条 System Reminder 按名称宣布它们并指示 Agent 借助 ToolSearch 加载其完整 Schema 后再调用。这条 Reminder 即本文的主题文档其完整语义如下The following deferred tools are now available via ${TOOL_SEARCH_TOOL_NAME}. Their schemas are NOT loaded — calling them directly will fail with InputValidationError. Use ${TO_SEARCH_TOOL_NAME} with query select: [, ...] to load tool schemas before calling them.其中${TOOL_SEARCH_TOOL_NAME}是该模板声明的动态变量见文档 front matter 的variables字段实际运行时会替换为具体的工具名称——也就是 ToolSearch。整条消息传达三个关键事实工具已可用一批延迟工具已被宣布可以进入加载流程Schema 未加载当前只知道工具名不知道任何参数结构直接调用会失败未加载 Schema 就调用会抛出InputValidationError加载方式是明确的使用select:name[,name...]形式的查询批量加载。说明CHANGELOG 记录过一次演进——CHANGELOG.md 中提到该 Reminder 曾Stops appending the explicit list of newly available deferred tools after the instruction to load their schemas through ToolSearch即新版不再把延迟工具名单逐项拼接在提示中而是只保留加载指令ccVersion: 2.1.257。二、为什么需要延迟加载Schema 体积与连接时序的权衡从仓库相关文档可以推断延迟加载机制主要解决两类问题第一控制提示词体积。一个工具的完整调用需要一份 JSON Schema含 description、name、parameters如果所有工具尤其是通过 MCP 接入的外部工具都在提示词顶部完整展开上下文将迅速膨胀。延迟机制把全部展开改为按需获取只有 Agent 明确要用时才取回 Schema。这在 system-prompts/tool-description-toolsearch-opening.md 中有直接表述Fetches full schema definitions for deferred tools so they can be called. Deferred tools appear by name insystem-remindermessages.第二匹配 MCP 服务器的连接时序。MCP 工具通常以mcp__server__*命名。服务器连接需要时间工具在连接完成前不可用。与之配套的 system-prompts/system-reminder-mcp-servers-connecting-without-toolsearch.md 明确说明The following MCP servers are still connecting — their tools (typically named mcp__ __*) are not yet available but will be announced here once they connect.也就是说正在连接的 MCP 服务器会先以连接中状态出现其工具会在连接完成后通过 Reminder 宣布——这正好触发Deferred tools available流程。该文档还要求 Agent只要这些服务器仍在连接中就不得把相关能力报告为不可用应等待工具宣布。三、ToolSearch延迟工具的 Schema 加载器按名宣布之后真正承担加载职责的是 ToolSearch。仓库中与它配套的 Tool Description 文件构成了完整的加载协议说明3.1 返回格式与提示词顶部一致的functions编码system-prompts/tool-description-toolsearch-second-part.md 给出了加载后的结果契约ToolSearch 接受一个查询query将其与延迟工具列表匹配匹配到的工具以完整的 JSON Schema 定义放在一个functions块中返回每个匹配工具在functions内对应一行function{description: ..., name: ..., parameters: {...}}/function与提示词顶部工具列表采用完全相同的编码格式一旦某工具的 Schema 出现在返回结果中它就可以像提示词顶部定义的任何工具一样被直接调用。这意味着加载不是把工具逻辑注入而是把它的可调用定义参数契约补充到 Agent 的可见范围内。3.2 三种查询形式同一个文档定义了 ToolSearch 的三种查询形态这是理解本机制最核心的语法部分查询形式语义示例select:name[,name...]按名称精确选取一个或多个工具select:Read,Edit,Grep普通关键词关键词搜索返回最多max_results个最佳匹配notebook jupyterword前缀要求该词必须出现在工具名中再按其余词排序slack send在本文主题文档中System Reminder 指示的就是第一种形式select:name[,name...]——注意它明确支持逗号分隔的多工具列表这是批量加载的语法基础。3.3 加载前的状态只有名字没有 Schema为什么直接调用会失败system-prompts/tool-description-toolsearch-input-validation-note.md 给出了精确解释Until fetched, only the name is known — there is no parameter schema, so calling the tool fails with InputValidationError. When any instruction, system reminder, or other tools description names a deferred tool, fetch it with query select: before calling it.即未加载前只知道名字没有参数 Schema因此调用会以InputValidationError失败。并且触发加载的条件不限于本文主题的 System Reminder——任何指令、其他 System Reminder、或其他工具描述中只要点名了某个延迟工具都应先通过select:name取回它再调用。这一规则在 system-prompts/tool-description-toolsearch-unfetched-tool-note.md 中被简化为同一结论Until fetched, only the name is known — there is no parameter schema, so the tool cannot be invoked.四、实战要点一批量加载一次调用完成延迟加载机制对 Agent 最直接的要求是避免逐个工具单独加载。仓库中两个浏览器自动化相关的系统提示反复强调这一点system-prompts/system-prompt-chrome-browser-mcp-tools.md 的措辞最为明确IMPORTANT: If the Chrome browser tools are deferred (must be loaded via ToolSearch before use), load them with ToolSearch before calling them, and batch every tool you expect to need into ONE ToolSearch call (the select query accepts a comma-separated list). Do NOT load tools one at a time; each separate ToolSearch call wastes a full round-trip.其给出的核心工具集一次加载示例为ToolSearch with query select:mcp__claude-in-chrome__tabs_context_mcp,mcp__claude-in-chrome__navigate,mcp__claude-in-chrome__computer,mcp__claude-in-chrome__read_page,mcp__claude-in-chrome__tabs_create_mcp,mcp__claude-in-chrome__tabs_close_mcp这条查询一次取回 6 个核心浏览器工具的 Schema。若任务明显还需要其他工具应在同一次调用中追加read_console_messages/read_network_requests—— 调试用form_input—— 表单填写gif_creator—— 录制操作过程javascript_tool—— 页面脚本执行。只有在任务后续确实用到未预判的工具时才允许发出第二次 ToolSearch。system-prompts/system-prompt-claude-in-chrome-deferred-tool-loading.md 给出了完全一致的指引并强调never one call per tool绝不一个工具一次调用。细节佐证CHANGELOG 记录了核心集的演进——CHANGELOG.md 中提到 Addtabs_close_mcpto the core deferred browser tools loaded together at the start of a browser task说明tabs_close_mcp是后来被纳入核心集的新成员印证了核心集 按需追加是持续迭代的设计模式。五、实战要点二加载时机与判定规则综合本文主题文档与配套工具描述可以归纳出 Agent 面对延迟工具的完整决策链识别宣布在system-reminder消息中看到延迟工具按名称出现例如 Deferred tools available 或 MCP 服务器连接完成后的工具宣布先加载再调用任何指令、Reminder 或工具描述点名了延迟工具调用前都必须先用select:name取回 Schema一次调用批量取把本次任务预期需要的全部工具并入同一条select:查询逗号分隔避免逐工具加载造成多余的完整往返round-trip加载后等同普通工具Schema 出现在functions结果后该工具即可像提示词顶部的工具一样被调用失败即查若收到InputValidationError说明目标工具仍是只有名字、没有 Schema的未加载状态应回到第 2 步补齐加载。对于浏览器任务还有一条启动顺序约束来自 system-prompts/system-prompt-claude-in-chrome-browser-automation-non-deferred-tools.md每次浏览器自动化会话开始时应首先调用tabs_context_mcp获取用户当前标签页信息理解用户可能想处理什么之后再创建新标签页且不得复用其他会话的标签页 ID。六、机制演进从 MCPSearch 到 ToolSearch从 CHANGELOG.md 可以追踪这套机制的完整演化路径这有助于理解当前设计为何如此早期工具加载工具名为MCPSearch后来整体重命名为ToolSearchNEW:Tool Description: ToolSearch - renamed from MCPSearch各相关提示同步更新引用select:多工具能力反复调整曾移除逗号分隔的单工具限制select:now loads only a single named tool之后又恢复Re-added comma-separated multi-tool direct selection (e.g.,select:Read,Edit,Grep)——最终定型为本文所述的多工具列表形式这也正是本文主题文档中select:name[,name...]语法的来源搜索模式排序调整关键词搜索被前移为首要模式并要求以前缀标记必含词reordered query modes (keyword search now first)... added required keyword syntax with prefix内容抽取与合并ToolSearch 的扩展用法说明先被拆分为独立条件提示ToolSearch extended后又合并回第二部分的工具描述Tool Description: ToolSearch (second part)形成当前基础描述 第二部分查询模式的结构宣布方式精简本文主题的 Deferred tools available Reminder 不再在指令后拼接延迟工具名单改为只承载加载指令见前文引用。七、总结延迟加载机制的核心心智模型把本文主题文档放回整个提示词体系可以提炼出 Claude Code 延迟工具机制的四条核心规则名字与 Schema 分离延迟工具在宣布时只有名字参数 Schema 通过 ToolSearch 按需获取调用前置条件Schema 未加载前调用必然失败InputValidationError加载完成后工具即恢复为普通工具批量优于逐个select:支持逗号分隔的多工具名应把预期需要的工具并入一次调用以节省往返开销宣布是触发的唯一信号无论是本文主题的 Deferred tools available Reminder还是 MCP 服务器连接完成后的工具宣布只要工具名出现在提示中就应遵循先 select 加载、再调用的流程。这套机制平衡了提示词体积、MCP 服务器异步连接与工具可用性三者之间的关系是理解 Claude Code 提示词工程尤其是其系统提示模板如何编排工具生命周期的关键一环。相关原始模板与配套工具描述均可在本仓库 system-prompts/ 目录下按上述相对路径查阅便于对照源码级证据进一步研究。赞分享文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载相关推荐Claude Code 系统提示词解析Claude in Chrome 延迟工具的批量 ToolSearch 加载规范Claude Code 系统提示词解析Claude in Chrome 延迟工具的批量 ToolSearch 加载规范 导读 本文围绕 Claude Code文档提示工程人工智能Claude Code Chrome 浏览器 MCP 工具延迟加载指南用 ToolSearch 一次批量装载核心工具集Claude Code Chrome 浏览器 MCP 工具延迟加载指南用 ToolSearch 一次批量装载核心工具集 导读 本文深入解析 Claude Co文档提示工程人工智能YouTube.js 解析器节点深度解析CarouselTitleView 轮播标题视图类YouTube.js 解析器节点深度解析CarouselTitleView 轮播标题视图类 本文以 YouTube.js 中 CarouselTitleVie文档提示工程人工智能创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考