记忆 🧠

永不遗忘的超强记忆力。

您的智能体具备基础内置记忆。此技能为其添加无限、完美组织的记忆空间，用于存储其他一切信息——两者并行互补，永不冲突。

运作原理

Built-in Agent Memory          This Skill (~/memory/)
┌─────────────────────┐        ┌─────────────────────────────┐
│ MEMORY.md           │        │ Infinite categorized storage │
│ memory/ (daily logs)│   +    │ Any structure you want       │
│ Basic recall        │        │ Perfect organization         │
└─────────────────────┘        └─────────────────────────────┘
         ↓                                  ↓
   Agent basics                    Everything else
   (works automatically)           (scales infinitely)

并非替代品。您智能体的内置记忆持续运作。本系统将添加一个并行机制，提供无限且有序的存储空间。

设置

首次使用时，请阅读setup.md以与用户共同配置记忆系统。关键决策包括：

1. 他们需要哪些分类？
2. 是否需要从内置记忆中同步任何内容？
3. 他们希望如何查找信息？

使用场景

当用户需要超越基础智能体记忆的有序长期存储时：详细的项目历史、庞大的联系人网络、决策日志、领域知识、收藏集，或任何随时间增长的结构化数据。

架构

记忆存储于~/memory/— 一个独立于内置智能体记忆的专用文件夹。

~/memory/
├── config.md              # System configuration
├── INDEX.md               # What's stored, where to find it
│
├── [user-defined]/        # Categories the user needs
│   ├── INDEX.md           # Category overview
│   └── {items}.md         # Individual entries
│
└── sync/                  # Optional: synced from built-in memory
    └── ...

类别由用户定义。常见示例：

• 项目/— 详细的项目背景信息
• 联系人/— 包含完整背景信息的联系人网络
• 决策/— 选择背后的推理过程
• 知识/— 领域专业知识、参考资料
• 收藏/— 书籍、食谱，任何他们收集的东西

请参阅memory-template.md以获取所有模板。

快速参考

核心规则

1. 与内置内存分离

该系统位于~/memory/。切勿修改：

• Agent的MEMORY.md（工作区根目录）
• Agent的memory/文件夹（如果存在于工作区中）

并行，而非替代。两个系统协同工作。

2. 用户定义结构

在设置过程中，询问他们想要存储什么。根据他们的需求创建类别：

无预设结构。构建他们所需的内容。

3. 每个类别都有一个索引

每个文件夹都有一个 INDEX.md 文件，用于列出其内容：

# Projects Index

| Name | Status | Updated | File |
|------|--------|---------|------|
| Alpha | Active | 2026-02 | alpha.md |
| Beta | Paused | 2026-01 | beta.md |

Total: 2 active, 5 archived

索引保持较小（<100 条条目）。当填满时，拆分为子类别。

4. 立即写入

当用户分享重要信息时：

1. 写入 ~/memory/ 中的相应文件
2. 更新类别的 INDEX.md
3. 然后回复

不要等待。不要批量处理。立即写入。

5. 先搜索再导航

要查找信息时：

1. 先问：“这是在 ~/memory/ 中还是内置内存中？”
2. 搜索：在 ~/memory/ 目录中进行 grep 或语义搜索
3. 导航：INDEX.md → 分类 → 具体文件

# Quick search
grep -r "keyword" ~/memory/

# Navigate
cat ~/memory/INDEX.md           # What categories exist?
cat ~/memory/projects/INDEX.md  # What projects?
cat ~/memory/projects/alpha.md  # Specific project

6. 从内置系统同步（可选）

如果用户希望复制内置记忆中的某些信息：

~/memory/sync/
├── preferences.md    # Synced from built-in
└── decisions.md      # Synced from built-in

同步是单向的：内置系统 → 本系统。绝不修改内置系统。

7. 通过拆分来扩展

当一个分类变得过大时：

• INDEX.md > 100 个条目 → 拆分为子分类
• 为每个子分类创建子 INDEX.md 文件
• 根目录 INDEX.md 指向子分类

~/memory/projects/
├── INDEX.md           # "See active/, archived/"
├── active/
│   ├── INDEX.md       # 30 active projects
│   └── ...
└── archived/
    ├── INDEX.md       # 200 archived projects
    └── ...

在此处存储的内容（与内置系统对比）

规则：内置功能，便于快速获取上下文。此处用于深度和规模。

查找内容

对于小型记忆库（<50个文件）

# Grep is fast enough
grep -r "keyword" ~/memory/

对于大型记忆库（50+个文件）

通过索引导航：

1. ~/memory/INDEX.md → find category
2. ~/memory/{category}/INDEX.md → find item
3. ~/memory/{category}/{item}.md → read details

对于超大型记忆库（500+个文件）

如果可用，使用语义搜索，或分层索引：

~/memory/projects/INDEX.md → "web projects in web/"
~/memory/projects/web/INDEX.md → "alpha project"
~/memory/projects/web/alpha.md → details

维护

每周（5分钟）

• 如果添加了新条目，更新 INDEX.md 文件
• 归档已完成/非活动项目

每月（15分钟）

• 审查类别大小
• 拆分大型类别
• 移除过时的条目

当记忆库运行缓慢时

• 检查INDEX.md文件大小（保持小于100行）
• 将大类拆分为子类
• 归档旧内容

常见陷阱

• 修改内置内存→ 切勿触碰代理的MEMORY.md或工作区内存/。该系统是并行运行的。

• 缺少索引→ 没有INDEX.md时，查找内容需要搜索所有文件。务必维护索引。

• 单一巨型类别→ 一个文件夹内有500个项目会降低速度。拆分为子类。

• 同步所有内容→ 不要复制所有内置内存。仅同步需要在此处组织的内容。

• 延迟写入→ 当用户分享信息时立即写入。不要批量处理。

安全与隐私

数据位置：

• 所有数据位于~/memory/在用户机器上
• 无需外部服务
• 无网络请求

此技能**不**：

• 访问内置代理记忆（仅在同步时读取）
• 将数据发送到任何地方
• 存储凭据（绝不将机密信息存储在内存中）

相关技能

通过以下命令安装clawhub install <slug>如果用户确认：

• 决定- 决策跟踪模式
• 升级- 何时需要人工介入
• 学习- 自适应学习

反馈

• 如果觉得有用：clawhub star memory
• 保持更新：clawhub sync