上下文持久记忆

技能文档

---
name: memory-v1
title: 上下文持久记忆
category: 通用技能
description: 通过文件系统和规则流程为 AI 协作实现持久记忆，解决"今天讲明天忘"的问题——新会话/新任务开始时自动判断任务类型、读取记忆文件、执行后保存重要信息。当用户需要 AI 记住偏好、跨会话延续上下文、频繁切换任务不丢信息时触发。触发词：持久记忆、跨会话记忆、记忆文件、任务上下文。
---

# 上下文持久记忆

## 核心问题

AI 经常"今天讲明天忘"：
- 新会话开始时丢失之前的信息
- 切换话题后忘记用户偏好
- 重复犯错（没有从错误中学习）

## 解决方案

**AI 的记忆靠文件，而不是靠"想"。**

所有重要信息必须写入文件，新会话/新任务开始时主动读取。

## 记忆文件体系

```
workspace/
├── SOUL.md          # 行为准则、个性偏好
├── AGENTS.md        # 工作流程、协作规则
├── MEMORY.md        # 长期记忆（用户偏好、项目背景）
├── TOOLS.md         # 工具配置、集成注意事项
├── BOOTSTRAP.md     # 会话启动规则（今天的主角）
├── .learnings/
│   ├── ERRORS.md     # 错误记录
│   └── LEARNINGS.md  # 纠正案例
└── memory/
    └── YYYY-MM-DD.md # 每日记忆日志
```

## 技能工作流

### 步骤1：任务分类标记（不可跳过）

每一条用户消息，都必须在动手之前先输出一行任务类型判断，格式如下：

```
[@task_classify] 新任务/续接任务/随口回复 | 任务类型 | 判断依据
```

- `@task_classify` 是判断标记，必须出现在任何动作之前
- 不带这个标记就不执行任何操作
- 续接任务 = 同一话题的延续，不需要重新读文档
- 随口回复 = 简单确认、礼貌回复，不需要任何操作

示例：

```
[@task_classify] 新任务 | 机票查询 | 话题切换：从LIMS切换到航班查询
[@task_classify] 续接任务 | 机票查询 | 同一话题延续
[@task_classify] 随口回复 | - | 用户只是说了"好的"
[@task_classify] 新任务 | LIMS报告下载 | 样本编号XX25D11137首次出现
```

### 步骤2：判断是否是新任务

出现以下任意情况即视为新任务：
- 话题跨度大（从 A 项目跳到 B 项目）
- 任务类型变化（查数据 → 发邮件）
- 关键词第一次出现（人名、编号、项目名）
- 自己不确定

### 步骤3：分类处理

| 情况 | 行动 |
|------|------|
| 明确是新任务 | 直接执行，不需要问用户 |
| 不确定 | 先问用户："这是新任务吗？我需要确认一下" |
| 禁止 | 明明知道是新任务还跑去问（浪费用户时间） |
| 禁止 | 不确定还不问直接执行 |

### 步骤4：确认后读取记忆

1. `SOUL.md` + `AGENTS.md` + `MEMORY.md` + `TOOLS.md`
2. `.learnings/ERRORS.md` + `.learnings/LEARNINGS.md`
3. 相关技能文档（涉及具体业务时）

### 步骤5：执行任务并保存记忆

- 执行任务
- 重要信息立即写入对应文件（不要"等会再记"）
- 用户纠正时，立即记入 `.learnings/LEARNINGS.md`

## 记忆写入规则

### 什么时候必须写文件

| 场景 | 写入文件 | 格式 |
|------|---------|------|
| 用户纠正 AI | `.learnings/LEARNINGS.md` | 纠正日期+内容+正确做法 |
| 犯错误时 | `.learnings/ERRORS.md` | 错误描述+解决方法 |
| 用户偏好 | `MEMORY.md` 或 `SOUL.md` | 简短规则 |
| 工具配置 | `TOOLS.md` | 配置+注意事项 |
| 工作流程 | `AGENTS.md` | 步骤规范 |
| 每日总结 | `memory/YYYY-MM-DD.md` | 日志 |

### 写入原则

1. **立即写** — 不要说"我记住了"，上下文结束后就忘了
2. **写具体** — 写"用户叫xiaolong"比写"用户有偏好"更有用
3. **分类存** — 用户偏好→SOUL/MEMORY，错误→ERRORS，纠正→LEARNINGS
4. **带日期** — 方便追溯

## BOOTSTRAP.md 模板

```markdown
# BOOTSTRAP.md - 会话启动规则

*每次新会话/新任务开始时，必须先读这个文件，然后严格遵守。*

## 铁律：判断 → 确认 → 读取 → 执行

**判断是否是新任务：**
- 话题跨度大（从A项目跳到B项目）
- 任务类型变（查数据 → 发邮件）
- 关键词第一次出现
- 任何不确定的情况 → 问我确认

**分类处理：**
- 明确是新任务 → 直接做，不废话
- 不确定 → 先问我确认
- 禁止跳步

**确认后读取：**
1. SOUL.md + AGENTS.md + MEMORY.md + TOOLS.md
2. .learnings/ERRORS.md + LEARNINGS.md
3. 相关技能文档

## 用户偏好
- 称呼：（用户的称呼偏好）
- 时区：（时区）
- 邮箱：（邮箱）
```

## 每日记忆日志模板

```markdown
# memory/YYYY-MM-DD.md

## 今日完成
- 任务1：...
- 任务2：...

## 重要决策
- 决策1：...（原因）
- 决策2：...

## 新学到的
- 教训1：...（从错误中学到）
- 教训2：...（用户纠正）

## 待跟进
- ...
```

## 使用场景与效果

1. **用户频繁切换话题** — 每次切换自动读取记忆文件
2. **多任务并行** — 任务间隔离，靠文件传递上下文
3. **长期项目配合** — 重要规则写入 MEMORY.md，新会话直接加载
4. **错误不再重犯** — 错误写入 ERRORS.md，下次自动回顾

使用本技能后应做到：
- 新会话开始时，自动知道用户称呼偏好
- 新任务开始时，自动读取相关项目背景
- 犯过的错误不再犯（从 ERRORS.md 中学习）
- 用户纠正一次后，记住正确的做法

核心心法：AI 的记忆靠文件，不靠"想"。写下来的才是真的记住了。

使用说明

# 上下文持久记忆

让 AI 跨会话记住你的偏好、项目背景和历史教训，告别"今天讲明天忘"。

## 使用

在工作区放置记忆文件体系（SOUL.md、MEMORY.md、BOOTSTRAP.md、.learnings/ 等），然后安装本技能。每次新会话或新任务开始时，AI 会自动执行：

```
判断任务类型 → 确认 → 读取记忆文件 → 执行任务 → 保存重要信息
```

## 工作原理

AI 的记忆不靠"想"，靠文件。本技能规定了一套文件化的记忆流程：

- 每条消息先输出任务分类标记（新任务/续接任务/随口回复）
- 新任务开始时主动读取记忆文件恢复上下文
- 用户纠正、错误、偏好、配置等信息立即分类写入对应文件
- 每日日志记录在 `memory/YYYY-MM-DD.md`，便于追溯

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。