文档提示工程人工智能【免费下载链接】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点击查看免费下载本篇文章聚焦开源仓库 gh_mirrors/cl/claude-code-system-prompts 中的核心文档 system-reminder-file-summary-completeness-disclosure.md深度解析 Claude Code 注入给模型的文件摘要完整性披露系统提醒它要求模型在产出任何总结或分析之前先说明自己实际读取了多少内容并在读取失败时及时停止重试、如实汇报。读完本文你将理解该提醒的两条强制行为规则、它与 Read 工具行数上限及截断重试等配套机制如何协同工作以及如何在真实的文件分析、对话压缩等场景中落地读了什么就说什么的可信度底线。一、这份提醒在 Claude Code 系统提示词体系中的位置Claude Code 并不只有一段固定的系统提示词。正如仓库 README.md 所述其系统提示词由大量根据环境和配置条件性追加的片段组成而 System Reminders 正是其中专门承载大段系统提醒文本的类别——本仓库将它们逐条提取为独立 Markdown 文件并标注了对应的 token 数与版本。本关联文档的 frontmatter 声明如下!-- name: System Reminder: File summary completeness disclosure description: Requires Claude to disclose how much file content was read before summarizing and to stop retrying after repeated read failures ccVersion: 2.1.173 --其中name标识提醒名称description概括其职责ccVersion标注该提醒对应的 Claude Code 版本2.1.173。整个仓库随每个 Claude Code 版本更新README 中将其列为107 tks的 System Reminder 条目见 README 的 System Reminders 小节。它的作用对象是主会话中的模型本体当模型需要总结或分析某个文件内容时这段提醒被注入上下文约束模型在输出结论前先交代读取范围。二、规则一任何总结与分析之前必须先披露已读取的内容范围该提醒的第一条规则原文如下Before producing ANY summary or analysis, you MUST explicitly describe what portion of the content you have read.If you did not read the entire content, you MUST explicitly state this.拆解这条规则可以得到三个强制行为要求前置披露义务MUST在产出任何ANY总结或分析之前必须先明确描述你读了这个内容的哪一部分。覆盖所有产出类型无论是给用户的文件总结、代码审查结论、日志分析报告还是对话压缩compaction后的摘要都受此约束。未读全必须明说双重强调只要没有读完整份内容就必须显式声明未读取完整内容——原文用***...***做了强调说明这是不可省略的硬性要求。这一规则的工程动机很清晰模型在长文件面前容易出现只读了几行却像读完了一样给出结论的行为。披露义务把读取范围变成输出结论的前置步骤让用户能判断总结的置信度——例如我读取了该文件前 500 行共 1200 行与我已读取全文二者的可信度完全不同。这与仓库中另一份系统提示 system-prompt-reporting-outcomes.md要求报告区分观察到的结果与意图、避免夸大未经验证的完成度在精神上一脉相承结论必须建立在真实读取的证据之上。三、规则二多次读取失败后停止重试降级为部分总结该提醒的第二条规则原文如下If after a few attempts you cannot read the file (file not found, lines too long for Reads offset/limit, no shell access), STOP retrying. Summarize what you were able to read, explicitly state which portion you could not read and why, and proceed.它针对的是读不到的异常路径同样包含三步有限的尝试次数只在几次尝试a few attempts后仍无法读取时触发停止条件避免无意义的反复重试消耗上下文与时间。明确列举失败原因类型原文给出了三类典型场景——文件不存在file not found行数超出 Read 工具的 offset/limit 能力lines too long for Reads offset/limit没有 shell 访问权限no shell access。降级输出并继续停止重试后要做三件事总结能读到的部分、显式说明哪部分没读到以及为什么、然后正常继续后续工作proceed。这条规则的设计意图是不让失败卡死整个会话读取失败不该导致任务僵持也不该导致模型假装读过。诚实的部分总结 明确的缺失说明比无限重试或编造内容都更符合工程上可继续推进的要求。同时它也呼应了 system-prompt-action-safety-and-truthful-reporting.md 中如实汇报结果的总体原则。四、配套机制一Read 工具的行数上限与分片读取要理解lines too long for Reads offset/limit为何会成为失败原因需要看 Read 工具的实际定义。tool-description-readfile.md 中明确写明By default, it reads up to ${MAX_LINES_CONSTANT} lines starting from the beginning of the file即默认最多读取MAX_LINES_CONSTANT一个随版本变化的行数常量行超大文件必须借助 offset/limit 分片读取。同一份工具描述还补充了其他读取边界读取 PDF 时超过 10 页的大文件必须用pages参数指定页范围如pages: 1-5且单次最多 20 页读取存在的空文件时会收到一个系统提醒作为替代内容对应 system-reminder-file-exists-but-empty.md当 offset 超过文件长度时也会触发提醒对应 system-reminder-file-shorter-than-offset.md。这些边界正是无法一次读全的客观来源。在实际操作中处理长文件的标准做法是多次调用 Read 并携带不同的 offset 分片读取例如Read file_path/path/to/large.log offset1 limit500 # 读取第 1–500 行 Read file_path/path/to/large.log offset501 limit500 # 读取第 501–1000 行而根据本文档的规则一无论分片读到哪一步最终产出总结前都必须说明已读取了哪些行、占全文多少比例未读完的部分则按规则二如实声明。五、配套机制二截断提示与读全为止的重试指引围绕文件太大这一核心场景Claude Code 还注入了若干与本文档直接相关的提醒共同构成完整的读取治理链路文件截断通知system-reminder-file-truncated.md 会在文件过大、系统仅向模型呈现前${MAX_LINES_CONSTANT}行时注入并说明无需主动提及截断需要更多内容就用 Read 工具继续读取。截断重试指引system-reminder-read-truncation-retry-guidance.md 的约束更强——一旦收到[N lines truncated]这样的截断警告就必须缩小分片大小reduce the chunk size继续读直到 100% 读完且无截断并且原文用DO NOT PROCEED UNTIL YOU HAVE DONE THIS强调没读完之前不得继续。该提醒还顺带说明 Bash 输出有${MAX_OUTPUT_CHARS}字符上限。大文件全文读取指引system-reminder-large-file-full-content-reading-guidance.md 给出了更省上下文的方案当需要基于全文做分析时如果 Agent 工具可用应把读全文这件事交给子代理subagent执行让完整输出停留在子代理上下文中并明确告诉子代理必须返回什么避免一句含糊的帮我总结一下丢失细节。将这三份提醒与本文档对照可以看出完整的分层策略先尽力读全截断时缩分片、必要时交给子代理→ 读不全时披露范围本文档规则一→ 彻底读不到时停止重试并降级总结本文档规则二。read-truncation-retry-guidance的必须读完与本文档的没读完必须声明并不矛盾——前者适用于文件大但可读的路径后者适用于文件确实读不到的兜底路径。六、配套机制三其他输出截断场景的同类处理读取范围披露的原则不只应用于本地文件读取Claude Code 在同类输出被截断场景中贯彻了完全一致的处理哲学可以从仓库的以下文档中印证MCP 工具输出截断system-reminder-mcp-output-truncation-warning.md 声明当 MCP 工具输出超过 token 上限被截断时如果该 MCP 服务器提供分页或过滤工具应使用它们获取特定数据分片如果无法分页则必须告知用户当前基于截断输出工作、结果可能不完整——这与本文档未读全必须明说是同一原则在不同通道上的复用。Hook 条件求值的截断转录system-prompt-hook-evaluator-truncated-transcript-note.md 告诉 hook 条件求值器更早的对话因上下文窗口限制被省略${OMITTED_MESSAGE_COUNT}条消息未呈现如果所需证据可能位于被省略的前缀中应返回{ok: false, reason: insufficient evidence in transcript}——即证据不足就明确说不足而不是强行下结论。MCP 资源无内容另有 system-reminder-mcp-resource-no-content.md 负责资源没有内容的提示场景。这些文件共同表明Claude Code 在信息不完整的所有出入口本地文件、MCP 输出、对话转录都要求模型要么补齐信息、要么如实披露不完整杜绝基于不完整信息做出看似完整的结论。七、与总结类提示词的协同完整性如何被制度化本提醒的披露读取范围规则最终落到仓库中一系列总结类系统提示词所定义的产出格式上。理解它们有助于看清该提醒在真实会话中的生效位置部分压缩指令system-prompt-partial-compaction-instructions.md 定义了对话压缩摘要必须包含的 9 个章节Primary Request and Intent、Key Technical Concepts、Files and Code Sections、Errors and fixes、Problem Solving、All user messages、Pending Tasks、Work Completed、Context for Continuing Work并要求详尽总结让只读摘要和后续新消息的人能完整理解发生了什么——包括关键代码片段、函数签名、文件编辑记录以及必须逐字保留的安全相关指令。分析过程指令system-prompt-analysis-instructions-for-full-compact-prompt-recent-messages.md 要求把分析过程包在analysis标签中按时间顺序逐段识别用户意图、技术决策、错误与修复并双重检查技术准确性与完整性确保每个必需要素都被覆盖。上下文压缩摘要SDKsystem-prompt-context-compaction-summary.md 定义了面向 SDK 的续接摘要格式同样要求结构化、简洁且可行动避免重复劳动。将本文档与上述指令放在一起阅读即可发现完整的信任链读取阶段靠本文档的披露读取范围 失败停止重试保证信息源的透明总结阶段靠压缩指令的结构化模板保证信息不丢失、不掺假。两端的约束共同服务于一个目标——压缩后的摘要依然是可以被信任的可继续工作的依据。八、实践清单与常见误区基于以上分析为开发者和使用 Claude Code 的 Agent 总结一份落地清单应当这样做每次总结或分析文件前先说明读取范围例如已读取全部 1200 行或已读取前 500 行共 1200 行其余部分未读取收到[N lines truncated]截断警告时缩小分片大小如从 500 行降到 200 行继续读取直到读满 100%大文件全文分析交给子代理执行并在指令中明确要求其返回的内容粒度参考 system-reminder-large-file-full-content-reading-guidance.md文件不存在、offset/limit 读不了、无 shell 访问时尝试数次后立即停止重试输出已读取部分 未读取部分及原因的总结并继续任务处理 MCP 输出截断、hook 转录省略等同类场景时同样遵循要么分页补齐、要么明确告知不完整的原则。应避免的误区只读了几行就当全文总结或在未读完整内容时暗示已读完——这是规则一明确禁止的行为读取失败后无限重试浪费上下文与时间——规则二要求及时止损因文件过大就草率放弃阅读——正确做法是先按 system-reminder-read-truncation-retry-guidance.md 缩小分片、必要时派生子代理读全只有真正读不到时才降级为部分总结。结语system-reminder-file-summary-completeness-disclosure.md 虽然只有短短两条规则却是 Claude Code 可信度体系中的一个关键支点它用产出结论前披露读取范围和读取失败及时止损并如实说明两条硬约束把信息不完整这一常态变成了可以显式管理的状态。在长文件分析、对话压缩、MCP 结果处理等所有涉及信息经截断后流通的场景中这套机制与 tool-description-readfile.md、system-reminder-read-truncation-retry-guidance.md、system-prompts/system-reminder-large-file-full-content-reading-guidance.md 等配套提醒协同最终保证了 Agent 产出的每一条结论都有明确的读取证据边界。理解并遵循这一机制是使用 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点击查看免费下载相关推荐Claude Code 上下文压缩Compaction机制解密recent-messages 分析指令与 analysis/summary 摘要流程Claude Code 上下文压缩Compaction机制解密recent messages 分析指令与 analysis / summary 摘要流文档提示工程人工智能claude-code-system-prompts 解析Away Summary Generation 离场摘要提示词的设计与实现claude code system prompts 解析Away Summary Generation 离场摘要提示词的设计与实现 导读 agent pro文档提示工程人工智能Claude Code 浏览器扩展未连接提醒系统提示机制与完整排查指南Claude Code 浏览器扩展未连接提醒系统提示机制与完整排查指南 当 Claude Code 无法与浏览器扩展建立连接时系统会注入一条名为 Syst文档提示工程人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考