用途：Second Brain 把 ~/.memory/ 作为 AI 智能体的持久化、分层知识存储，跨项目与工具保存个人知识，如偏好、经验、工作流和领域专长。它与项目级上下文文件（CLAUDE.md、.cursorrules）不同，后者放项目规则，前者放跨项目的个人知识。
主要能力：以标签索引做相关性匹配，用 wiki 链接做图谱遍历，每个文件上限 100 行以节省上下文窗口。核心概念包括：根目录 index.yaml 作为主注册表；profile.md 保存用户身份；分类目录（如 coding/、marketing/）各含 index.md 与主题 .md 文件。每个记忆文件带 YAML frontmatter（tags、created、updated、links）和简洁正文。记忆生命周期为 CRUSP：创建、读取、更新、拆分、清理。
使用方式：会话开始时读取 index.yaml，从当前上下文提取关键词，与标签匹配（精确命中 3 分，部分匹配 1 分），只加载得分最高的 3-5 个文件；若无达标文件则只加载 profile.md。用户说“记住这个”时，先确定分类，追加或新建文件并更新 index.yaml。复杂任务结束后，批量提出可保存的学习点，经用户明确同意后才写入。首次使用需检测 ~/.memory/ 是否存在，缺失则通过 7 个问题的访谈引导初始化。搜索记忆时先查标签，无匹配再全文搜索。文件超过 100 行时提议拆分为子目录与子文件，并更新所有 wiki 链接和 index.yaml。
适用场景：新会话自动加载相关记忆、用户主动保存或查询记忆、任务后提议保存经验、首次搭建 ~/.memory、搜索整理或清理记忆。
限制：不得保存密码、API 密钥或令牌等敏感数据，记忆文件是明文。不得在未获用户同意时写入。不要加载全部记忆文件。不要保存显而易见或通用知识。不要重复项目级上下文。标签过于宽泛会削弱检索。拆分过急会碎片化上下文。wiki 链接指向不存在文件会破坏图谱。首次激活时会检查配套技能，缺失时可用 npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name> 安装。详细规范见 references/onboarding.md、references/memory-format.md、references/maintenance.md。