名称： para-second-brain
版本： 2.0.1
描述： 使用 PARA 方法（项目、领域、资源、归档）来组织你的智能体知识，并使其完全可搜索。符号链接技巧实现了对整个知识库的语义搜索，而不仅仅是 MEMORY.md。包含会话记录索引和内存刷新协议。你的智能体终于拥有了一个真正的“第二大脑”。

PARA 第二大脑

你的智能体记忆迎来了一次重大升级。现在可以对整个知识库进行全面的语义搜索——不再局限于 MEMORY.md。

v2.0 版本更新内容

v2.0 之前： memory_search 只能查找 MEMORY.md 和每日日志中的内容。整个 notes/ 文件夹对搜索不可见。你必须手动知道去哪里找。

v2.0 之后： 一条符号链接命令即可让你的整个 PARA 知识库可被搜索。询问笔记中的任何内容——它都能找到。此外，还增加了会话记录索引和内存刷新协议，以防止上下文丢失。

功能概述

创建一个“第二大脑”结构，用于区分：
- 原始捕获（每日日志）与整理后的知识（MEMORY.md）
- 活跃工作（项目）与持续职责（领域）
- 参考资料（资源）与已完成的工作（归档）

与其他“第二大脑”技能的区别

还有一个流行的由 Ensue 驱动的 second-brain 技能。两者都很棒——它们解决不同的问题：

使用本技能如果： 你想要基于文件的、离线工作、零成本、并能跟踪持续工作上下文的记忆系统。

使用 Ensue 的技能如果： 你想要一个云托管的、针对语义“我知道关于 X 的什么”查询优化的知识库。

两者都用如果： 你想要 PARA 用于工作上下文 + Ensue 用于常青知识。它们相辅相成。

快速设置

1. 创建目录结构

workspace/
├── MEMORY.md              # 整理后的长期记忆
├── memory/
│   └── YYYY-MM-DD.md      # 每日原始日志
└── notes/
    ├── projects/          # 有截止日期的活跃工作
    ├── areas/             # 持续的生活职责
    ├── resources/         # 参考资料
    │   └── templates/     # 内容模板
    └── archive/           # 已完成/非活跃项目

运行以下命令创建结构：

mkdir -p memory notes/projects notes/areas notes/resources/templates notes/archive

2. 使笔记可搜索（符号链接技巧）

默认情况下，memory_search 只索引 MEMORY.md 和 memory/*.md。你的整个 notes/ 文件夹对语义搜索不可见！

用一条命令修复此问题：

ln -s /path/to/your/workspace/notes /path/to/your/workspace/memory/notes

示例：

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

作用： 创建一个符号链接，使 memory/notes/ 指向你实际的 notes/ 文件夹。现在 Clawdbot 的 memory_search 就能看到你所有的 PARA 笔记了。

验证是否成功：

ls -la memory/notes  # 应显示：memory/notes -> /path/to/notes

测试搜索：
向你的智能体询问一个在你的笔记中但不在 MEMORY.md 中的内容。如果它能找到，说明符号链接生效了。

为什么这很重要：
| 之前 | 之后 |
|--------|-------|
| 搜索只能找到 MEMORY.md + 每日日志 | 搜索能找到你所有的笔记 |
| 必须手动知道去哪里找 | 对所有内容进行语义搜索 |
| “我没有这个信息” | 找到你忘记存在的关联 |

3. 启用会话记录索引

让你过去的对话也可被搜索。将此添加到你的 Clawdbot 配置中：

"memorySearch": {
  "sources": ["memory", "sessions"],
  "query": {
    "minScore": 0.3,
    "maxResults": 20
  }
}

作用： 将你的对话记录与笔记一起索引。现在当你问“我们上周讨论了关于 X 的什么？”时——它实际上能找到。

4. 初始化 MEMORY.md

在工作区根目录创建 MEMORY.md —— 这是你整理后的长期记忆：

# MEMORY.md — 长期记忆

## 关于 [人类姓名]
- 角色/职业
- 关键目标和动机
- 沟通偏好
- 重要关系

## 活跃上下文
- 当前关注领域
- 进行中的项目（摘要，非细节）
- 截止日期或时间敏感事项

## 偏好与模式
- 偏好的工具和工作流
- 决策风格
- 讨厌和喜欢的事物

## 经验教训
- 什么有效
- 什么无效
- 发现的原则

## 关键日期
- 生日、纪念日
- 周期性事件
- 重要里程碑

5. 添加到 AGENTS.md

将这些说明添加到你的 AGENTS.md 中：

## 记忆

你每次会话都是全新的开始。这些文件是你的连续性：
- **每日笔记：** `memory/YYYY-MM-DD.md` — 发生事情的原始日志
- **长期记忆：** `MEMORY.md` — 整理后的记忆（类似人类的长期记忆）
- **主题笔记：** `notes/` — 按 PARA 结构组织（所有内容均可通过 memory_search 搜索）

### 书写规则
- 如果具有未来价值，**立即**写下来
- 不要依赖“脑内笔记”——它们无法在重启后存活
- 文字 > 大脑 📝

### PARA 结构
- **项目** (`notes/projects/`) — 有截止日期的活跃工作
- **领域** (`notes/areas/`) — 持续职责（健康、财务、关系等）
- **资源** (`notes/resources/`) — 参考资料、操作指南、研究
- **归档** (`notes/archive/`) — 已完成或非活跃项目

### 内存刷新协议
使用 `session_status` 监控你的上下文使用情况。在压缩擦除你的记忆之前，将重要上下文刷新到文件中：

| 上下文 % | 行动 |
|-----------|--------|
| < 50% | 正常操作 |
| 50-70% | 在实质性交流后写下关键点 |
| 70-85% | 主动刷新 — **立即**写下所有重要内容 |
| > 85% | 紧急刷新 — 在下一次回复前写下完整摘要 |
| 压缩后 | 记录可能丢失的上下文 |

**规则：** 根据阈值行动，而非感觉。如果重要，**立即**写下来。

内存刷新协议（至关重要！）

你的智能体上下文窗口是有限的。当它填满时，旧的上下文会被压缩或丢失。不要丢失重要信息。

如何监控

定期运行 session_status。查看：

📚 Context: 36k/200k (18%) · 🧹 Compactions: 0

基于阈值的行动

刷新什么

1. 做出的决策 — 决定了什么以及为什么
2. 行动项 — 谁负责做什么
3. 未完成事项 — 任何未完成的事情 → notes/areas/open-loops.md
4. 工作变更 — 如果讨论了文件更改，立即执行

内存刷新清单

在长会话结束前或上下文变高时：
- [ ] 关键决策记录了吗？
- [ ] 行动项捕获了吗？
- [ ] 新学到的内容写入相应文件了吗？
- [ ] 未完成事项记下以便跟进吗？
- [ ] 未来的我能仅凭笔记继续这次对话吗？

知识质量

核心问题： “未来的我会为此感谢我吗？”

保存什么

• 你真正理解的概念（而非一知半解的想法）
• 你实际使用过的工具（而非只是听说过）
• 行之有效的模式（附具体例子）
• 从错误中吸取的教训

不要保存什么

• 一知半解的概念（先学习，后保存）
• 尚未尝试过的工具（书签 ≠ 知识）
• 没有 WHY 的肤浅条目
• 现有笔记的重复内容

质量关卡

在保存任何整理后的笔记前：
1. 是为忘记上下文的未来的自己写的吗？
2. 包含 WHY，而不仅仅是 WHAT 吗？
3. 有具体例子或关键见解吗？
4. 为检索而结构化（易于浏览）吗？

内容模板

在 notes/resources/ 中使用这些模板创建结构化、高质量的条目：

概念模板

# [概念名称]

## 它是什么
[一句话定义]

## 为什么重要
[它解决什么问题，何时需要它]

## 如何运作
[带例子的解释]

## 关键见解
[“顿悟”时刻——让这个概念清晰的关键点]

工具模板

# [工具名称]

**类别：** [开发工具 | 生产力 | 等]

## 功能
[简要描述]

## 我使用它的原因
[它为你解决了什么问题]

## 何时使用
[适合使用此工具的场景]

## 注意事项
- [曾让你困惑的地方]

模式模板

# [模式名称]

## 问题
[触发此模式的情况]

## 解决方案
[方法]

## 权衡
**优点：** [为什么有效]
**缺点：** [何时不应使用]

PARA 详解

PARA 是由《构建第二大脑》作者 Tiago Forte 创建的知识组织系统。它根据可操作性将所有内容分为四类：

项目

定义： 有截止日期或结束状态的工作
示例： “发布网站”、“计划日本之旅”、“完成客户提案”
归档为： notes/projects/website-launch.md

领域

定义： 没有结束日期的持续职责
示例： 健康、财务、关系、职业发展
归档为： notes/areas/health.md, notes/areas/dating.md

资源

定义： 供未来使用的参考资料
示例： 研究、教程、模板、有趣的文章
归档为： notes/resources/tax-guide.md, notes/resources/api-docs.md

归档

定义： 来自其他类别的非活跃项目
示例： 已完成的项目、过时的资源、暂停的领域
移动到： notes/archive/ 当完成时

每日日志格式

为每一天创建 memory/YYYY-MM-DD.md：

# YYYY-MM-DD

## 关键事件
- [发生了什么，做出的决策]

## 学习心得
- [什么有效，什么无效]

## 未完成事项
- [需要跟进的项目]

整理工作流

每日（5 分钟）

• 将值得注意的事件记录到 memory/YYYY-MM-DD.md
• 将特定主题的笔记归档到相应的 notes/ 文件夹

每周（15 分钟）

• 回顾本周的每日日志
• 将模式和心得提取到 MEMORY.md
• 将已完成的项目移动到归档

每月（30 分钟）

• 检查 MEMORY.md 中的过时信息
• 合并或归档旧的项目笔记
• 确保领域反映当前优先级

决策树：这个放哪里？

这是关于今天的具体内容吗？
  → memory/YYYY-MM-DD.md

这是一个有截止日期的任务吗？
  → notes/projects/

这是一个持续的责任吗？
  → notes/areas/

这是供以后参考的资料吗？
  → notes/resources/

它完成或不再相关了吗？
  → notes/archive/

这是一个提炼出的教训或偏好吗？
  → MEMORY.md

为什么需要两个记忆层？

每日日志是你的日记。MEMORY.md 是你的智慧。

原则

1. 质量优于数量 — 整理后的笔记胜过囤积笔记
2. 快速捕获，审慎整理 — 每日日志是松散的；整理后的笔记是高质量的
3. 文字 > 大脑 — 如果重要，就写下来
4. 未来自我测试 — “未来的我会为此感谢我吗？”
5. 每项内容一个归属 — 不要重复；使用链接
6. 包含 WHY — 没有上下文的事实是无用的
7. 在丢失前刷新 — 监控上下文，在压缩前书写

可与 memory-setup（用于技术配置）和 proactive-agent（用于行为模式）搭配使用。