尧图网站建设 
文档提示工程人工智能【免费下载链接】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-system-prompts 仓库中维护的系统提醒 system-reminder-large-file-full-content-reading-guidance.md 展开剖析 Claude Code 在面对需要读取大文件完整内容才能分析或总结的场景时给出的两条核心规则如何完整读取以及如何把读取交给子代理以保护主上下文。读完本文你将理解这套提醒机制的设计动机、它与文件截断/重试机制、完整性披露机制的配合方式并能写出一份不会丢失细节的、合格的子代理任务书prompt。一、这份系统提醒是什么文件位置、形态与触发场景在claude-code-system-prompts仓库中Claude Code 的各种系统提醒System Reminder以独立 Markdown 文件的形式维护文件名即提醒名称。本文对应的文件是system-prompts/system-reminder-large-file-full-content-reading-guidance.mdccVersion: 2.1.173该文件在 frontmatter 中声明了三个模板变量表明其内容在运行时由宿主注入后才会成为完整指令${FULL_CONTENT_READING_INSTRUCTION}针对需要读取全文场景的具体读取指令${AGENT_TOOL_NAME}子代理工具的实际名称例如Task或Agent${SUBAGENT_READING_INSTRUCTION_EXAMPLE}一段子代理读取指令示例用于示范如何向子代理明确交代返回要求。正文仅两条规则但信息密度很高是整个大文件处理策略的纲领对于需要读取完整内容才能进行的分析或总结执行${FULL_CONTENT_READING_INSTRUCTION}。如果${AGENT_TOOL_NAME}工具可用请在子代理内部完成这件事使完整输出不进入你的主上下文。把上面的指令逐字交给子代理并明确说明它必须返回什么——例如${SUBAGENT_READING_INSTRUCTION_EXAMPLE}。一句含糊的summarize this可能会丢失细节。触发的典型场景包括用户把大型源码文件、长日志或超大文档作为附件放入对话模型需要对某份文件做完整分析或总结而不是只查其中一段。二、规则一需要全文时怎么读——读取、截断与重试的配套机制第一条规则要求凡分析或总结依赖全文就必须真正读完全部内容。它不是一个孤立的提醒而是与仓库中另外几份读取约束类提醒配套生效。2.1 文件过大时会发生什么截断提醒当附加文件过大时Claude Code 会注入文件被截断提醒system-reminder-file-truncated.mdccVersion: 2.1.239文件过大已被截断为前${MAX_LINES_CONSTANT}行。无需提及截断这件事。如果需要请使用${READ_TOOL_NAME}读取文件的更多内容。注意${MAX_LINES_CONSTANT}是模板变量由宿主按版本配置注入如默认读取行数上限文中不写死具体数值。这条提醒的要点是截断只是起点不是终点模型应继续用读取工具取回剩余部分。2.2 遇到截断警告怎么办缩小分块直到读满 100%配套的读取截断重试提醒system-reminder-read-truncation-retry-guidance.mdccVersion: 2.1.173给出了硬性要求如果读取文件时收到截断警告如 [N lines truncated]请缩小分块大小直到在不截断的情况下读完 100% 的内容。在完成之前不要继续。Bash 输出被限制为${MAX_OUTPUT_CHARS.toLocaleString()}个字符。这意味着使用读取工具时主动传入offset/limit分块读取若单次返回仍带截断警告就进一步缩小limit直到每块都能完整返回未读满 100% 之前不得进入分析/总结阶段若走 Bashcat等路线输出有字符上限同样需要分块规避。2.3 Read 工具的基础能力全文读取的实际执行者是文件读取工具。其工具描述tool-description-readfile.mdccVersion: 2.1.288说明了几个关键约束默认从文件开头读取至多${MAX_LINES_CONSTANT}行通过offset/limit参数控制分块与起始位置file_path必须使用绝对路径支持图片PNG/JPG 等以多模态方式呈现、PDF大 PDF 必须用pages参数分页读取单次最多 20 页与 Jupyter Notebook.ipynb返回所有单元格及输出只读文件、不读目录读取空文件会收到专门的系统提醒。结合这些约束一条可复用的全文读取流程是先用小分块试探文件规模 → 出现截断警告就缩小limit→ 用offset逐块推进 → 直到最后一块的返回长度小于分块上限确认已覆盖 100% → 才开始输出分析。三、规则二把全文读取交给子代理——上下文隔离的核心手段第二条规则是本提醒最精妙的部分不要自己读交给子代理读。3.1 为什么要在子代理内完成直接理由是让完整输出留在子代理的上下文中不进主上下文。子代理工具的使用指南system-prompt-tool-usage-subagent-guidance.mdccVersion: 2.1.53明确写道子代理的价值在于并行化独立查询或保护主上下文窗口免于过量的结果。一份 10 万行文件的全文会瞬间吞掉大量主上下文 token而子代理只需把最终结论带回主线程原始内容留在子代理侧。3.2 什么时候用、什么时候别用同一份指南也给出了边界子代理不应在不需要时被过度使用system-prompt-subagent-delegation-cost-guidance.mdccVersion: 2.1.271进一步说明了成本账——新开的子代理只知道你写进 prompt 的东西、只返回它的摘要两次交接都会丢失细节因此当答案是寥寥几次工具调用、或你已知道目标的一两次查询时自己干不确定时不要开子代理。对于确实需要扫读多文件/大文件全文的场景才值得把阅读 提炼结论委托出去。3.3 委托的两条铁律本提醒强调了两点缺一不可把读取指令逐字verbatim交给子代理子代理没有主对话的任何上下文参见 system-prompt-fresh-subagent-delegation-example.md 中的说明the agent starts with no context from this conversation所以必须把${FULL_CONTENT_READING_INSTRUCTION}原样嵌入其任务书否则它可能只读片段就交差明确交代返回内容拒绝含糊指令模糊的 summarize this 会丢失细节。必须显式说明要返回什么结论逐项清单问题列表以及格式与长度约束。四、写一份合格的子代理任务书结构拆解与示例仓库中若干委托示例给出了任务书的黄金结构。综合 system-prompt-fresh-subagent-delegation-example.md 与 system-prompt-non-fork-subagent-delegation-examples.mdccVersion: 2.1.235一份面向全文读取 分析的任务书应包含目标要分析什么、产出什么判断已排除/已确认的背景你已经做过什么、排除了什么避免子代理重复劳动tool-description-agent-usage-notes.md 中的Trust but verify也提醒子代理的摘要描述的是它打算做什么不一定等于实际做了什么指向文件而不是转述内容给出文件路径让子代理自己去读逐字嵌入全文读取指令显式、窄范围的返回要求形式清单/结论 长度上限如 Under 200 words。一个可直接套用的示意JSON 参数形式与仓库示例保持一致Task({ description: Full-content analysis of large log file, prompt: Read the COMPLETE content of /data/logs/order-service.log using chunked reads (offset/limit), reducing chunk size on any truncation warning until 100% of the file is read WITHOUT truncation. Do NOT summarize before you have read 100%. Then report, as a punch list: (1) every distinct error code with its line numbers, (2) the sequence of events around the first timeout, (3) anything anomalous. Under 250 words. })对照本提醒的要求检查这份任务书读取指令逐字在内、返回形式明确清单 行号 上限字数、范围窄只针对该文件——这正是别让细节丢失的落地写法。委托一旦发出就不应再自己重复同样的搜索见 system-prompt-tool-usage-subagent-guidance.mdavoid duplicating work that subagents are already doing。五、配套约束完整性披露与失败止损全文读取之外模型还有一项诚实披露义务见 system-reminder-file-summary-completeness-disclosure.mdccVersion: 2.1.173在产出任何摘要或分析之前必须明确描述你已读取了内容的哪一部分。如果你没有读完全部内容必须明确说明这一点。如果尝试几次后仍无法读取文件文件不存在、行过长超出 Read 的 offset/limit、没有 shell 权限停止重试总结你读到的部分明确说明哪部分没读到及原因然后继续。它与本文主题互为表里规则一要求读完 100% 再分析披露规则则兜底了万一确实读不完的情形——不掩盖、不假装读全明说覆盖范围后继续。两者共同保证了分析的可信度边界。六、边界辨析全文读取 vs 只读搜索代理需要区分两种不同定位的代理行为。仓库中另有只读搜索代理agent-prompt-read-only-search-agent.mdccVersion: 2.1.173面向广度扫描fan-out的只读搜索代理——当答案需要扫过许多文件、目录或命名约定而你只需要结论而不是文件转储时使用。它读片段而不是读全文所以它能定位代码但不能审查或审计代码。两者对照关系如下维度全文读取本文提醒只读搜索代理读取方式分块读满 100%逐字执行全文读取指令读片段excerpts目标对单份大文件做完整分析/总结/审计跨多文件定位代码、给出结论产出完整覆盖后的分析结论结论而非文件转储适用需要全文依据的审查、总结广度搜索、命名约定扫描简单说全文读取解决读得够不够全搜索代理解决搜得够不够广。需要逐行审计一份文件时用前者需要确认哪个文件实现了某功能时用后者。七、仓库中的相关文件索引以下文件可在仓库中继续深入阅读理解整套大文件处理与子代理委托机制的全貌核心提醒system-prompts/system-reminder-large-file-full-content-reading-guidance.md截断与重试system-prompts/system-reminder-file-truncated.md、system-prompts/system-reminder-read-truncation-retry-guidance.md完整性披露system-prompts/system-reminder-file-summary-completeness-disclosure.md读取工具能力system-prompts/tool-description-readfile.md子代理工具与委托成本system-prompts/tool-description-agent-usage-notes.md、system-prompts/system-prompt-tool-usage-subagent-guidance.md、system-prompts/system-prompt-subagent-delegation-cost-guidance.md委托示例与边界system-prompts/system-prompt-fresh-subagent-delegation-example.md、system-prompts/system-prompt-non-fork-subagent-delegation-examples.md、system-prompts/agent-prompt-read-only-search-agent.md小结这份篇幅不长的系统提醒浓缩了 Claude Code 处理大文件的两条关键工程原则要么不分析要分析就真正读满 100%通过分块读取、遇截断缩小分块、配合完整性披露实现凡是可能污染主上下文的全文读取就委托给子代理通过逐字传递读取指令 显式返回要求来对抗交接过程中的细节丢失。理解这套机制不仅有助于读懂 Claude Code 的提示工程设计也可以直接迁移到你自己编写的 Agent 工作流中为长文/大文件分析类任务设计子代理时任务书里永远要有完整的读取指令、明确的返回契约以及对没读完状态的诚实披露。赞分享文档提示工程人工智能【免费下载链接】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点击查看免费下载相关推荐Context7 Claude Code 插件中的 docs-researcher 子代理把库文档调研隔离到独立上下文保持主会话精简Context7 Claude Code 插件中的 docs researcher 子代理把库文档调研隔离到独立上下文保持主会话精简 docs researMCP 服务AI 应用开发工具Kimi Code 子代理Agent工具深度指南从任务委派到上下文隔离的完整实践Kimi Code 子代理Agent工具深度指南从任务委派到上下文隔离的完整实践 导读 本文以 agent.md https://link.gitcodeAI Agent代码智能体人工智能大模型CLIlearn-claude-code s06 深度解析用嵌套 Agent Loop 为子任务创建隔离上下文Subagentlearn claude code s06 深度解析用嵌套 Agent Loop 为子任务创建隔离上下文Subagent 本文基于 learn claud示例工程AI Agent人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Claude Code 大文件全文读取指引解析：借助子代理隔离上下文完成完整文件分析
文档提示工程人工智能【免费下载链接】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-system-prompts 仓库中维护的系统提醒 system-reminder-large-file-full-content-reading-guidance.md 展开剖析 Claude Code 在面对需要读取大文件完整内容才能分析或总结的场景时给出的两条核心规则如何完整读取以及如何把读取交给子代理以保护主上下文。读完本文你将理解这套提醒机制的设计动机、它与文件截断/重试机制、完整性披露机制的配合方式并能写出一份不会丢失细节的、合格的子代理任务书prompt。一、这份系统提醒是什么文件位置、形态与触发场景在claude-code-system-prompts仓库中Claude Code 的各种系统提醒System Reminder以独立 Markdown 文件的形式维护文件名即提醒名称。本文对应的文件是system-prompts/system-reminder-large-file-full-content-reading-guidance.mdccVersion: 2.1.173该文件在 frontmatter 中声明了三个模板变量表明其内容在运行时由宿主注入后才会成为完整指令${FULL_CONTENT_READING_INSTRUCTION}针对需要读取全文场景的具体读取指令${AGENT_TOOL_NAME}子代理工具的实际名称例如Task或Agent${SUBAGENT_READING_INSTRUCTION_EXAMPLE}一段子代理读取指令示例用于示范如何向子代理明确交代返回要求。正文仅两条规则但信息密度很高是整个大文件处理策略的纲领对于需要读取完整内容才能进行的分析或总结执行${FULL_CONTENT_READING_INSTRUCTION}。如果${AGENT_TOOL_NAME}工具可用请在子代理内部完成这件事使完整输出不进入你的主上下文。把上面的指令逐字交给子代理并明确说明它必须返回什么——例如${SUBAGENT_READING_INSTRUCTION_EXAMPLE}。一句含糊的summarize this可能会丢失细节。触发的典型场景包括用户把大型源码文件、长日志或超大文档作为附件放入对话模型需要对某份文件做完整分析或总结而不是只查其中一段。二、规则一需要全文时怎么读——读取、截断与重试的配套机制第一条规则要求凡分析或总结依赖全文就必须真正读完全部内容。它不是一个孤立的提醒而是与仓库中另外几份读取约束类提醒配套生效。2.1 文件过大时会发生什么截断提醒当附加文件过大时Claude Code 会注入文件被截断提醒system-reminder-file-truncated.mdccVersion: 2.1.239文件过大已被截断为前${MAX_LINES_CONSTANT}行。无需提及截断这件事。如果需要请使用${READ_TOOL_NAME}读取文件的更多内容。注意${MAX_LINES_CONSTANT}是模板变量由宿主按版本配置注入如默认读取行数上限文中不写死具体数值。这条提醒的要点是截断只是起点不是终点模型应继续用读取工具取回剩余部分。2.2 遇到截断警告怎么办缩小分块直到读满 100%配套的读取截断重试提醒system-reminder-read-truncation-retry-guidance.mdccVersion: 2.1.173给出了硬性要求如果读取文件时收到截断警告如 [N lines truncated]请缩小分块大小直到在不截断的情况下读完 100% 的内容。在完成之前不要继续。Bash 输出被限制为${MAX_OUTPUT_CHARS.toLocaleString()}个字符。这意味着使用读取工具时主动传入offset/limit分块读取若单次返回仍带截断警告就进一步缩小limit直到每块都能完整返回未读满 100% 之前不得进入分析/总结阶段若走 Bashcat等路线输出有字符上限同样需要分块规避。2.3 Read 工具的基础能力全文读取的实际执行者是文件读取工具。其工具描述tool-description-readfile.mdccVersion: 2.1.288说明了几个关键约束默认从文件开头读取至多${MAX_LINES_CONSTANT}行通过offset/limit参数控制分块与起始位置file_path必须使用绝对路径支持图片PNG/JPG 等以多模态方式呈现、PDF大 PDF 必须用pages参数分页读取单次最多 20 页与 Jupyter Notebook.ipynb返回所有单元格及输出只读文件、不读目录读取空文件会收到专门的系统提醒。结合这些约束一条可复用的全文读取流程是先用小分块试探文件规模 → 出现截断警告就缩小limit→ 用offset逐块推进 → 直到最后一块的返回长度小于分块上限确认已覆盖 100% → 才开始输出分析。三、规则二把全文读取交给子代理——上下文隔离的核心手段第二条规则是本提醒最精妙的部分不要自己读交给子代理读。3.1 为什么要在子代理内完成直接理由是让完整输出留在子代理的上下文中不进主上下文。子代理工具的使用指南system-prompt-tool-usage-subagent-guidance.mdccVersion: 2.1.53明确写道子代理的价值在于并行化独立查询或保护主上下文窗口免于过量的结果。一份 10 万行文件的全文会瞬间吞掉大量主上下文 token而子代理只需把最终结论带回主线程原始内容留在子代理侧。3.2 什么时候用、什么时候别用同一份指南也给出了边界子代理不应在不需要时被过度使用system-prompt-subagent-delegation-cost-guidance.mdccVersion: 2.1.271进一步说明了成本账——新开的子代理只知道你写进 prompt 的东西、只返回它的摘要两次交接都会丢失细节因此当答案是寥寥几次工具调用、或你已知道目标的一两次查询时自己干不确定时不要开子代理。对于确实需要扫读多文件/大文件全文的场景才值得把阅读 提炼结论委托出去。3.3 委托的两条铁律本提醒强调了两点缺一不可把读取指令逐字verbatim交给子代理子代理没有主对话的任何上下文参见 system-prompt-fresh-subagent-delegation-example.md 中的说明the agent starts with no context from this conversation所以必须把${FULL_CONTENT_READING_INSTRUCTION}原样嵌入其任务书否则它可能只读片段就交差明确交代返回内容拒绝含糊指令模糊的 summarize this 会丢失细节。必须显式说明要返回什么结论逐项清单问题列表以及格式与长度约束。四、写一份合格的子代理任务书结构拆解与示例仓库中若干委托示例给出了任务书的黄金结构。综合 system-prompt-fresh-subagent-delegation-example.md 与 system-prompt-non-fork-subagent-delegation-examples.mdccVersion: 2.1.235一份面向全文读取 分析的任务书应包含目标要分析什么、产出什么判断已排除/已确认的背景你已经做过什么、排除了什么避免子代理重复劳动tool-description-agent-usage-notes.md 中的Trust but verify也提醒子代理的摘要描述的是它打算做什么不一定等于实际做了什么指向文件而不是转述内容给出文件路径让子代理自己去读逐字嵌入全文读取指令显式、窄范围的返回要求形式清单/结论 长度上限如 Under 200 words。一个可直接套用的示意JSON 参数形式与仓库示例保持一致Task({ description: Full-content analysis of large log file, prompt: Read the COMPLETE content of /data/logs/order-service.log using chunked reads (offset/limit), reducing chunk size on any truncation warning until 100% of the file is read WITHOUT truncation. Do NOT summarize before you have read 100%. Then report, as a punch list: (1) every distinct error code with its line numbers, (2) the sequence of events around the first timeout, (3) anything anomalous. Under 250 words. })对照本提醒的要求检查这份任务书读取指令逐字在内、返回形式明确清单 行号 上限字数、范围窄只针对该文件——这正是别让细节丢失的落地写法。委托一旦发出就不应再自己重复同样的搜索见 system-prompt-tool-usage-subagent-guidance.mdavoid duplicating work that subagents are already doing。五、配套约束完整性披露与失败止损全文读取之外模型还有一项诚实披露义务见 system-reminder-file-summary-completeness-disclosure.mdccVersion: 2.1.173在产出任何摘要或分析之前必须明确描述你已读取了内容的哪一部分。如果你没有读完全部内容必须明确说明这一点。如果尝试几次后仍无法读取文件文件不存在、行过长超出 Read 的 offset/limit、没有 shell 权限停止重试总结你读到的部分明确说明哪部分没读到及原因然后继续。它与本文主题互为表里规则一要求读完 100% 再分析披露规则则兜底了万一确实读不完的情形——不掩盖、不假装读全明说覆盖范围后继续。两者共同保证了分析的可信度边界。六、边界辨析全文读取 vs 只读搜索代理需要区分两种不同定位的代理行为。仓库中另有只读搜索代理agent-prompt-read-only-search-agent.mdccVersion: 2.1.173面向广度扫描fan-out的只读搜索代理——当答案需要扫过许多文件、目录或命名约定而你只需要结论而不是文件转储时使用。它读片段而不是读全文所以它能定位代码但不能审查或审计代码。两者对照关系如下维度全文读取本文提醒只读搜索代理读取方式分块读满 100%逐字执行全文读取指令读片段excerpts目标对单份大文件做完整分析/总结/审计跨多文件定位代码、给出结论产出完整覆盖后的分析结论结论而非文件转储适用需要全文依据的审查、总结广度搜索、命名约定扫描简单说全文读取解决读得够不够全搜索代理解决搜得够不够广。需要逐行审计一份文件时用前者需要确认哪个文件实现了某功能时用后者。七、仓库中的相关文件索引以下文件可在仓库中继续深入阅读理解整套大文件处理与子代理委托机制的全貌核心提醒system-prompts/system-reminder-large-file-full-content-reading-guidance.md截断与重试system-prompts/system-reminder-file-truncated.md、system-prompts/system-reminder-read-truncation-retry-guidance.md完整性披露system-prompts/system-reminder-file-summary-completeness-disclosure.md读取工具能力system-prompts/tool-description-readfile.md子代理工具与委托成本system-prompts/tool-description-agent-usage-notes.md、system-prompts/system-prompt-tool-usage-subagent-guidance.md、system-prompts/system-prompt-subagent-delegation-cost-guidance.md委托示例与边界system-prompts/system-prompt-fresh-subagent-delegation-example.md、system-prompts/system-prompt-non-fork-subagent-delegation-examples.md、system-prompts/agent-prompt-read-only-search-agent.md小结这份篇幅不长的系统提醒浓缩了 Claude Code 处理大文件的两条关键工程原则要么不分析要分析就真正读满 100%通过分块读取、遇截断缩小分块、配合完整性披露实现凡是可能污染主上下文的全文读取就委托给子代理通过逐字传递读取指令 显式返回要求来对抗交接过程中的细节丢失。理解这套机制不仅有助于读懂 Claude Code 的提示工程设计也可以直接迁移到你自己编写的 Agent 工作流中为长文/大文件分析类任务设计子代理时任务书里永远要有完整的读取指令、明确的返回契约以及对没读完状态的诚实披露。赞分享文档提示工程人工智能【免费下载链接】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点击查看免费下载相关推荐Context7 Claude Code 插件中的 docs-researcher 子代理把库文档调研隔离到独立上下文保持主会话精简Context7 Claude Code 插件中的 docs researcher 子代理把库文档调研隔离到独立上下文保持主会话精简 docs researMCP 服务AI 应用开发工具Kimi Code 子代理Agent工具深度指南从任务委派到上下文隔离的完整实践Kimi Code 子代理Agent工具深度指南从任务委派到上下文隔离的完整实践 导读 本文以 agent.md https://link.gitcodeAI Agent代码智能体人工智能大模型CLIlearn-claude-code s06 深度解析用嵌套 Agent Loop 为子任务创建隔离上下文Subagentlearn claude code s06 深度解析用嵌套 Agent Loop 为子任务创建隔离上下文Subagent 本文基于 learn claud示例工程AI Agent人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考