ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Claude Code 项目记忆保存指南:何时记录「谁、为什么、何时」并正确换算绝对日期

2026/10/7 2:11:31 拓冰建站 浏览量
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点击查看免费下载导读system-prompt-project-memory-save-guidance.md是 Claude Code 系统提示词中关于「项目记忆Project Memory保存时机」的核心规则当你在工作中获知「谁在做什么、为什么这么做、截止何时完成」这类会随时间快速变化的状态时应当及时写入项目记忆并在保存时把用户消息中的相对日期如 Thursday换算为绝对日期如2026-03-05。本文将围绕这一规则展开结合仓库中完整的记忆体系文档与源码讲解项目记忆的定义、触发保存的场景、绝对日期换算的工程动机、记忆正文结构Why / How to apply、索引维护、以及与之配合的反馈记忆、任务与记忆的边界帮助你准确掌握 Claude Code 持久化记忆的写入时机与规范。一、项目记忆是什么非代码可推导的项目上下文在深入「何时保存」之前先明确「保存什么」。仓库中 system-prompt-personal-project-memory-description.md 与 system-prompt-team-project-memory-description.md 给出了完全一致的定义你在项目中了解到的、关于正在进行的工作、目标、计划、缺陷或事件的信息这些信息无法从代码或 git 历史中直接推导出来。这意味着项目记忆的定位是「代码之外的隐性上下文」——例如某个模块为什么设计成现在这样、某次事故的来龙去脉、某个迭代的截止时间、某位同事或用户自己当前负责哪部分工作。它们帮助 Agent 理解用户在当前工作目录中工作的更广阔背景与动机而不仅仅是代码本身能呈现的表面事实。正因如此本项目记忆保存指南所覆盖的信息谁在做什么、为什么、何时截止恰好是代码中通常看不到、但对协作和后续对话至关重要的部分。二、何时保存三类「状态型事实」的触发条件关联文档 system-prompt-project-memory-save-guidance.md 的核心规则只有一句但信息密度很高When to save当你获知「谁在做什么who is doing what、为什么这么做why、何时完成by when」时应当保存项目记忆。分解来看这对应三种典型触发场景who is doing what——任务归属例如张工正在重构支付模块、我负责本季度迁移数据仓库why——动机与背景例如之所以先做 A 再做 B是因为上游依赖尚未就绪、这个接口保留旧签名是为了兼容老客户端by when——时间约束例如新版本必须在周五前发布、下周一要给客户演示原型。该文档特别强调这些状态变化相对较快These states change relatively quickly所以 Agent 应尽量保持对这些信息的理解是最新的。这句话点明了项目记忆的动态属性——与稳定的代码事实不同任务归属和截止时间会随着协作推进不断更新Agent 需要在每次对话中主动刷新自己的认知并在状态变化时及时更新已有记忆而不是只做一次性写入。三、绝对日期换算让记忆在时间流逝后仍可解读关联文档给出了项目记忆保存中最容易出错、也最具工程价值的一条细则保存时始终将用户消息中的相对日期换算为绝对日期例如 Thursday → 2026-03-05这样记忆才能在时间流逝之后仍然保持可解读interpretable。这条规则的动机非常直观相对日期下周四、两周后、明天在写入那一刻是有意义的但记忆是跨会话持久化的。当未来某次对话召回这条记忆时当时的周四早已不是当前的周四相对表达会迅速失真甚至产生误导换算为绝对日期2026-03-05这类 ISO 风格日期后无论何时被召回其时间语义都保持确定未来会话中的 Agent 可以据此判断该截止时间是否已过期、任务状态是否需要更新。这与 system-prompt-memory-persistence-scope.md 中「记忆可以被未来会话召回」的定位完全呼应——正因为记忆的生命周期跨越多个会话写入时就必须以「未来任何时刻读取都不产生歧义」为标准。实操建议保存截止时间时统一使用YYYY-MM-DD形式的绝对日期避免使用今天/明天/下周等相对表达若用户消息中同时出现相对日期与已知的今天日期应基于当前会话日期完成换算后再写入在 Why 行中补充换算依据如用户 2026-03-02 说明周四前完成便于未来会话核对时效性。四、项目记忆的正文结构事实 Why How to apply保存项目记忆不只是记录一个事实还要让它对未来的自己可判断、可应用。仓库中 system-prompt-project-memory-body-structure.md 规定了项目记忆正文的固定结构以事实或决策开头然后是Why:行动机——通常是约束、截止时间或利益相关方的要求和How to apply:行这条记忆应如何影响你的建议。项目记忆衰减得很快所以 why 能帮助未来的你判断这条记忆是否仍然承重load-bearing。三段式结构的价值在于事实/决策先行保证记忆被召回时核心信息一目了然Why:记录动机动机往往是约束、截止时间或干系人诉求这些信息会随项目推进而失效或改变。有了 why未来会话可以判断这条记忆的支撑条件是否还存在从而决定继续遵守、更新还是废弃How to apply:指明应用方式明确这条记忆应如何影响 Agent 后续的建议与行为避免记了但不知道该怎么用。这一结构同样体现在通用记忆模板中见 system-prompt-memory-instructions.md--- 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]].从该模板可以看到项目记忆的metadata.type为project正文需要补充 Why 与 How to apply 两行并且可以通过[[their-name]]双链语法关联相关记忆。示例--- name: payment-module-rewrite-ownership description: 支付模块重构由张工负责截止 2026-03-05 metadata: type: project --- 张工正在重构支付模块who is doing what。 **Why:** 支付模块技术债严重且上游结算服务将于 2026-03-10 停用旧协议约束/截止时间。 **How to apply:** 涉及支付模块的改动建议先与张工对齐评估工作量时需考虑 2026-03-05 的截止时间不要建议引入依赖旧协议的新代码。五、保存后的配套动作更新索引、保持最新项目记忆写入后并非结束配套规则要求维护记忆索引。根据 system-prompt-memory-index-pointer-instructions.md 与 system-prompt-combined-memory-index-pointer-instructions.mdStep 2需要在索引文件${INDEX_FILE}中为该记忆文件添加一行指针索引条目格式为- Title — one-line hook每行约 150 字符以内索引本身不是记忆它没有 frontmatter绝不能把记忆正文直接写进索引文件单一索引同时索引私有记忆与团队记忆私有记忆使用file.md路径团队记忆使用team/file.md路径。结合关联文档这些状态变化相对较快尽量保持理解最新的要求当任务归属或截止时间发生变化时应当更新对应的项目记忆文件而不是堆积多条相互矛盾的记忆必要时同步调整索引中的 one-line hook。六、边界与配合不要混淆记忆的类型6.1 项目记忆 vs 反馈记忆仓库中另一份保存指南 system-prompt-feedback-memory-save-guidance.md 定义了反馈记忆type: feedback的触发时机用户纠正你的做法不是那样、不要做 X或确认某个非常规做法有效对就是这样时保存。项目记忆关注的是项目内的事实与状态反馈记忆关注的是用户对你工作方式的指导。两者都以 Who/Why/When 类动态信息为原料但归属不同前者描述项目世界后者描述协作规则。保存时应根据信息性质选择正确的类型。6.2 记忆 vs 任务Taskssystem-prompt-tasks-vs-memory-guidance.md 划清了边界当需要在当前会话中把工作拆成离散步骤、或跟踪当前会话的进度时使用任务tasks而不是记忆。任务适合持久化当前会话内需要完成的工作而记忆应保留给对未来会话有用的信息。因此今天要做哪几步、现在做到哪一步这类会话内状态应写入任务清单而张工负责重构、周五截止这类未来会话仍需要的事实才写入项目记忆。6.3 记忆的持久化范围system-prompt-memory-persistence-scope.md 明确记忆是可跨会话召回的一种持久化机制不应用于保存只在当前会话内有用的信息。这与绝对日期换算规则同源——跨会话持久化决定了记忆必须面向未来书写。七、仓库中的完整证据链本文所有规则均可在当前仓库对应文件中核验保存时机主规则system-prompt-project-memory-save-guidance.mdwho/what/why/by when 绝对日期换算项目记忆定义system-prompt-personal-project-memory-description.md、system-prompt-team-project-memory-description.md正文结构system-prompt-project-memory-body-structure.md通用记忆模板与类型system-prompt-memory-instructions.md索引维护system-prompt-memory-index-pointer-instructions.md、system-prompt-combined-memory-index-pointer-instructions.md反馈记忆时机system-prompt-feedback-memory-save-guidance.md记忆与任务边界system-prompt-tasks-vs-memory-guidance.md持久化范围system-prompt-memory-persistence-scope.md。结语「谁在做什么、为什么、何时完成」是跨会话协作中最容易失真的三类信息。Claude Code 通过项目记忆保存指南为 Agent 设定了明确的写入时机——及时保存、随状态变化刷新并且强制将相对日期换算为绝对日期确保记忆在时间流逝后依然可解读。配合 Why / How to apply 的正文结构、索引维护规则以及与任务/反馈记忆的边界划分这套规则构成了一套完整、可操作的跨会话上下文管理方案值得在实际项目中落地实践。赞分享文档提示工程人工智能【免费下载链接】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点击查看免费下载相关推荐Mopidy用户活动日志记录谁在何时播放了什么Mopidy用户活动日志记录谁在何时播放了什么 引言Mopidy活动追踪的痛点与解决方案 你是否曾遇到过这些问题家庭音响系统中多用户共享播放时无法追溯谁音视频后端Claude Code Auto Memory 操作指南何时查询、何时保存、如何防止记忆污染 —— 基于 gpt-computer-assistant 仓库的 AI 协作记忆纪律Claude Code Auto Memory 操作指南何时查询、何时保存、如何防止记忆污染 —— 基于 gpt computer assistant 仓库的人工智能大模型AI AgentAgent 框架自主智能体工具调用RAGAgent 记忆Agent 编排MemPalace Hooks 实战指南为 Claude Code、Codex 与 Antigravity 配置 AI 对话自动记忆保存MemPalace Hooks 实战指南为 Claude Code、Codex 与 Antigravity 配置 AI 对话自动记忆保存 MemPalace人工智能AI 应用RAGAgent 记忆MCP 服务本地部署上一篇5分钟快速搭建专业地理信息服务平台Docker GeoServer 终极指南下一篇BTstack蓝牙协议栈快速上手指南与终极开发技巧创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考