Claude Code System Prompts 解析:Plan File Reference 系统提醒与计划文件续作机制

发布时间:2026/10/8 1:35:56
Claude Code System Prompts 解析:Plan File Reference 系统提醒与计划文件续作机制 文档提示工程人工智能【免费下载链接】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点击查看免费下载Plan File Reference 是 Claude Code 系统提示system prompt体系中的一条系统提醒System Reminder用于在存在来自 Plan 模式plan mode的计划文件时把计划文件的路径与完整内容注入到模型上下文中并指示模型“若该计划与当前工作相关且尚未完成则继续执行它”。本文以仓库中的模板文件 system-reminder-plan-file-reference.md 为主体结合 Plan 模式工作流、批准通知、重入提醒等关联模板完整剖析这条提醒的模板结构、变量语义、触发场景与决策逻辑帮助开发者理解 Claude Code 如何在会话之间传递和续作计划。一、系统提醒在 Claude Code 中的定位Claude Code 的系统提示不是单一文本而是由多种构件组合而成系统提示System Prompt、工具描述Tool Description、Agent 提示Agent Prompt、技能Skill以及系统提醒System Reminder。系统提醒是随会话事件动态注入的短指令块用于在特定时刻向模型补充上下文与行为约束。Plan File Reference 属于system-reminder-*前缀模板族其 frontmatter 元信息如下name: System Reminder: Plan file reference description: Reference to an existing plan file ccVersion: 2.1.18 variables: - ATTACHMENT_OBJECTccVersion: 2.1.18表明该模板随 Claude Code 2.1.18 版本引入且根据仓库说明所有系统提示均随每个 Claude Code 版本持续更新。它只声明了一个变量ATTACHMENT_OBJECT——即这条提醒的内容完全由调用方传入的“附件对象”驱动。二、模板正文逐段解析模板正文非常精炼仅有四行有效内容A plan file exists from plan mode at: ${ATTACHMENT_OBJECT.planFilePath} Plan contents: ${ATTACHMENT_OBJECT.planContent} If this plan is relevant to the current work and not already complete, continue working on it.1. 路径声明行第一行注入计划文件的存放路径ATTACHMENT_OBJECT.planFilePath。这行信息的作用是给模型一个明确的文件锚点使其在需要时可以定向读取、引用或更新该文件。2. 计划内容块ATTACHMENT_OBJECT.planContent直接嵌入计划的完整文本。与 compact-file-reference.md 中“文件内容过大不包含、仅提示用 Read 工具按需读取”的处理方式不同Plan File Reference 走的是全文内联策略——计划文本被直接拼入上下文模型无需额外工具调用即可立即看到计划的全部细节。这符合“计划是当前工作的执行蓝本”这一角色定位计划应尽可能短小精炼见下文 Phase 4 规范因此全文注入的上下文成本可控。3. 行为指令行最后一行是这条提醒的核心行为约束If this plan is relevant to the current work and not already complete, continue working on it.这是一条条件性续作指令包含两个前置判定与一个动作相关性判定该计划是否与当前工作相关relevant to the current work完成度判定该计划是否尚未完成not already complete动作两者均满足时继续按计划推进。两条判定都不满足时提醒不强制模型执行计划模型可依据用户当前意图重新决策。三、ATTACHMENT_OBJECT 变量的语义与来源模板通过${ATTACHMENT_OBJECT.planFilePath}与${ATTACHMENT_OBJECT.planContent}两处引用同一对象的不同字段说明调用方在注入时需提供如下结构{ planFilePath: /path/to/plan/file.md, // 计划文件路径 planContent: ## Context\n...计划全文 }从仓库其他模板可以印证ATTACHMENT_OBJECT是系统提醒族的通用注入载体——compact-file-reference.md 同样声明了ATTACHMENT_OBJECT变量字段为ATTACHMENT_OBJECT.filenamelines-selected-in-ide.md、file-opened-in-ide.md 等提醒也复用同一机制。可见这是 Claude Code 向提醒模板传入“上下文附件”的统一数据接口不同提醒消费该对象的不同字段。四、触发时机计划文件存在的会话恢复场景结合关联模板可以还原这条提醒的触发场景。在 Claude Code 的 Plan 模式工作流见 system-reminder-plan-mode-workflow.md中模型被要求把计划增量地写入唯一的可编辑文件Plan File Info 区块除此之外只能执行只读动作。当计划获批后system-reminder-plan-approved.md 会通知“User has approved your plan”并给出计划保存路径与获批内容允许开始编码。Plan File Reference 则服务于计划文件已存在的另一类时刻当模型在后续轮次例如新会话、上下文压缩后、或用户以任意方式重新唤起工作时面对一个已存在于磁盘上的计划文件系统便注入该提醒把“计划从哪来、内容是什么、该不该继续做”一次性交代清楚。这一触发逻辑与 system-reminder-plan-mode-re-entry.md 高度互补——后者处理“用户退出 Plan 模式后再次进入”的场景并给出了更细化的决策规则不同任务即使是相似或相关的请求也应覆盖overwrite旧计划重新开始同一任务的延续明确是同一任务的延续或精化时在清理过时段落的基础上修改现有计划。两相对照可以看到 Claude Code 的完整意图计划文件是跨轮次、跨模式传递工作上下文的第一等公民而 Plan File Reference 负责在“无需进入 Plan 模式、直接续作”时把计划呈现给模型。五、与 Plan 模式完整生命周期的联动把 Plan File Reference 放回整个 Plan 模式生命周期中可以清晰地看到它在链条中的位置进入 Plan 模式system-reminder-plan-mode-is-active.md 声明只读约束要求模型充分探索代码库、权衡多种方案、必要时用 AskUserQuestion 澄清并在就绪时调用 ExitPlanMode 提交计划撰写计划system-prompt-phase-four-of-plan-mode.md 规定最终计划的写法——以Context 章节开头说明变更动机只保留推荐方案文件既要能快速扫描又要足以执行点名关键待改文件并给出代表性路径而非逐文件枚举复用已发现的既有函数与工具附路径最后必须包含端到端验证章节提交审批tool-description-exitplanmode.md 说明 ExitPlanMode 不接收计划正文参数而是直接读取已写入的计划文件——这正解释了为何计划文件的路径与内容对模型而言至关重要批准system-reminder-plan-approved.md 通知计划获批、给出保存路径与获批内容若用户编辑过则以 “Approved Plan (edited by user)” 标注后续会话续作Plan File Reference 在此登场——会话中再次面对该计划文件时提醒模型“相关且未完成则继续”。若处于子代理场景system-reminder-plan-mode-is-active-subagent.md 提供了简化版约束通过PLAN_MODE_CONTEXT.planExists区分“已有计划文件可读并用 Edit 工具增量修改”与“尚无计划文件需用 Write 工具在指定路径创建”两种情形并强调只读限制凌驾于其他任何指令之上。六、两条判定的工程意义“相关且未完成则继续”这一指令本质上是把计划续作的决策权交给模型对当前意图的理解。从工程实现角度可以推断其设计意图避免盲目执行计划文件可能来自较早的会话或不同的任务分支若模型无条件执行可能做出与用户当前诉求无关的改动避免重复规划若计划相关且未完成模型无需重新探索和起草直接沿用既有计划推进即可节省上下文与轮次保持渐进式计划Plan 模式要求“增量构建计划”因此计划文件在获批前可能已被多次编辑Plan File Reference 提供的planContent快照是模型看到的最新权威版本。需要强调的是本条提醒并未给出“不相关或已完成”时的替代指令——此时模型应回到对用户消息的常规处理这也符合系统提醒“补充约束、不喧宾夺主”的设计哲学。七、对 Agent 与 LLM 消费端的启示对于正在构建基于 Claude Code 的自动化流程、或希望理解该系统提示集合的开发者Plan File Reference 模板提供了几个可复用的模式模板与数据分离提醒模板只声明${ATTACHMENT_OBJECT.*}占位符实际数据由宿主运行时注入模板可随版本演进而无需改动注入方协议条件指令内联把决策条件相关性、完成度写进提醒正文而非外部逻辑让模型基于完整上下文自主判断减少宿主侧的硬编码分支路径 内容双冗余同时给出文件路径与内联内容既保证模型零成本读取又保留按需回读文件、增量编辑的锚点家族式管理仓库中以system-reminder-*前缀组织的大量模板plan-mode-workflow、plan-approved、plan-mode-re-entry、compact-file-reference 等构成了一个可组合的提醒体系各自聚焦单一事件再由宿主按状态机组合注入——这套模式同样适用于自定义 Agent 的系统提示工程。八、结语Plan File Reference 虽只有寥寥数行却是 Claude Code 计划持久化机制的关键一环它以ATTACHMENT_OBJECT为载体把计划文件的路径与全文注入上下文并用一条条件指令让模型在“相关且未完成”时无缝续作。理解它也就理解了 Claude Code 如何在 Plan 模式的规划、审批、重入与后续执行之间通过一个计划文件维持工作上下文的连续性。若要深入完整工作流可继续阅读 system-reminder-plan-mode-workflow.md、system-reminder-plan-approved.md 与 system-reminder-plan-mode-re-entry.md。赞分享文档提示工程人工智能【免费下载链接】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 子代理 Plan Mode 系统提醒深度解析只读约束、计划文件机制与澄清提问Claude Code 子代理 Plan Mode 系统提醒深度解析只读约束、计划文件机制与澄清提问 导读 本篇文章围绕开源仓库 claude code sy文档提示工程人工智能Claude Code 系统提示解析File Already in Context 提醒机制与文件读取优化Claude Code 系统提示解析File Already in Context 提醒机制与文件读取优化 导读 在 Claude Code 的长对话与文件操文档提示工程人工智能Claude Code 团队协作中的计划审批等待机制深入解析 Plan Awaiting Team-Lead Approval 系统提醒Claude Code 团队协作中的计划审批等待机制深入解析 Plan Awaiting Team Lead Approval 系统提醒 导读 本文聚焦 Cl文档提示工程人工智能上一篇5个mini-css-extract-plugin在大型项目中的高效应用策略下一篇批处理转EXE新体验如何用这款工具提升脚本安全性与分发效率创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考