mcpField
M
memory-palace

memory-palace

github.com/simhackerAgent 工作流6038 次安装3 天前更新
代码仓库

关于 memory-palace

一种供 LLM 在文件系统中组织和回忆信息的空间记忆技能,将目录视为房间、文件视为物件。通过地图、索引文件和交叉链接来安排知识与导航。

主要功能

  1. 01以目录和文件构建记忆宫殿
  2. 02使用 ENTRY.md 和 MAP.yml 导航
  3. 03通过链接关联知识条目
  4. 04支持扩展、维护与归档

适用场景

  1. 01将研究概念整理到可导航的目录中
  2. 02为相关文件建立交叉引用
  3. 03整理并归档过时的知识空间

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/simhacker/moollm --skill memory-palace

安装后在 Claude Code 中输入/memory-palace确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

CARD.yml
ENTRY.md.tmpl
GLANCE.yml
MAP.yml.tmpl
README.md
ROOM.md.tmpl
skill-snitch-report.md

详细介绍

🏛️ 记忆宫殿技能

“文件系统就是心智。目录是房间。文件是物件。”

将古老的记忆宫殿法改编为适用于在文件系统中导航的大模型。

这项技巧

将知识放在地点中。通过导航来记住。

每个房间包含:

  • 物件(文件)——供查阅的资料
  • 出口(链接)——通往其他房间的门
  • 氛围——房间的精髓

这就是 Room 技能

Memory Palace 和 Room 密切相关:

Memory PalaceRoom 技能
地点目录
物件文件
穿行进入/退出
放置创建文件
回想导航至

Memory Palace = Room + 空间记忆意图

宫殿结构

palace/
├── ENTRY.md          # Front door (README)
├── MAP.yml           # Navigation overview
│
├── concepts/         # Wing: Ideas
│   ├── ROOM.md
│   ├── yaml-jazz/
│   └── play-learn-lift/
│
├── characters/       # Wing: Personas
│   ├── ROOM.md
│   ├── gardener/
│   └── archivist/
│
└── skills/           # Wing: Capabilities
    ├── ROOM.md
    └── ...

放置知识

要记住某件事:

  1. 选择一个房间——这应该放在哪里?
  2. 创建一个文件——要放置的物件
  3. 建立链接——关联相关物件
  4. 走到那里——通过导航强化记忆
# palace/concepts/yaml-jazz/ROOM.yml
room:
  name: "YAML Jazz Chamber"
  contains:
    - "jazz-principles.md"    # Core ideas
    - "examples/"             # Sub-room of examples
  exits:
    parent: "../"
    related: "../play-learn-lift/"
  atmosphere: "improvisational, semantic"

核心文件

ENTRY.md

宫殿的正门:

# Palace Name

## Welcome
What this palace contains and why.

## Quick Navigation
- [Room A](room-a/ROOM.md) - Description
- [Room B](room-b/ROOM.md) - Description

## Recent Activity
- Added X to Room A
- Created new Room C
MAP.yml

导航结构:

palace:
  name: "Research Palace"
  created: "2025-12-30"
  
rooms:
  - name: "foundations"
    path: "foundations/"
    description: "Core concepts"
    connects_to: ["applications", "history"]
    
  - name: "applications"
    path: "applications/"
    description: "Practical uses"
    connects_to: ["foundations", "examples"]

landmarks:
  - name: "The Big Question"
    location: "foundations/core-question.md"
    importance: "Start here"
ROOM.md(在每个房间中)
# Room Name

## What's Here
Description of this room's contents.

## Artifacts
- [artifact-1.md](artifact-1.md) - Description

## Doors
- ← Back to [Entry](../ENTRY.md)
- → Forward to [Next Room](../next-room/ROOM.md)

## Notes
Observations, questions, TODOs for this room.

导航命令

意图操作
“进入宫殿”读取 ENTRY.md
“环顾四周”ls 当前目录
“前往房间 X”cd 到该房间,读取 ROOM.md
“查看物件”读取文件
“留个便条”创建/更新 .meta.yml
“创建新房间”mkdir + 创建 ROOM.md
“查看地图”读取 MAP.yml
“我在哪里?”记录当前路径

生命周期

创建
  • mkdir 宫殿根目录
  • 创建 ENTRY.md
  • 创建 MAP.yml
  • 创建初始房间
扩展
  • 创建新的房间目录
  • 添加 ROOM.md
  • 更新 MAP.yml
  • 从相关房间建立链接
维护
  • 定期更新 MAP.yml
  • 添加交叉引用
  • 归档过时的房间
  • 创建摘要
归档
  • 移至 attic/
  • 在 MAP.yml 中注明
  • 更新链接

提示

  1. 从小处开始——先建立 3-5 个房间,再按需扩展
  2. 使用有意义的名称——目录名就是地址
  3. 多建立链接——交叉引用有助于回想
  4. 留下线索——探索时更新 .meta.yml
  5. 维护地图——MAP.yml 就是你的目录
  6. 归档而非删除——将过时的房间移至 attic/

集成

技能关系
roomMemory Palace 就是 Room + 空间记忆意图
adventureAdventure 就是 Room + 叙事式任务框架
card放在房间中的物件可以是卡片
soul-chat宫殿中的房间可以说话、引导访客
summarize压缩宫殿知识以适配上下文

评论

支持 Markdown