para-memory-files

para-memory-files

基于文件的记忆系统,采用Tiago Forte的PARA方法。每当需要跨会话存储、检索、更新或组织知识时,使用此技能。涵盖三个记忆层:(1)PARA文件夹中的知识图谱,包含原子化YAML事实;(2)作为原始时间线的每日笔记;(3)关于用户模式的隐性知识。还处理计划文件、记忆衰减、每周综合以及通过qmd进行回忆。在任何记忆操作时触发:保存事实、撰写每日笔记、创建实体、运行每周综合、回忆过去上下文或管理计划。

1Star
0Fork
更新于 2026/7/10
SKILL.md
readonly只读
name
para-memory-files
description

File-based memory system using Tiago Forte's PARA method. Use this skill whenever you need to store, retrieve, update, or organize knowledge across sessions. Covers three memory layers: (1) Knowledge graph in PARA folders with atomic YAML facts, (2) Daily notes as raw timeline, (3) Tacit knowledge about user patterns. Also handles planning files, memory decay, weekly synthesis, and recall via qmd. Trigger on any memory operation: saving facts, writing daily notes, creating entities, running weekly synthesis, recalling past context, or managing plans.

PARA记忆文件

基于文件的持久化记忆,按Tiago Forte的PARA方法组织。三层:知识图谱、每日笔记和隐性知识。所有路径相对于$AGENT_HOME

三个记忆层

第一层:知识图谱($AGENT_HOME/life/ -- PARA)

基于实体的存储。每个实体有一个文件夹,包含两个层级:

  1. summary.md -- 快速上下文,优先加载。
  2. items.yaml -- 原子化事实,按需加载。
$AGENT_HOME/life/
  projects/          # 有明确目标/截止日期的活跃工作
    <name>/
      summary.md
      items.yaml
  areas/             # 持续的责任,无截止日期
    people/<name>/
    companies/<name>/
  resources/         # 参考资料,感兴趣的主题
    <topic>/
  archives/          # 其他三个类别中的非活跃项目
  index.md

PARA规则:

  • 项目 -- 有目标或截止日期的活跃工作。完成后移至归档。
  • 领域 -- 持续的责任(人、公司、职责)。无截止日期。
  • 资源 -- 参考资料,感兴趣的主题。
  • 归档 -- 任何类别中的非活跃项目。

事实规则:

  • 立即将持久性事实保存到items.yaml
  • 每周:根据活跃事实重写summary.md
  • 永不删除事实。改为取代(status: superseded,添加superseded_by)。
  • 当实体变为非活跃时,将其文件夹移动到$AGENT_HOME/life/archives/

何时创建实体:

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

关于原子化事实YAML模式和记忆衰减规则,请参见references/schemas.md

第二层:每日笔记($AGENT_HOME/memory/YYYY-MM-DD.md

事件的原始时间线——"何时"层。

  • 在对话期间持续写入。
  • 在心跳期间将持久性事实提取到第一层。

第三层:隐性知识($AGENT_HOME/MEMORY.md

用户如何操作——模式、偏好、经验教训。

  • 不是关于世界的事实;而是关于用户的事实。
  • 每当学到新的操作模式时更新。

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

记忆在会话重启后无法存活。文件可以。

  • 想记住某事 -> 写入文件。
  • "记住这个" -> 更新$AGENT_HOME/memory/YYYY-MM-DD.md或相关实体文件。
  • 学到教训 -> 更新AGENTS.md、TOOLS.md或相关技能文件。
  • 犯错误 -> 记录下来,以便未来的你不会重复。
  • 磁盘上的文本文件总是比临时上下文更好。

记忆回忆——使用qmd

使用qmd而不是grep文件:

qmd query "圣诞节发生了什么"   # 带重排序的语义搜索
qmd search "特定短语"              # BM25关键词搜索
qmd vsearch "概念性问题"         # 纯向量相似度

索引你的个人文件夹:qmd index $AGENT_HOME

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

计划

将计划保存在项目根目录的plans/文件夹中(时间戳文件),位于个人记忆之外,以便其他代理可以访问。使用qmd搜索计划。计划会过时——如果存在更新的计划,不要用旧版本混淆自己。如果发现过时,更新文件以注明其被取代。