这是一个给 Claude / AI 助手用的随身记忆库模板。

你可以把它理解成：

• 仓库里的文件：长期记忆，重要、稳定、以后经常会用到。
• Issues：随手记，日志、碎碎念、聊天片段、待整理的小条内容。

日常最简单的用法是：平时只往 Issues 里记，偶尔让 Claude 帮你整理进文件。

不会，前提是不要让 Claude 一次性读完整个仓库。

文件夹多不等于耗 token。Claude 只有在“打开并读取内容”时才会消耗上下文。

这个模板已经给 Claude 写好了规矩：

1. 先读 CLAUDE.md
2. 再读 memory-index.md
3. 只读这次任务需要的文件或 Issue
4. 不要全库乱翻

所以正确用法不是“把所有记忆塞给 Claude”，而是让 Claude 像查档案一样，只查今天需要的几页。

请不要直接在这个公开模板里写私人内容。

操作方法：

1. 点页面右上方的 Use this template
2. 点 Create a new repository
3. Repository name 可以随便起，比如 my-vault
4. 一定要选 Private
5. 点 Create repository

这样你就会得到一个只属于你自己的私人记忆库。

进入你自己的私人仓库后：

如果你会用 GitHub CLI，建议先运行一次 scripts/create-labels.sh，把记忆标签创建好。不会用也没关系，可以先继续往下记。

1. 点上方的 Issues
2. 点 New issue
3. 选择 Memory Log
4. 把今天想记的东西写进去
5. 点 Submit new issue

这就记好了。

你可以把 Issue 当成“随手记小纸条”：

• 今天发生了什么
• 某句话很重要
• 某个偏好
• 某个雷点
• 某段聊天
• 某个突然想到的设定
• 还没想清楚但不想忘的碎碎念

不需要一开始就整理得很漂亮。先记下来最重要。

你可以把自己的私人仓库连接给 Claude Code，或者把仓库链接发给支持 GitHub 的 AI 工具。

然后这样说：

这是我的记忆库。请先读 CLAUDE.md，再读 memory-index.md。
不要全库扫描，只看这次任务相关的文件或 Issues。

我今天想做的事是：
<写你的问题>

如果只是想让 Claude 查某类记忆，可以这样说：

请在这个记忆库里查和“语气偏好”有关的内容。
先读 CLAUDE.md 和 memory-index.md。
如果需要看 Issues，请优先搜索 type/style 或 status/raw，不要全量读取。

如果你想把这个私人仓库当成一个“能聊天、能记忆、能托管在云端 Claude Code 里”的空间，可以直接用 Claude Code 打开这个仓库。

这个模板带了三类 Claude Code 项目配置：

• cmh-lite 会话记忆：压缩前自动写 checkpoint、开场注入最近工作状态、每轮结束记一行 turn 摘要，并可用 scripts/daily-commit.sh 定时提交 archive/daily/。详见 docs/cloud-claude-code.md 的 Session memory 一节。想要服务端长期记忆（向量召回、夜间整理、日记）？配套的记忆内核 Aelios 可以每晚从这个仓库的 archive/daily/ 自动拉取入库，见其 README 的 GitHub daily source 一节。
• 语言风格 hook：每次你发消息时，UserPromptSubmit hook 都会读取 style/voice-and-tone.md，提醒 Claude 保持你的语气偏好。这个适合放“每轮都要保持”的说话风格。
• 记忆聊天 skill：.claude/skills/memory-chat/ 可以用 /memory-chat 调用，负责读记忆、写记忆、整理存档。它不是用来兜底保持语气的，语气交给 hook。
• 记忆 MCP：.mcp.json 里的 memory_vault 提供窄范围搜索、读取文件、追加 raw memory 的工具，避免 Claude 一上来全库乱翻。
• Thinking 显示：.claude/settings.json 里打开了 alwaysThinkingEnabled 和 showThinkingSummaries。这会让 Claude Code 默认启用 thinking，并在支持的交互界面里显示 thinking summaries；它不等于保证所有云端界面都能看到完整原始 CoT。

还有一个存档 hook 会把 prompt 和关键工具动作写到 archive/hook-events/。这些存档只是原始材料，不等于长期记忆。

第一次在 Claude Code 里打开时，可能会看到 workspace trust 或 MCP approval，按提示确认后可以用 /mcp 看 memory_vault 有没有连上。

云端容器是临时的。hook 或 MCP 写出来的文件要留下来，需要最后 commit/push。

结束前可以这样说：

请查看今天的 hook archive 和 raw memory，把需要长期保存的内容整理进记忆库，然后 commit/push。

详细用法见 docs/cloud-claude-code.md。

Issues 适合随手记，但长期重要的东西最好整理进文件。

比如这些内容适合进文件：

• 一直不变的个人偏好
• 明确的边界和雷点
• 关系的当前状态
• Claude 应该长期记住的语气
• 反复会用到的开场 prompt

你可以定期对 Claude 说：

请查看 status/raw 的 Issues，挑出已经稳定、以后会反复用到的记忆。
把它们整理进合适的 Markdown 文件。
请只做小改动，更新 memory-index.md 和 changelog.md。
整理完后告诉我改了哪些文件。

日常不用管它们。真的要整理时再用。

• people/：关于人，比如我、对方、角色
• relationship/：关系状态、边界、相处模式
• events/：发生过的具体事情
• style/：喜欢什么语气、讨厌什么表达
• prompts/：常用开场白或提示词
• imports/：从别处搬来的原始材料
• archive/：过期或暂时不用的内容
• .claude/：Claude Code 的项目级 skill 和 hooks
• .mcp.json：Claude Code 的项目级 MCP 配置

刚开始只用 Issues 就可以。

每天：

1. 想到什么就开一个 Issue 记下来。
2. 不用整理，不用分类得很完美。

每隔一段时间：

1. 让 Claude 看 status/raw 的 Issues。
2. 让它把重要内容整理进仓库文件。
3. 你检查一下改动。

每次正式聊天前：

1. 如果是普通 AI 工具，让 Claude 先读 CLAUDE.md，再读 memory-index.md。
2. 如果是 Claude Code，可以直接用这个仓库开始；项目 hook、skill、MCP 会一起工作。
3. 不管哪种方式，都只读相关内容，不要全库乱翻。

Issue 记流水账，文件放长期记忆；Claude 每次只查需要的部分，不要全库乱翻。