克劳德将内存迁移到文档

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

为什么存在这个技能

克劳德·科德的个人记忆存在于~/.claude/projects/<project-slug>/memory/中。它被锁定为克劳德代码:不受存储库的版本控制,对所有其他工具都是不可见的。当用户在同一目录中运行 Codex、Cursor 或任何其他 AI CLI 时,这些工具无法读取“用户是谁/如何与他们合作”——即使用户配置文件和协作首选项正是任何AI 助手应该首先读取的内容。

核心见解——在接触任何东西之前先阅读这篇文章

困难的部分不是移动文件。 它是这样的:仅通过纯文本指针访问的参考文件是按需读取的,并且不保证在任一工具中加载。

与工具无关的架构

范围说明:接线(~/.codex/符号链接、配置编辑和第 5 阶段验证)是 Codex 特定的,并且仅针对 Codex 进行了验证(2026-06)。 ~/.claude/references/user/内容层传输到自动加载项目文档的任何工具,但 Cursor 和其他工具需要自己的接线(光标读取.cursor/rules/项目根目录AGENTS.md,而不是~/.codex/)——此处未实现或验证。

工作流程

将此清单复制到您的工作笔记中并勾选项目:

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@daymade · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 阶段 — 诊断和范围

预检 — 找到内存目录。 Claude Code内存位于`~/.claude/projects/<project-slug>/memory/`,其中`<project-slug>`是工作目录路径,`/`→`-`。用户可能拥有跨多个项目的记忆 - 用`ls ~/.claude/projects/*/memory/`列出它们,并选择(或合并)其内存保存跨工具用户内容的项目。列出该内存目录下的每个文件。按范围而不是“是否混乱”对每个进行分类。完整的决策表和代理无法判断私有上下文的警告:阅读references/diagnosis_and_scoping.md。

02
第 2 阶段 — 与工具无关的迁移

首先拍摄 CLAUDE.md (`cp ~/.claude/CLAUDE.md ~/.claude/CLAUDE.md.bak`) — 您将要编辑它。如果`~/.claude/CLAUDE.md`不存在,则创建它(有些用户只有项目级的)。如果 `command -v codex` 为空(未安装 Codex):仅执行下面的步骤 1 和 4(`references/` + inline-CLAUDE.md 工作),并跳过符号链接 (2)、配置 (3) 和所有阶段 5。内容迁移仍然有效;留下注释,稍后连接 Codex 需要符号链接 + `project_doc_max_bytes`。

03
第 3 阶段 — 多代理审查

生成 4 个并行审查子代理(一条消息,多个任务调用)。每个审计都审核一个维度:内容完整性(是否有任何事实被删除/更改)、交叉引用损坏(如果内存被删除,`[[links]]`将悬空)、与工具无关的链接完整性(符号链接/指针链是否真正解析;Codex 是否真正读取它)、重复/漂移(引用是否重复 CLAUDE.md 规则)。具体提示:references/review_and_verification.md。

04
第 4 阶段 — 修复

解决出现的评论。常见的真实发现(全部来自实时运行):一个中心文件忘记为其自己的子文件之一建立索引;核心事实仅保留在参考中(将它们移至内联);幸存文件中的`[[links]]`指向要删除的内存(重新指向新的引用);治理表行已更新,但同一部分中的判决语句与其相矛盾。

05
第 5 阶段 — 通过运行 CODEX 进行验证(不要跳过,不要委托给用户)

您可能会想用“看起来正确”或“您可以稍后自己检查”来替换该步骤。 不。

06
第 6 阶段 — 内存清理

对于未迁移的内存文件,执行以下三件事之一(参考/diagnosis_and_scoping.md 中的决策详细信息):清理 — 过期(过去日期的移交)或陈旧(应计算而不是存储的派生计数)→ 存档。精简 — 重述位于其他地方的 SSOT → 删除重复,仅保留指针 + 易失状态(例如“实例 X 仍在计费,将其关闭”)。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。