会话记忆管理器 session-memory

会话记忆管理器是一个用于跨会话学习和记忆持久化的工具技能。它自动记录项目开发过程中的工作历史、重要决策和学习模式,实现不同会话间的知识延续和上下文保持。关键词包括:会话记忆、跨会话学习、工作历史记录、决策跟踪、开发上下文管理、知识持久化、项目记忆库、开发协作工具。

DevOps 0 次安装 0 次浏览 更新于 3/3/2026

name: session-memory description: “管理跨会话学习和记忆持久化。当用户提到 前回何をした, 履歴, 過去の作業, セッション記録, continue from before, session history 时使用。不要加载用于: 実装作業, レビュー, 一時的な情報。” allowed-tools: [“Read”, “Write”, “Append”] user-invocable: false metadata: skillport: category: core tags: [session, memory, history, context] alwaysApply: false

会话记忆技能

管理会话间的学习和记忆。 记录和参考过去的工作内容、决策事项、学习到的模式。


触发短语

此技能在以下短语时自动启动:

  • 「上次做了什么?」「从上次继续」
  • 「显示历史」「过去的工作」
  • 「告诉我关于这个项目的信息」
  • “what did we do last time?”, “continue from before”

概述

此技能在 .claude/memory/ 中保存工作历史, 实现会话间的知识延续。

同时,明确重要信息「应该保存在哪里」(详情: docs/MEMORY_POLICY.md)。


内存结构

.claude/
└── memory/
    ├── session-log.md      # 每个会话的日志
    ├── decisions.md        # 重要决策事项
    ├── patterns.md         # 学习到的模式
    └── context.json        # 项目上下文

推荐操作(SSOT/本地分离)

  • SSOT(共享推荐): decisions.md / patterns.md
    • 汇总「决策(Why)」和「可重用的解决方案(How)」
    • 每个条目添加 标题 + 标签(例: #decision #db),开头放置 索引
  • 本地推荐: session-log.md / context.json / .claude/state/
    • 由于容易产生噪音/膨胀,基本不进行 Git 管理(需要时单独判断)

自动记录的信息

session-log.md

## 会话: 2024-01-15 14:30

### 执行的任务
- [x] 用户认证功能的实现
- [x] 登录页面的创建

### 生成的文件
- src/lib/auth.ts
- src/app/login/page.tsx

### 重要决策
- 认证方式: 采用 Supabase Auth

### 下次的交接事项
- 登出功能未实现
- 密码重置也需要

decisions.md

## 技术选型

| 日期 | 决策事项 | 理由 |
|------|---------|------|
| 2024-01-15 | Supabase Auth | 有免费额度,设置简单 |
| 2024-01-14 | Next.js App Router | 最新的最佳实践 |

## 架构

- 组件: `src/components/`
- 工具: `src/lib/`
- 类型定义: `src/types/`

patterns.md

## 此项目的模式

### 组件命名
- PascalCase
- 例: `UserProfile.tsx`, `LoginForm.tsx`

### API 端点
- `/api/v1/` 前缀
- RESTful 设计

### 错误处理
- 用 try-catch 包围
- 错误消息用日语

context.json

{
  "project_name": "my-blog",
  "created_at": "2024-01-14",
  "stack": {
    "frontend": "next.js",
    "backend": "next-api",
    "database": "supabase",
    "styling": "tailwind"
  },
  "current_phase": "阶段2: 核心功能",
  "last_session": "2024-01-15T14:30:00Z"
}

处理流程

会话开始时

  1. 读取 .claude/memory/context.json
  2. 确认上次的会话日志
  3. 识别未完成任务
  4. 生成上下文摘要

会话中

  1. 重要决策记录到 decisions.md
  2. 新模式添加到 patterns.md
  3. 文件生成记录到 session-log.md

会话结束时

  1. 生成会话摘要
  2. 更新 context.json
  3. 记录下次的交接事项

使用示例

从上次继续开始

用户: 「从上次继续」

Claude Code:
📋 上次会话(2024-01-15)

完成的任务:
- 用户认证功能
- 登录页面

未完成:
- 登出功能
- 密码重置

说「制作登出功能」就可以继续实现。

项目状况确认

用户: 「告诉我关于这个项目的信息」

Claude Code:
📁 项目: my-blog

技术栈:
- Next.js + Tailwind CSS + Supabase

当前阶段: 核心功能开发
进度: 40% 完成

最近的决策:
- 采用 Supabase Auth
- 使用 App Router

注意事项

  • 自动保存: 推荐通过 hooks/Stop 在会话结束时自动追加摘要到 session-log.md 的操作(未导入时手动操作即可)
  • 隐私: 不记录机密信息
  • Git策略: decisions.md/patterns.md推荐共享,session-log.md/context.json/.claude/state/推荐本地(详情: docs/MEMORY_POLICY.md
  • 容量管理: 日志变大时推荐「整理会话日志」