SuperAPI AI 工具集

para-second-brain

办公与效率

查看项目

更新于 10-16 07:11

技能介绍

用途

PARA Second Brain 用于为 AI 智能体建立一套结构化的长期记忆与知识库。它把智能体的记忆分成两层:一层是原始、按时间记录的每日日志,另一层是经过整理、按主题组织的长期记忆。同时,它用 PARA 方法把笔记按可执行性分为项目、领域、资源、归档四类,让智能体在每次新会话开始时仍能延续之前的工作上下文。

主要能力

  • 建立“第二大脑”目录结构,区分原始捕获(每日日志)与精选知识(MEMORY.md),区分进行中的工作(项目)与持续职责(领域),区分参考资料(资源)与已完成内容(归档)。
  • 通过符号链接技巧,让整个 notes/ 目录对语义搜索可见。默认情况下,memory_search 只索引 MEMORY.md 和 memory/*.md,notes/ 文件夹对语义搜索不可见;创建符号链接后,Clawdbot 的 memory_search 可以看到全部 PARA 笔记。
  • 支持会话记录索引,把过去的对话记录也纳入搜索范围,从而可以回答“上周我们讨论过 X 吗”这类问题。
  • 提供记忆刷新协议,通过监控上下文使用率,在上下文压缩前把重要信息写入文件,减少信息丢失。
  • 提供内容模板(概念、工具、模式)和知识质量检查标准,帮助生成结构化、可检索的高质量笔记。

使用方式

  1. 创建目录结构:
mkdir -p memory notes/projects notes/areas notes/resources/templates notes/archive

目录结构如下:

workspace/
├── MEMORY.md              # Curated long-term memory
├── memory/
│   └── YYYY-MM-DD.md      # Daily raw logs
└── notes/
    ├── projects/          # Active work with end dates
    ├── areas/             # Ongoing life responsibilities  
    ├── resources/         # Reference material
    │   └── templates/     # Content templates
    └── archive/           # Completed/inactive items
  1. 让笔记可被搜索(符号链接技巧):
ln -s /path/to/your/workspace/notes /path/to/your/workspace/memory/notes

示例:

ln -s /Users/yourname/clawd/notes /Users/yourname/clawd/memory/notes

验证:

ls -la memory/notes  # Should show: memory/notes -> /path/to/notes
  1. 启用会话记录索引,在 Clawdbot 配置中添加:
"memorySearch": {
  "sources": ["memory", "sessions"],
  "query": {
    "minScore": 0.3,
    "maxResults": 20
  }
}
  1. 初始化 MEMORY.md,在 workspace 根目录创建该文件,包含关于用户、活跃上下文、偏好与模式、经验教训、关键日期等部分。

  2. 在 AGENTS.md 中添加记忆相关说明,包括每日笔记、长期记忆、主题笔记的路径,以及 PARA 结构说明和记忆刷新协议。

记忆刷新协议

通过 session_status 监控上下文使用率,按阈值采取行动:

Context % Action
< 50% Normal operation
50-70% Write key points after substantial exchanges
70-85% Active flushing — write everything important NOW
> 85% Emergency flush — full summary before next response
After compaction Note what context may have been lost

需要刷新的内容包括:已做出的决定、行动项、未完成事项、工作变更。

PARA 结构说明

PARA 是 Tiago Forte 提出的知识组织系统,按可执行性分为四类:

  • Projects(项目):有截止日期或结束状态的工作,例如“发布网站”“规划日本旅行”。
  • Areas(领域):没有结束日期的持续职责,例如健康、财务、人际关系、职业发展。
  • Resources(资源):供未来使用的参考资料,例如研究、教程、模板、文章。
  • Archive(归档):其他类别中已不活跃的内容,例如已完成项目、过时资源、暂停的领域。

适用场景

  • 希望使用基于文件的记忆,可离线工作、无成本,并追踪持续的工作上下文。
  • 需要智能体在多次会话之间保持连续性,记住之前的决定和未完成事项。
  • 需要把笔记、每日日志和会话记录统一纳入语义搜索。

限制与说明

  • 该技能依赖 Clawdbot 的 memory_search 和 session_status 等能力,具体配置方式以实际环境为准。
  • 符号链接命令中的路径需要替换为实际工作区路径。
  • 资料中未提供该技能的收费、价格、平台支持范围等具体信息。
  • 资料中提到的 Ensue Second Brain 是另一个独立技能,两者定位不同:本技能为本地文件存储、免费自托管,适合工作上下文和智能体连续性;Ensue 为云端 API、需要 API key,适合常青知识库和语义查询。