para-memory-files

PARA 记忆文件

采用 Tiago Forte 的 PARA 方法组织的持久化文件式记忆。分为三层：知识图谱、每日笔记和隐性知识。所有路径均相对于 $AGENT_HOME。

三层记忆

第 1 层：知识图谱（$AGENT_HOME/life/ -- PARA）

按实体组织的存储。每个实体都有一个文件夹，包含两层内容：

1. summary.md -- 快速了解上下文，优先加载。
2. items.yaml -- 原子事实，按需加载。

$AGENT_HOME/life/
  projects/          # Active work with clear goals/deadlines
    <name>/
      summary.md
      items.yaml
  areas/             # Ongoing responsibilities, no end date
    people/<name>/
    companies/<name>/
  resources/         # Reference material, topics of interest
    <topic>/
  archives/          # Inactive items from the other three
  index.md

PARA 规则：

• Projects（项目） -- 有目标或截止日期的活跃工作。完成后移入档案。
• Areas（领域） -- 持续进行的事项（人员、公司、职责），没有结束日期。
• Resources（资源） -- 参考资料、感兴趣的主题。
• Archives（档案） -- 来自任意类别的不活跃事项。

事实规则：

• 立即将持久事实保存到 items.yaml。
• 每周根据活跃事实重写 summary.md。
• 永不删除事实，而是标记为被取代（status: superseded，并添加 superseded_by）。
• 实体变为不活跃时，将其文件夹移至 $AGENT_HOME/life/archives/。

何时创建实体：

• 被提及 3 次或以上，或
• 与用户有直接关系（家人、同事、伴侣、客户），或
• 是用户生活中的重要项目或公司。
• 否则，记在每日笔记中。

原子事实的 YAML 架构和记忆衰减规则，请参见 references/schemas.md。

第 2 层：每日笔记（$AGENT_HOME/memory/YYYY-MM-DD.md）

事件的原始时间线——记录“何时”发生。

• 在对话过程中持续记录。
• 在心跳期间将持久事实提取到第 1 层。

第 3 层：隐性知识（$AGENT_HOME/MEMORY.md）

用户的行事方式——模式、偏好、经验教训。

• 不是关于世界的事实，而是关于用户的事实。
• 每当发现新的行事模式时就更新。

记下来——不要只记在脑子里

会话重启后，记忆不会保留，文件会。

• 想记住某件事 -> 写入文件。
• “记住这个” -> 更新 $AGENT_HOME/memory/YYYY-MM-DD.md 或相关实体文件。
• 学到经验教训 -> 更新 AGENTS.md、TOOLS.md 或相关技能文件。
• 犯了错误 -> 记录下来，避免未来的自己重蹈覆辙。
• 磁盘上的文本文件始终优于将信息留在临时上下文中。

回忆记忆——使用 qmd

使用 qmd，而不是 grep 搜索文件：

qmd query "what happened at Christmas"   # Semantic search with reranking
qmd search "specific phrase"              # BM25 keyword search
qmd vsearch "conceptual question"         # Pure vector similarity

为个人文件夹建立索引：qmd index $AGENT_HOME

向量 + BM25 + 重排序，即使措辞不同也能找到相关内容。

规划

将计划保存在项目根目录下 plans/ 中带时间戳的文件里（置于个人记忆之外，以便其他 Agent 访问）。使用 qmd 搜索计划。计划会过时——如果有更新的计划，不要被旧版本误导。如果发现计划已过时，请更新文件，注明它已被什么取代。