Claude Code 记忆系统深度解析：四层架构打造持久化智能#

1
生命周期：仅在当前会话有效
2
存储位置：Claude Code 运行时内存
3
上下文管理：当上下文窗口接近满额时，系统会自动进行上下文压缩

1
~/.claude/projects/{project-path}/memory/
2
├── MEMORY.md           # 记忆索引文件
3
├── user_*.md          # 用户画像文件
4
├── feedback_*.md      # 反馈记录
5
├── project_*.md       # 项目相关记忆
6
└── reference_*.md     # 参考资料

1
---
2
name: 项目记忆索引
3
description: 存储项目的关键上下文信息
4
type: memory_index
5
---
6

7
# 项目记忆索引
8

9
## 最近更新
10
- 2026-04-11: 更新技术方案决策
11
- 2026-04-09: 记录团队编码规范
12

13
## 记忆文件列表
14
- `project_tech_decisions.md` - 技术方案选择
15
- `user_preferences.md` - 用户工作偏好

1
---
2
name: 文件名称
3
description: 简要描述记忆内容
4
type: [user|feedback|project|reference]
5
---
6

7
# 标题
8

9
## Why
10
为什么这条信息重要（解释其价值和用途）
11

12
## How to apply
13
如何在实际工作中应用这条信息（具体指导）

1
~/.claude/rules/
2
├── common/           # 通用规则（适用于所有项目）
3
│   ├── coding-style.md
4
│   ├── git-workflow.md
5
│   ├── testing.md
6
│   ├── security.md
7
│   └── ...
8
├── zh/              # 中文规则翻译
9
├── typescript/      # TypeScript 语言特定规则
10
├── python/          # Python 语言特定规则
11
├── golang/          # Go 语言特定规则
12
└── ...

1
---
2
name: 用户技术画像
3
description: 记录用户的技术背景和工作偏好
4
type: user
5
---
6

7
# 用户技术画像
8

9
## 技术背景
10
- 主力语言：Python, TypeScript
11
- 熟悉框架：FastAPI, LangGraph
12
- 偏好数据库：PostgreSQL + pgvector
13

14
## 工作风格
15
- 倾向于 TDD 开发流程
16
- 重视代码审查
17
- 使用中文进行技术文档撰写
18

19
## 反馈模式
20
- 喜欢直接指出问题
21
- 不喜欢过多铺垫
22
- 重视效率优先

1
场景识别：
2
- 用户纠正了 AI 的某个行为 → → 记忆用户的正确偏好
3
- 用户透露了自己的角色（"我是后端开发"） → → 更新用户画像
4
- 用户讨论了项目的技术选型 → → 记录项目技术决策
5
- 用户提到了项目的约束条件 → → 记录项目上下文

1
  ┌─────────────────────────────────────────────────┐
2
  │  MEMORY.md (项目记忆索引)                        │
3
  │  - 记录所有 memory 文件的指针和描述               │
4
  │  - 会话间持久化，宕机不丢失                       │                                        └─────────────────────────────────────────────────┘
5
             ↓
6
  ┌─────────────────────────────────────────────────┐
7
  │  .plan/ 目录 (计划文档)                          │
8
  │  - plan-brainstorming 输出的计划                 │
9
  │  - 已提交的 commit 记录                          │
10
  └─────────────────────────────────────────────────┘
11
             ↓
12
  ┌─────────────────────────────────────────────────┐
13
  │  代码文件 (实现)                                 │
14
  │  - 核心引擎已实现并提交                           │
15
  │  - 未完成部分可通过计划追踪                       │
16
  └─────────────────────────────────────────────────┘

1
  ┌──────┬────────────────────────┬───────────────────────────────────────────┐
2
  │ 步骤 │          机制          │                   作用                     │
3
  ├──────┼────────────────────────┼───────────────────────────────────────────┤
4
  │ 1    │ MEMORY.md              │ 读取项目记忆索引，了解 Context Catch 项目   │
5
  ├──────┼────────────────────────┼───────────────────────────────────────────┤
6
  │ 2    │ .plan/plan_index.md    │ 追踪所有计划文件                           │
7
  ├──────┼────────────────────────┼───────────────────────────────────────────┤
8
  │ 3    │ .plan/context-catch.md │ 读取计划文档，对照完成状态                  │
9
  ├──────┼────────────────────────┼───────────────────────────────────────────┤
10
  │ 4    │ git log                │ 确认已提交的实现                            │
11
  ├──────┼────────────────────────┼───────────────────────────────────────────┤
12
  │ 5    │ 代码审查               │ 确认核心引擎已完成，剩余 API + 集成          │
13
  └──────┴────────────────────────┴───────────────────────────────────────────┘

1
        ↓                                                                                     ┌──────────────────────────────────────────────────────────────┐
2
 │  writing-plans skill (规划阶段)                               │                            │  - 分析需求，确定范围                                         │                            │  - 分解任务，粒度到 2-5 分钟的步骤                            │                            │  - 保存到 docs/superpowers/plans/YYYY-MM-DD-<feature>.md    │                              │  - self-review 检查                                         │                              └──────────────────────────────────────────────────────────────┘                                    ↓                                                                                            ↓ [用户选择执行方式]                                                                         ↓
3
 ┌─────────────────────────┐    ┌─────────────────────────────────┐
4
 │  executing-plans skill   │    │  subagent-driven-development     │
5
 │  (内联执行)               │    │  (子代理执行 - 推荐)             │
6
 │  - 分批执行               │    │  - 每个任务启动新子代理          │
7
 │  - 检查点审查             │    │  - 任务间审查                    │
8
 └─────────────────────────┘    └─────────────────────────────────┘
9
        ↓                              ↓
10
 ┌──────────────────────────────────────────────────────────────┐
11
 │  finishing-a-development-branch skill (收尾阶段)             │
12
 │  - 验证测试                                                │
13
 │  - 呈现选项 (merge/PR/保留/丢弃)                            │
14
 │  - 执行选择                                                │
15
 └──────────────────────────────────────────────────────────────┘
16
        ↓
17
      完成

1
  ┌──────────┬────────────────────────────────────────────────┬────────────────────┐
2
  │   阶段   │                    文档位置                    │        内容        │
3
  ├──────────┼────────────────────────────────────────────────┼────────────────────┤
4
  │ 规划输出 │ docs/superpowers/plans/YYYY-MM-DD-<feature>.md │ 完整实现计划       │
5
  ├──────────┼────────────────────────────────────────────────┼────────────────────┤
6
  │ 计划索引 │ .plan/plan_index.md                            │ 所有计划的目录索引 │
7
  ├──────────┼────────────────────────────────────────────────┼────────────────────┤
8
  │ 项目记忆 │ MEMORY.md                                      │ 记忆系统索引       │
9
  └──────────┴────────────────────────────────────────────────┴────────────────────┘