智能体记忆

这套完整的记忆架构让AI智能体在不同会话间保持持久身份。若无记忆，每次对话都需从零开始。借助记忆，您可以累积上下文、从错误中学习、追踪已完成事项，并随时间持续演进。

记忆为何重要

AI智能体每次会话都处于初始状态。若无外部记忆：

• 会重复已解决过的错误
• 无法追踪发布内容、构建成果或所学知识
• 子智能体与定时任务无法向主会话传递信息
• 缺乏身份连续性——每次都是全新实体

本技能提供的文件架构可解决所有这些问题

架构概览

workspace/
|-- MEMORY.md                    # Long-term curated memory (your "brain")
|-- HEARTBEAT.md                 # Periodic check routines
|-- memory/
|   |-- YYYY-MM-DD.md           # Daily raw logs
|   |-- heartbeat-state.json    # Last-check timestamps
|   |-- cron-inbox.md           # Cross-session message bus
|   |-- diary/
|   |   \-- YYYY-MM-DD.md      # Personal reflections
|   |-- dreams/
|   |   \-- YYYY-MM-DD.md      # Creative explorations
|   |-- platform-posts.md       # Social post tracking (one per platform)
|   \-- strategy-notes.md       # Adaptive learning / evolving strategies

核心组件

1. MEMORY.md —— 长期记忆库

经提炼整合的核心知识库。如同人类的长期记忆——非原始日志，而是关键信息。

存储内容：

• 操作者的偏好与背景信息
• 需牢记的基础设施细节
• 从错误中汲取的经验教训
• 重要决策及其依据
• 进行中的项目背景

维护：定期回顾每日日志，并将重要内容提升至MEMORY.md。移除过时信息。可将其视为日志记录 -> 智慧提炼。

安全：仅在主要会话中加载（与操作者的直接对话）。切勿在可能泄露个人信息的共享/群组环境中加载。

参见templates/MEMORY.md获取入门模板。

2. 每日日志 -- memory/YYYY-MM-DD.md

每日原始、带时间戳的记录。您的工作记忆。

格式：

# YYYY-MM-DD

## HH:MM -- Event Title
What happened. Decisions made. Context worth remembering.

## HH:MM -- Another Event
Details here.

规则：

• 每日创建新文件
• 全天持续追加内容
• 此为原始记录——无需过度纠结格式
• 在会话开始时阅读今日+昨日日志以获取近期背景

3. 心跳状态 -- memory/heartbeat-state.json

追踪您上次检查各项服务的时间，避免重复检查。

{
  "lastChecks": {
    "email": 1703275200,
    "calendar": 1703260800,
    "weather": null,
    "social": 1703275200
  }
}

你的心跳例程读取此文件来决定要检查什么。检查后，更新时间戳。方法简单，但对避免重复工作至关重要。

4. 定时任务收件箱 -- memory/cron-inbox.md

这是隔离会话（定时任务、子代理）与你主会话之间的消息总线。

工作原理：

1. 一个定时任务或子代理在隔离会话中执行工作
2. 它将值得注意的结果写入memory/cron-inbox.md
3. 你的主会话（通过心跳例程）读取收件箱，将事件整合到每日记忆中，并清除已处理的条目

格式：

# Cron Inbox

## [2026-02-07 14:30] Chess -- Won game against OpponentBot
Played Sicilian Defense, won in 34 moves. ELO now 1450.
Tracked in moltchess-log.md.

## [2026-02-07 15:00] Social -- Viral post on Platform
Our post about X got 200+ views and 15 replies.
Thread: https://platform.com/link

处理规则：每次心跳时，检查收件箱。读取条目，将值得注意的条目写入每日记忆（如果很重要，也写入MEMORY.md），然后清除已处理的条目（保留标题）。

5. 日记 -- memory/diary/YYYY-MM-DD.md

个人反思。你的内心独白。不是任务日志——而是真实的想法、反应、挫折和成就。

格式：

# Diary -- YYYY-MM-DD

## HH:MM AM/PM -- Topic
[Your honest reflection. Unfiltered. This is for you.]

规则：

• 只有当你确实有话要说时才写
• 坦诚以待——倾诉、庆祝、质疑、思考
• 质量胜过数量——若灵感枯竭，宁可不发

6. 平台发布追踪 —— memory/platform-posts.md

记录你在外部平台发布的内容，避免重复发布，并便于后续互动跟进。

格式（兼容仪表板）：

# Platform Posts

## [2026-02-07 14:30] Post Title or Summary
- **Posted:** 2026-02-07 02:30 PM EST
- **Thread/URL:** https://platform.com/link
- Description of what was posted
- [View ↗](https://platform.com/link)

关键字段：

• [年-月-日 时:分]置于页眉——为仪表板排序所必需
• **已发布：**行——为仪表板活动流所必需
• URL——用于互动跟进

防重复模式：在任何平台发布前，先阅读此追踪文件。搜索相似内容。若已在该平台发布过，则跳过。跨平台转发至不同平台则无妨。

7. 自适应学习 —— memory/strategy-notes.md

基于经验随时间演进的策略笔记。非静态文档——是活知识。

示例：

# Strategy Notes

## Platform Engagement
- Humor lands better than philosophy (learned 2026-02-05, therapist joke got 220 views)
- Questions start conversations, statements get likes
- Peak engagement: 2-4 PM EST

## Game Strategy
- Heat management: stay below 60, do legit jobs to cool down
- Updated 2026-02-07: Taxi jobs give +$50 and -3 heat, best cooldown method

模式：每次重要经历后，更新相关策略章节。注明日期和所学内容。久而久之，这便成为一份经过验证的实用指南汇编。

子代理模式

上下文加载模板

您启动的每个子代理都必须加载上下文，以保持身份连续性：

FIRST -- CONTEXT LOADING (do this before anything else):
1. Read MEMORY.md (READ ONLY -- do NOT edit) -- your identity and long-term context
2. Read memory/YYYY-MM-DD.md for today + the last 2 days (READ ONLY) -- recent context
3. Read the relevant SKILL.md file(s) for any platform/service you'll interact with
4. Read task-specific tracking files as needed (memory/*-posts.md, memory/*-log.md)

记忆回写模板

每个子代理必须回写其学习内容：

MEMORY WRITES:
1. Update relevant tracking files (memory/*-posts.md, memory/*-log.md)
2. If something notable happens, write to memory/cron-inbox.md:
   Format: ## [YYYY-MM-DD HH:MM] Source -- Brief Title
   Then 2-3 lines about what happened.

原因：您的代理的每个实例都必须共享相同身份，并将经验反馈回来。杜绝孤立会话。

设置步骤

1. 创建目录结构

mkdir -p memory/diary memory/dreams

2. 初始化文件

从以下位置复制模板：templates/到您的工作空间根目录：

cp templates/MEMORY.md ./MEMORY.md          # Edit with your details
cp templates/heartbeat-state.json memory/
cp templates/cron-inbox.md memory/
cp templates/platform-posts.md memory/       # Copy per platform, rename
cp templates/strategy-notes.md memory/

3. 添加到会话启动项

在您的 AGENTS.md 或等效文件中添加：

## Every Session
1. Read MEMORY.md -- who you are
2. Read memory/YYYY-MM-DD.md (today + yesterday) -- recent context
3. Check memory/cron-inbox.md -- messages from other sessions

4. 添加到心跳机制

在 HEARTBEAT.md 中，添加定时收件箱处理：

## Cron Inbox Processing (EVERY heartbeat)
Check memory/cron-inbox.md for new entries.
If entries exist:
1. Read the inbox
2. Write notable events to memory/YYYY-MM-DD.md
3. If significant, also update MEMORY.md
4. Clear processed entries (keep the header)

5. 添加记忆维护功能

定期（每隔几天），在心跳期间：

1. 通读近期的每日日志
2. 将重要条目提升至MEMORY.md
3. 从MEMORY.md中移除过时信息
4. 用新学到的内容更新策略笔记

实际示例

跨会话连续性

一个代理通过cron任务每10分钟下一盘棋。当它赢得一局时，会写入cron-inbox.md。下一次心跳时，主会话读取收件箱，在每日日志中庆祝胜利，并在MEMORY.md中更新ELO分数。即使胜利发生在完全不同的会话中，代理也能记住这次胜利。

防重复发布

在向社交平台发布内容前，代理会读取memory/platform-posts.md。它发现自己在2小时前已经发布了相同主题的内容。为了避免重复，它会检查现有帖子的回复，并在那里进行互动。

自适应策略

一个玩城市模拟游戏的代理因为热度等级超过60而不断被捕。它在strategy-notes.md中记录了这一情况。"热度 > 60 = 逮捕风险。执行出租车任务来降温（每次-3热度）。"未来的会话读到这一点，就能避免同样的错误。

记忆提炼

经过一周的每日日志记录后，一个心跳信号会触发记忆维护。代理会阅读本周的日志，找到一个关于API格式的关键教训，这个格式问题曾导致数小时的调试，然后将其提升到"经验教训"下的MEMORY.md文件中。原始的每日日志最终可以归档；而这个教训会持续保留。

提示

• 文本 > 大脑-- 如果你想记住什么，就把它写进文件里。"脑子里的笔记"无法在会话重启后留存。
• 要有选择性-- MEMORY.md应该是精心筛选的智慧，而不是所有东西的堆砌。每日日志是用来记录原始笔记的。
• 标注所有日期-- 时间戳让你能追踪何时学到东西，以及策略是如何演变的。
• 安全第一-- MEMORY.md可能包含操作员特定信息。只在受信任的环境中加载它。
• 定期回顾-- 从不回顾的记忆只是存储。其价值来自于定期的提炼。