★ FEATURED ARTICLE 文档提示工程人工智能【免费下载链接】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与Memory是两种容易被混淆的持久化手段但它们的定位截然不同Plan 服务于当前会话内即将开展的实施任务核心目的是与用户对齐方案Memory 则服务于跨会话长期可复用的事实与偏好。本文基于仓库中的 system-prompt-plan-vs-memory-guidance.md 展开梳理何时用 Plan 而非 Memory何时更新 Plan 而非新建 Memory的完整决策规则并结合仓库内 Memory 文件格式、保存排除项与 Tasks 工具说明给出可落地的判断标准与反模式清单。一、核心规则一条提示词如何规定 Plan 与 Memory 的分工关联文档 system-prompt-plan-vs-memory-guidance.md 全文只承载一条规则却精准划定了两种场景When to use or update a plan instead of memory: If you are about to start a non-trivial implementation task and would like to reach alignment with the user on your approach you should use a Plan rather than saving this information to memory. Similarly, if you already have a plan within the conversation and you have changed your approach persist that change by updating the plan rather than saving a memory.拆解这条规则可以得到两个明确的判定条件场景正确动作错误动作即将开始一个非平凡non-trivial的实现任务且希望与用户就方案达成一致使用Plan呈现/对齐方案把方案细节写入 Memory对话中已存在 Plan且后续改变了实现思路更新现有 Plan以固化新方案新建一条 Memory 记录方案变更规则的关键词是non-trivial implementation task与reach alignment with the user。也就是说Plan 的本质是实施前的对齐载体——它属于当前会话的工作上下文而不是需要沉淀到跨会话记忆中的长期知识。二、Plan 与 Memory 的定位差异为什么不能混用要理解这条规则需要先看清两者在 Claude Code 系统中的根本定位。仓库中的 system-prompt-memory-instructions.md 明确指出Memory 是基于文件的持久化记忆遵循一个文件存放一个事实的格式--- name: short-kebab-case-slug description: one-line summary, used to decide relevance during recall metadata: type: user | feedback | project | reference --- the fact; for feedback/project, follow with **Why:** and **How to apply:** lines. Link related memories with [[their-name]].据此可以从四个维度对比两者维度PlanMemory生命周期当前会话内随任务推进而演进跨会话持久化供未来对话召回内容类型即将执行的任务方案、步骤、取舍用户偏好、项目事实、反馈、参考知识核心目的与用户对齐alignment后进入实施在未来的对话中复用recall变更方式方案变化时原地更新 Plan事实变化时更新对应 Memory 文件由此可以理解规则背后的设计逻辑把一次性的实施方案写进 Memory会把本应属于会话工作上下文的临时决策污染成长久知识而把跨会话才有效的事实塞进 Plan又会因会话结束而丢失。两者各自承担不同的职责混用会导致记忆库被噪声填满或关键方案在会话中断后无法找回。三、何时用 Plan对齐优先于沉淀按照规则触发使用 Plan 而非 Memory的条件是同时满足以下三点任务即将开始方案处于将要实施阶段而非已经完成阶段任务非平凡涉及多步骤、多个改动点、架构取舍或需要用户拍板的决策不能一步完成需要与用户对齐你希望用户先确认思路再动手实现。典型例子重构一个跨多文件的模块、引入新的架构模式、改动公共接口。这类任务开始前把我要怎么做、分几步、有哪些取舍放进 Plan 供用户审阅比写进 Memory 更合适——因为 Memory 的description字段设计用途是在召回时判断相关性见 system-prompt-memory-instructions.md而不是承载待实施的步骤清单。四、何时更新 Plan方案演进以 Plan 为准规则的第二个场景常被忽略对话中已经存在 Plan而后实现思路发生变化。此时必须更新 Plan 而不是保存一条新的 Memory。这覆盖了两类常见情况范围调整用户中途追加/删减了需求Plan 中的步骤需要随之增删技术路线变更原定方案如缓存策略、依赖选型、目录结构被证明不可行需要替换。原因在于Plan 是当前会话中方案真相的唯一权威来源。如果一边更新 Plan、一边把新思路另存为 Memory会出现同一会话内方案的双份记录造成矛盾与召回混乱。正确的做法是让 Plan 始终反映最新方案而 Memory 只记录那些即使没有这个任务、未来也值得知道的信息。五、横向边界Plan、Tasks 与 Memory 三者如何区分Plan 与 Memory 的边界还可以借助仓库中另一条姊妹规则 system-prompt-tasks-vs-memory-guidance.md 来补全。它规定了 Tasks任务清单与 Memory 的分工When you need to break your work in current conversation into discrete steps or keep track of your progress use tasks instead of saving to memory. Tasks are great for persisting information about the work that needs to be done in the current conversation, but memory should be reserved for information that will be useful in future conversations.将三条规则合并可以得到完整的决策树信息属于当前会话的“待办实施” ├─ 需要先与用户对齐整体方案非平凡任务 → 使用/更新 Plan ├─ 只需要拆解步骤、跟踪执行进度 → 使用 TasksTodoWrite └─ 需要记录已完成工作的状态 → 使用 Tasks 标记 completed 信息属于未来会话也要用的长期知识 └─ 用户偏好、项目事实、可复用经验 → 保存到 Memory其中 Tasks 的落地工具行为在 tool-description-todowrite.md 中有明确约定多步骤3 步及以上、非平凡任务应主动建立任务清单单一琐碎任务则不应使用。这与 Plan 规则形成了互补——Plan 回答做什么、怎么做方案层Tasks 回答做到哪一步了执行层Memory 回答下次还要知道什么知识层。六、反模式清单三种容易踩的坑结合规则与仓库中 system-prompt-memory-save-exclusions.mdWhat NOT to save in memory的排除思想以下是实践中应当避免的行为把一次性实施方案写进 Memory任务完成、会话结束后这份当时怎么做的方案对未来的用户偏好与项目事实没有复用价值反而污染记忆检索方案变更后另存新 Memory 而非更新 Plan造成同会话内新旧方案并存召回时无法判断哪个是当前真相将长期偏好塞进 Plan如用户偏好 TypeScript 而非 JavaScript这类跨会话事实写入 Plan 会随会话结束丢失应当保存为metadata.type: user的 Memory 文件。判断的元原则只有一句话凡是接下来要做的事走 Plan/Tasks凡是以后也要知道的事走 Memory。七、小结system-prompt-plan-vs-memory-guidance.md 虽短却是 Claude Code 提示词体系中信息去向决策的关键一环它把方案对齐Plan与知识沉淀Memory彻底分开并要求方案演进时以更新 Plan为唯一动作。配合 Tasks 规则、Memory 文件格式 与 保存排除项开发者可以形成一套清晰的判断习惯实施前对齐用 Plan执行中跟踪用 Tasks跨会话复用才写 Memory——三者各司其职记忆库才会保持干净、可靠、可检索。赞分享文档提示工程人工智能【免费下载链接】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 任务跟踪与记忆取舍指南Tasks vs Memory 的正确使用边界Claude Code 任务跟踪与记忆取舍指南Tasks vs Memory 的正确使用边界 导读 Claude Code 同时提供了任务跟踪TodoW文档提示工程人工智能Claude Code System Prompts 解析Plan File Reference 系统提醒与计划文件续作机制Claude Code System Prompts 解析Plan File Reference 系统提醒与计划文件续作机制 Plan File Refere文档提示工程人工智能claude-code-system-prompts 仓库导读Claude Code 系统提示词的提取、结构与使用指南claude code system prompts 仓库导读Claude Code 系统提示词的提取、结构与使用指南 本指南围绕仓库根目录下的 CLAUDE文档提示工程人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
