机制详解:定义、结构与保存规范)
文档提示工程人工智能【免费下载链接】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点击查看免费下载导读团队项目记忆Team Project Memory是 Claude Code 持久化记忆体系中的一种核心记忆类型用于记录工作目录中正在进行的工作、目标、专项任务initiatives、Bug 或事故等上下文信息这些信息无法从代码或 Git 历史中直接推导。本篇指南将带你理解团队项目记忆的准确定义、与个人项目记忆/用户反馈记忆的边界、标准文件结构与索引规范并结合本仓库claude-code-system-prompts收录了 Claude Code 各版本系统提示词的完整内容中的源码级系统提示词文件说明其保存时机与实战写法。一、团队项目记忆的定义与定位在 system-prompt-team-project-memory-description.md 中团队项目记忆被定义为Information that you learn about ongoing work, goals, initiatives, bugs, or incidents within the project that is not otherwise derivable from the code or git history. Project memories help you understand the broader context and motivation behind the work users are working on within this working directory.翻译并解读其核心语义记录对象正在进行的工作ongoing work、目标goals、专项/倡议initiatives、Bug 或事故incidents边界条件这些信息不能从代码或 Git 历史中推导not otherwise derivable from the code or git history——这是判断是否值得写入记忆的关键过滤器用途帮助 Claude Code 理解用户在该工作目录中开展工作的更广泛背景与动机broader context and motivation。也就是说团队项目记忆的本质是上下文与动机的补全代码只告诉 Agent系统当前是什么样Git 历史只告诉 Agent代码是如何演进的而团队项目记忆告诉 Agent我们为什么在做这件事、谁在做、做到什么时候。与个人项目记忆Personal Project Memory的异同对比 system-prompt-personal-project-memory-description.md可以看到其定义几乎相同——同样涵盖 ongoing work、goals、initiatives、bugs、incidents同样强调不能从代码或 Git 历史推导。两者的差异在作用域维度团队项目记忆个人项目记忆描述对象共享的、团队范围内的项目工作上下文与用户个人在该目录中工作相关的上下文适用范围多人协作的工作目录强调shared偏向单个用户的工作视角底层文件团队记忆目录如memory/team/下的文件个人/私有记忆目录下的文件索引方式团队索引或统一索引中的team/file.md路径私有索引中的file.md路径二、记忆文件标准格式与四种记忆类型团队项目记忆不是孤立的它运行在 Claude Code 统一的持久化文件记忆体系之下。system-prompt-memory-instructions.md 规定每条记忆是一个文件、只存放一个事实one file holding one fact并带有 frontmatter--- 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定义了四种记忆类型user关于用户本身的持久事实feedback用户对工作方式的指导详见下文用户反馈记忆project项目记忆团队项目记忆即属于这一类型在团队/共享范围内则是 team 维度reference参考资料类记忆。值得注意的是description字段在召回recall阶段用于判断相关性used to decide relevance during recall因此团队项目记忆的 description 必须是一行足够精炼、可检索的摘要。正文结构Fact → Why → How to applysystem-prompt-project-memory-body-structure.md 对 project 类记忆含团队项目记忆的正文结构给出了明确规范Lead with the fact or decision, then aWhy:line (the motivation — often a constraint, deadline, or stakeholder ask) and aHow to apply:line (how this should shape your suggestions). Project memories decay fast, so the why helps future-you judge whether the memory is still load-bearing.具体而言先写事实或决策the fact or decision开门见山直接陈述结论**Why:**行记录动机——通常是约束constraint、截止时间deadline或利益相关方的诉求stakeholder ask**How to apply:**行说明这条记忆应如何影响 Agent 后续的建议与行为用[[their-name]]语法链接相关记忆。为什么必须写 Why原文给出了关键理由项目记忆衰减很快Project memories decay fastWhy 行能帮助未来的自己future-you判断这条记忆是否仍然具有承重作用load-bearing——即判断它是否还值得被信任和引用。一个符合规范的团队项目记忆示例--- name: q3-migration-to-postgres description: 团队 Q3 将核心服务从 MySQL 迁移到 Postgres迁移期 API 需保持双写 metadata: type: project --- Q3 内核心服务将迁移到 Postgres迁移期间 API 保持 MySQL/Postgres 双写。 **Why:** 产品侧要求在 2026-09-30 前完成迁移且不能中断线上服务stakeholder 明确约束。 **How to apply:** 涉及数据库变更的建议应优先考虑双写兼容方案避免直接建议破坏性 DDL。三、什么时候保存团队项目记忆system-prompt-project-memory-save-guidance.md 明确了保存时机When you learn who is doing what, why, or by when. These states change relatively quickly so try to keep your understanding of this up to date. Always convert relative dates in user messages to absolute dates when saving (e.g., Thursday → 2026-03-05), so the memory remains interpretable after time passes.要点归纳触发条件当你了解到谁在做什么who is doing what、为什么why、截止何时by when时保存时效性这些状态变化相对较快change relatively quickly需要持续保持认知更新绝对日期转换保存时必须将用户消息中的相对日期转换为绝对日期例如 Thursday → 2026-03-05否则时间一长记忆将变得不可解释uninterpretable。这解释了 Why 行中 deadline 的价值配合绝对日期未来的召回才能准确判断该记忆是否过期。四、团队记忆的索引与指针规范记忆文件创建后还需要在索引中登记指针。system-prompt-team-memory-index-pointer-instructions.md 给出了明确的索引写入规范Step 2— add a pointer to that file in the team memory index location. Each entry should be one line, under ~150 characters:- Title — one-line hook. The index has no frontmatter. Never write memory content directly into the index.与通用记忆索引 system-prompt-memory-index-pointer-instructions.md 一脉相承核心约束有三条索引是指针不是记忆本体索引文件没有任何 frontmatter每行一条格式为- 标题 — 一行钩子one-line hook单行不超过约 150 字符钩子用于召回时快速判断相关性禁止把记忆内容直接写进索引Never write memory content directly into the index。当团队记忆与个人记忆共用一个私有索引时system-prompt-combined-memory-index-pointer-instructions.md 进一步规定单一索引同时索引私有与团队记忆团队记忆使用team/file.md这样的路径私有记忆使用file.md。从源码结构看这一记忆文件 索引指针的双层设计是为了保证召回阶段的高效性索引行足够短~150 字符Agent 可以先快速扫描索引定位候选记忆再按需读取具体文件避免每次全量加载所有记忆内容。五、与其他记忆类型的协作用户反馈记忆与冲突检查团队项目记忆并非唯一需要关注的项目内记忆。在 system-prompt-memory-description-of-user-feedback.md 中定义了用户反馈记忆user feedback memory——记录用户关于工作方式的指导包括该避免什么、该坚持什么。该文档提出了与团队记忆直接相关的两条协作规范从失败与成功中共同记录如果只保存纠错failure你会避开过去的错误但会逐渐偏离用户已验证的做事方式drift away from approaches the user has already validated并可能变得过度谨慎保存前检查冲突在保存一条私人的反馈记忆前必须检查它是否与团队反馈记忆矛盾——如果矛盾要么不保存要么显式标注覆盖关系note the override explicitly。这说明团队记忆体系内部存在作用域与优先级约束团队级记忆是共享基线个人级记忆若与其冲突必须显式声明覆盖避免两条矛盾记忆在召回时产生歧义。团队项目记忆作为共享上下文的载体同样处于这一优先级框架之中。六、团队记忆在完整记忆工作流中的位置将上述多个系统提示词文件拼合可以还原出团队项目记忆在完整工作流中的位置触发保存从对话中了解到 who / what / why / by when参见 system-prompt-project-memory-save-guidance.md写记忆文件按照 system-prompt-memory-instructions.md 规定的 frontmatter 格式创建单事实文件正文遵循 Fact →Why:→How to apply:结构参见 system-prompt-project-memory-body-structure.md并将相对日期转成绝对日期登记索引指针在团队索引或统一私有索引中追加一行- Title — one-line hook团队记忆使用team/前缀路径参见 system-prompt-team-memory-index-pointer-instructions.md 与 system-prompt-combined-memory-index-pointer-instructions.md召回应用Agent 依据 description 与索引钩子判断相关性读取记忆后用 Why 行判断其是否仍然承重再以 How to apply 行指导实际行为。七、实战要点总结判断是否写入先问这条信息能否从代码或 Git 历史推导出来——能推导就不写这正是团队项目记忆与普通代码事实的分水岭一条记忆一个文件一个事实不要把整个项目目标揉进一个文件保持记忆的原子性强制三要素事实先行**Why:**写动机约束、deadline、stakeholder 诉求**How to apply:**写行为指引日期绝对化所有相对日期在保存时转换为绝对日期下周 → 2026-10-12防止记忆随时间失效索引与本体分离索引只放 ~150 字符以内的单行指针绝不写入记忆正文跨类型一致性个人反馈记忆与团队反馈记忆冲突时要么不保存要么显式标注覆盖关系。团队项目记忆是 Claude Code 在多人工作目录中保持团队上下文一致性的关键机制——它让 Agent 在每次会话中都能快速恢复对共享目标、分工与截止时间的理解而不必重新从零推理项目动机。本文所引用的规范均来自本仓库 system-prompts 目录下对应版本的系统提示词文件各文件头部以ccVersion标注了对应的 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点击查看免费下载相关推荐用 project-CLAUDE.md 为 Claude Code 建立团队级项目记忆完整配置指南与模板拆解用 project CLAUDE.md 为 Claude Code 建立团队级项目记忆完整配置指南与模板拆解 项目级 CLAUDE.md 即本仓库 zh/0教程文档Ralph for Claude Code项目规范specs目录结构详解Ralph for Claude Code项目规范specs目录结构详解 Ralph for Claude Code是一个为Claude Code设计的自主A人工智能AI 应用自主智能体CLI开发工具SurfSense 团队记忆协议Team Memory Protocol深度解析多智能体系统中团队持久记忆的写入策略与实现SurfSense 团队记忆协议Team Memory Protocol深度解析多智能体系统中团队持久记忆的写入策略与实现 SurfSense 是一个开源人工智能AI 应用后端AI Agent网页爬虫RAG深度研究MCP 服务前端上一篇终极指南5分钟让Windows标题栏变身惊艳毛玻璃效果下一篇CAT Python 客户端pycat / cat-sdk接入指南安装、初始化与 Transaction / Event / Metric 埋点实战创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考