尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
Claude Code 上下文压缩(Compaction)机制解密:recent-messages 分析指令与 `<analysis>`/`<summary>` 摘要流程
文档提示工程人工智能【免费下载链接】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 中提取的 Claude Code 系统提示词原文深入解析会话上下文压缩conversation compaction时用于分析最近消息的指令——它规定了模型在生成最终摘要前必须完成的思维整理流程、必须逐项识别的信息类别以及安全相关指令必须逐字保留的硬性要求。读完本文你将理解 Claude Code 压缩机制的内部工作方式、analysis与summary标签的职责分工以及这套指令如何保证压缩后的会话可以无损续接。一、背景Claude Code 为什么需要压缩Claude Code 的主系统提示词并非单一字符串而是由数百个条件注入的片段、27 个内置工具描述、子代理提示词和大量 AI 工具函数提示词动态组装而成见 README.md。当一次会话的上下文接近模型上下文窗口上限时Claude Code 会触发上下文压缩compaction用一段结构化摘要替换掉冗长的对话历史让会话在有限窗口内继续。从>analysis [思维整理过程按时间顺序梳理最近消息逐项识别下文第 18 类信息] /analysis summary [结构化的最终摘要将被放置在续接会话的开头替代被压缩掉的对话历史] /summary这一结构与 agent-prompt-summarization-no-tools-guard.md 中规定的整个响应必须是纯文本一个analysis块后跟一个summary块完全一致。值得注意的是该 guard 同时要求摘要代理禁止调用任何工具Read、Bash、Grep、Glob、Edit、Write 等一律禁止因为上下文已经全部在会话中调用工具只会浪费唯一的回合——这从侧面说明压缩摘要代理是一个纯粹的回顾 归纳过程不产生任何新的外部副作用。三、逐项拆解分析过程中必须识别的信息类别原指令要求按**时间顺序chronologically**分析最近的消息并针对每一部分彻底识别以下信息。这八类信息构成了压缩摘要的必检清单1. 用户的明确请求与意图explicit requests and intents逐条还原用户说了什么、想要什么。这是摘要的第 1 节Primary Request and Intent的直接素材。在 system-prompt-partial-compaction-instructions.md 中这一要求被表述为详细捕获用户的明确请求和意图in detail因为后续工作必须严格贴合用户真实诉求展开。2. 你处理用户请求的方法your approach记录当时采用的处理路径与策略是直接实现、先调研再动手还是拆分为多个步骤这部分为续接会话提供我是怎么做的的上下文避免重启后重新摸索。3. 关键决策、技术概念与代码模式key decisions, technical concepts and code patterns例如架构选型理由、某个算法/框架的选择、遵循的代码组织模式等。在 agent-prompt-conversation-summarization-with-additional-instructions.md 中对应Key Technical Concepts一节明确要求列出讨论到的重要技术概念、技术和框架。4. 具体细节specific details这是最容易在压缩中丢失、也最影响续接质量的一类包括文件名file names完整代码片段full code snippets函数签名function signatures文件编辑file edits原始文档特别强调要包含完整代码片段而不是省略号式概括。这与 partial compaction 指令中在适用处包含完整代码片段include full code snippets where applicable的要求相互印证——只有保留具体代码续接会话才能直接在正确位置继续修改而不是重新生成或猜测。5. 遇到的错误及修复方式errors and how you fixed them记录踩过的坑和对应的修复手段。这在多个摘要提示词中都是必选项agent-prompt-recent-message-summarization.md 的Errors and fixes一节同样要求列出遇到的错误及修复方法。保留错误历史的意义在于续接会话可以避开同样的陷阱避免重复劳动和重复犯错。6. 用户的具体反馈specific user feedback指令要求特别关注收到的用户反馈尤其是用户让你以不同方式做事的情况if the user told you to do something differently。用户的纠正往往蕴含隐性的偏好或约束——比如不要用这种写法应该先写测试这个参数应该这样传——它们是比任何代码更重要的活的需求必须完整落入摘要。7. 安全相关的指令或约束security-relevant instructions or constraints——最高优先级这是全文最强调的一点。指令明确要求记录用户提出的安全相关指令或约束并举例说明包括需要避免的敏感文件或数据sensitive files or data to avoid不得执行的操作operations that must not be performed凭据或机密处理规则credential or secret handling rules并且有一个硬性要求这些内容必须在摘要中逐字保留preserved verbatim in the summary以便在压缩之后继续生效。也就是说安全约束不允许被概括、转述或大意化必须原样抄录。这一要求在 system-prompt-partial-compaction-instructions.md 中同样以Preserve any security-relevant instructions or constraints verbatim so they remain in effect after compaction的形式出现是 Claude Code 压缩机制中一致的安全底线压缩可以丢失任何开发细节但不能丢失任何安全边界。8. 双重检查double-check分析完成后指令要求对技术准确性与完整性做第二轮检查逐一确认上述每个要素是否都被充分覆盖addressing each required element thoroughly。这一步相当于摘要生成前的验收清单防止遗漏关键信息。四、这套指令在整个压缩体系中的位置这份分析指令不是孤立存在的它在 Claude Code 的压缩体系中被作为可注入变量使用。通过源码结构可以推断见 system-prompt-partial-compaction-instructions.md 的 frontmatter完整压缩流程的提示词大致为Your task is to create a detailed summary of this conversation... ${SUMMARY_ANALYSIS_INSTRUCTIONS} ← 注入本文讲解的分析指令 Your summary should include the following sections: 1. Primary Request and Intent 2. Key Technical Concepts 3. Files and Code Sections 4. Errors and fixes 5. Problem Solving 6. All user messages 7. Pending Tasks 8. Work Completed 9. Context for Continuing Work与之并列的还有多个分工明确的提示词片段提示词文件分工system-prompt-analysis-instructions-for-full-compact-prompt-recent-messages.md全量压缩full compact场景下仅对最近消息进行analysis分析system-prompt-partial-compaction-instructions.md用户选择只压缩部分对话时的摘要指令包含 9 节结构化摘要格式agent-prompt-recent-message-summarization.md只总结最近一段消息更早的保留上下文保持原样不总结对应RECENT_SUMMARY_ANALYSIS_INSTRUCTIONS变量system-prompt-context-compaction-summary.md面向 SDK 的压缩摘要提示词采用任务概览 / 当前状态 / 重要发现 / 下一步 / 保留上下文五段式agent-prompt-conversation-summarization-with-additional-instructions.md支持注入自定义附加指令ADDITIONAL_INSTRUCTIONS的扩展摘要提示词agent-prompt-summarization-no-tools-guard.md共享前缀禁止调用任何工具要求纯文本analysissummary输出其中特别值得注意的是最近消息定位这份分析指令的 description 明确写着 summarizingonly recent messagesduring conversation compaction。它与 agent-prompt-recent-message-summarization.md 的定位一致——更早的保留上下文earlier retained context保持完整不动分析只针对其后的新消息展开。这与全量压缩整段历史都被摘要替换形成对照Claude Code 依据用户选择或上下文压力在只压最近消息与全量压缩两种模式间切换。五、实战视角一份合格压缩摘要应当呈现的形态综合本文的指令与 partial compaction 指令中的示例模板一个实际产出去掉分析过程的最终摘要大致会呈现如下结构读者可以据此理解分析指令最终服务的对象summary 1. Primary Request and Intent: [用户核心请求与成功标准逐条还原] 2. Key Technical Concepts: - [技术概念 1] - [技术概念 2] 3. Files and Code Sections: - [文件名 1] - [该文件为何重要] - [完整代码片段] 4. Errors and fixes: - [错误描述]: [修复方式] 5. Problem Solving: [已解决问题与进行中的排查] 6. All user messages: - [全部非工具结果的用户消息] - 安全相关指令或约束原样逐字保留verbatim 7. Pending Tasks: - [待办任务] 8. Work Completed: [本段对话结束时的完成情况] 9. Context for Continuing Work: [后续消息所需的关键上下文与决策] /summary请注意第 6 节中的安全约束必须原样抄录其余各节可以概括但安全边界不允许大意化。同时这份摘要会被放置在续接会话的开头This summary will be placed at the start of a continuing session见 partial compaction 指令后续更年轻的消息会紧随其后——因此摘要的完整性与准确性直接决定续接会话能否无缝接管任务。六、设计原理为什么压缩前必须先有analysis从系统设计角度可以推断analysis环节承担了两个关键职责对抗压缩即遗忘的信息损耗。直接写摘要容易遗漏细节而先按八类清单逐项梳理、再落笔总结相当于给模型一次强制回顾确保文件名、函数签名、完整代码、错误修复这些高价值信息被显式提取而不是隐没在叙事里。让安全约束获得拷贝保护。只有先系统性地扫描每条用户消息中的安全相关内容敏感文件、禁止操作、凭据规则才能保证它们在摘要中逐字出现。这正是 Claude Code 在多轮长会话中持续维持安全边界的关键机制。七、适用前提与限制说明最后需要明确本文所述机制的适用边界本文内容以当前仓库提取的 Claude Code 提示词原文为准ccVersion 2.1.271 及配套版本不同 Claude Code 版本的提示词文本可能存在差异实际行为以你本机安装版本为准。仓库中的提示词由提取脚本从 Claude Code 编译产物中直接抽取因此与产品实际使用的字符串一致但部分提示词包含运行时注入变量如工具名列表、SUMMARY_ANALYSIS_INSTRUCTIONS等真实会话中的 token 数与文本细节会略有浮动README 中注明通常在 ±20 token 以内。压缩摘要代理被明确禁止调用工具、只做纯文本回顾分析指令本身不涉及任何对外部系统的写入操作本文也只介绍查看与理解方式。若要继续深入建议按以下路径阅读仓库原文先读 主分析指令再对照 partial compaction 指令 与 recent message summarization 指令 理解变量注入与两种压缩模式最后参考 context compaction summary 和 no-tools guard 补齐摘要格式与输出纪律即可完整掌握 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点击查看免费下载相关推荐fast-jev-compaction用 Jev 决策替代摘要式压缩的 Claude Code 上下文压缩插件fast jev compaction用 Jev 决策替代摘要式压缩的 Claude Code 上下文压缩插件 导读 fast jev compaction人工智能AI AgentAI 插件Agent 记忆上下文压缩的交接令牌Kimi Code agent-core-v2 的 compaction-summary-prefix 模板机制解析上下文压缩的交接令牌Kimi Code agent core v2 的 compaction summary prefix 模板机制解析 长对话总会触及模型上AI Agent代码智能体人工智能大模型CLIfast-jev-compaction Claude Code 插件用 Jev 逐条决策替代摘要式上下文压缩fast jev compaction Claude Code 插件用 Jev 逐条决策替代摘要式上下文压缩 本文介绍 fast jev compaction人工智能AI AgentAI 插件Agent 记忆上一篇Awoo Installer 三条安装通道跑通 Switch 游戏安装从零到出结果的完整路径下一篇mermaid 的文本到 SVG 三道门全解5 分钟彻底看懂流程图是怎么画出来的创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

DOM 元素搜索指南:掌握 JavaScript 教程中的 getElement* 与 querySelector* 方法

DOM 元素搜索指南:掌握 JavaScript 教程中的 getElement* 与 querySelector* 方法

文档/教程前端 【免费下载链接】en.javascript.info Modern JavaScript Tutorial 项目地址: https://gitcode.com/gh_mirrors/en/en.javascript.info 点击查看 免费下载 本文是 Modern JavaScript Tutorial(en.javascript.info)中 "Se…

📅 2026/10/6 7:29:58
KubeVirt 使用 kind-1.36 Provider 部署 Kubernetes 1.36 测试集群实战指南

KubeVirt 使用 kind-1.36 Provider 部署 Kubernetes 1.36 测试集群实战指南

云原生 【免费下载链接】kubevirt Kubernetes Virtualization API and runtime in order to define and manage virtual machines. 项目地址: https://gitcode.com/gh_mirrors/ku/kubevirt 点击查看 免费下载 导读 本文围绕 KubeVirt 仓库中 kubevirtci/cluster-u…

📅 2026/10/6 7:29:58
Forth 语言快速入门:基于 learnxinyminutes-docs 的栈式编程实战指南

Forth 语言快速入门:基于 learnxinyminutes-docs 的栈式编程实战指南

文档教程 【免费下载链接】learnxinyminutes-docs Code documentation written as code! How novel and totally my idea! 项目地址: https://gitcode.com/gh_mirrors/le/learnxinyminutes-docs 点击查看 免费下载 Forth 是由 Charles H. Moore 在 20 世纪 70 年代…

📅 2026/10/6 7:29:58
MORE NEWS

更多资讯

📰

GEMM 与 BLAS 全解:Tensor Core、CUDA、Transformer 的关系,各家 GPU 与框架的实现逻辑,以及投资机会

GEMM 与 BLAS 全解:Tensor Core、CUDA、Transformer 的关系,各家 GPU 与框架的实现逻辑,以及投资机会声明:本文作为笔者个人备忘的文章,不喜勿喷。本文由AI辅助生成,技术参数与市场信息整理自公开资料&…

📰

广州中小型企业如何做通勤班车

中小型广州企业做通勤班车,更现实的做法不是自购车辆,而是先算清需求,再用“固定线路加弹性运力”的组合向外采购服务,把车辆、司机、调度和应急交给专业运营方,自己只保留需求管理和成本审核两项职责。 判断标准可以用…

📰

2026上海企业员工班车租赁需要自有车辆吗

一、先把问题问准:自有车辆指什么 行政或采购在立项时问“要不要自己买车”,往往混着三件事:车辆产权归谁、车辆由谁调度、司机由谁管理。三者可以拆开组合,不必捆在一起。 三者全部收进来,就是重资产自营;…

📰

面试官:实现异步的 8 种方式,你知道几个?

一、为什么面试官总爱问异步异步编程几乎是每个后端开发绕不开的话题。无论是多线程并发、接口超时优化、批量任务处理,还是高并发场景下的性能提升,异步都在其中扮演核心角色。面试官问「实现异步的 8 种方式」,表面上考的是语法和 API 掌握…

📰

电源去耦网络设计与PI仿真E07

电源去耦网络设计与PI仿真E07 电源去耦网络设计与PI仿真:从理论到实战的全频段优化方案 核心要点: 去耦网络要做到全频段分层覆盖,低频靠大电容,中频靠10μF~47μF电容,高频靠0.1μF及以下小电容贴近芯片; 电容选型不能只看容量,ESR、ESL和自谐振频率才是决定滤波性…

📰

AI 助手只会回文字?一行命令让它学会「发自拍」——Clawra 上手与原理拆解

你有没有遇到过这种尴尬:在 Telegram 或者 Discord 上跟自己的 AI 助手聊天,随口来一句「你现在在干嘛?发张图看看」,然后它一本正经地回你——「抱歉,我没有实体,无法拍照」。 聊得再投缘,它也…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬