Imported from yunshu0909/yunshu_skillshub (
memory-init/SKILL.md). Install upstream withnpx skills add yunshu0909/yunshu_skillshub --skill memory-init. Copyright stays with the author.
记忆系统初始化
功能说明
在当前工作目录下一键部署记忆系统，生成三个东西：
- CLAUDE.md — 人设 + 对话规则 + 记忆协议
- MEMORY.md — 长期记忆文件（初始为空模板）
- memory/ — 每日记忆目录
/memory-init→ 交互式初始化，逐步收集信息后生成
工作流程
第0步：检查现有文件
先检查当前目录下是否已存在 CLAUDE.md、AGENT.md、MEMORY.md 或 memory/ 目录。
- 如果都不存在 → 正常初始化
- 如果部分存在 → 告诉用户哪些已存在，问是要覆盖还是只补缺的
- 如果都存在 → 告诉用户"已经初始化过了"，问是否要重置
第1步：收集项目简介 + 人设信息
1.1 项目简介
先用 ls 和 Glob 检查当前目录是否已有实质性项目文件（代码、文档、配置文件等）。注意：.claude/、.git/、node_modules/ 等工具目录不算项目文件。
- 已有实质性项目文件（如 README、package.json、源代码、文档等）→ 扫描目录结构、README、package.json、主要代码文件等，自动生成项目简介（2-3句话概括项目是什么、做什么用的），展示给用户确认或修改
- 空目录 / 只有工具目录 / 几乎没有内容 → 必须问用户："这个项目是做什么的？简单描述一下"，然后停下来等用户回答，不要继续往下走。拿到用户的回答后，再进入 1.2
1.2 人设信息
问用户以下问题：
- 你的角色是什么？（如：SA/售前、开发、产品、运营）
- 你主要用 Claude 做什么？（如：客户沟通、技术方案、日常文档、代码开发）
- 对话风格偏好？（如：简洁直接 / 详细展开 / 随意聊天）
- 有什么特别的工作习惯要我知道的？（可选，用户可以跳过）
第2步：生成 CLAUDE.md
根据收集到的信息生成 CLAUDE.md，包含以下模块：
# 项目简介
[根据扫描结果或用户描述生成，2-3句话概括项目是什么、做什么用的]
# 人设
[根据用户角色和用途生成，1-2句话]
# 对话风格
[根据用户偏好生成，3-5条规则]
# 思考方式
[根据用户角色生成，3-5条思考优先级]
# 记忆协议
## 长期记忆（MEMORY.md）
- 存放稳定的核心信息：客户画像、个人偏好、关键决策
- 每次对话自动加载，始终在上下文中
- 超过 150 行时主动提议精简
## 每日记忆（memory/YYYY-MM-DD.md）
- 存放当天对话产生的要点：结论、洞察、待办、决策
- 对话结束前问一句"这次有值得记住的吗？"，确认后写入当天文件
- 需要回顾历史时，搜索 memory/ 目录检索
## 工作流
1. 对话开始 → 用 Read 工具读取本项目根目录下的 MEMORY.md，再用 Read 读取 memory/当天日期.md（如 memory/2026-03-02.md），了解今天已有的上下文
2. 涉及历史上下文 → 用 Grep 工具搜索本项目根目录下的 memory/ 目录
3. 对话结束 → 问是否要记录，确认后写入 memory/当天日期.md
4. 如果产出了值得长期记住的信息（如新客户、重要决策），同步更新 MEMORY.md
5. 注意：以上所有文件路径都是相对于本项目根目录，不是全局 ~/.claude/ 目录
## 补充规则
- 记忆以本项目根目录下的文件为准，忽略 ~/.claude/ 下的 auto-memory（内置记忆系统），不要读也不要写
- 对话开始时，除了读今天的记忆，也读昨天的（memory/昨天日期.md），保持跨天连续性
- 用户说"记住这个"、"这个记一下"时，立刻写入文件，不要只"记在心里"等结束再存
- 每日记忆积累超过 7 天时，主动提议做一次蒸馏：把仍然有价值的要点合并到 MEMORY.md，过时的标记或清理注意：记忆协议部分是固定模板，不随用户输入变化。项目简介、人设、对话风格、思考方式根据用户输入定制。
第2.5步：询问是否生成 AGENT.md（给 Codex 用）
生成 CLAUDE.md 之后，问用户：
"你还用 Codex 吗？要不要同时生成一份 AGENT.md？内容和 CLAUDE.md 一模一样，Codex 会自动读取 AGENT.md。"
- 用户说要 → 把 CLAUDE.md 的内容原样复制一份为 AGENT.md
- 用户说不要 → 跳过，继续下一步
AGENT.md 和 CLAUDE.md 内容完全相同，唯一区别是文件名。CLAUDE.md 给 Claude Code 用，AGENT.md 给 Codex 用。
第3步：生成 MEMORY.md
创建初始的长期记忆文件：
# 记忆
## 关于我
- 角色：[用户的角色]
- 日常工作：[用户的主要用途]
## 项目与上下文
-（待补充）
## 工作习惯与偏好
- [如果用户提供了偏好，写在这里]
## 重要决策
- [今天日期]：初始化记忆系统第4步：创建 memory/ 目录
mkdir -p memory/如果用户愿意，把当前对话的初始化过程作为第一条每日记忆写入 memory/当天日期.md。
第5步：确认完成
告诉用户生成了什么，简要说明使用方法：
已生成：
- CLAUDE.md（人设 + 记忆协议，Claude Code 用）
- AGENT.md（同上，Cursor 用）← 如果用户选了才显示这行
- MEMORY.md（长期记忆）
- memory/（每日记忆目录）
使用方式：
- 正常对话即可，我会自动读取记忆
- 对话结束时我会问你要不要保存要点
- 说"记住这个"可以随时存记忆
- 积累一段时间后说"整理记忆"做一次蒸馏
核心原则
1. 记忆协议是固定的
人设和风格可以个性化，但记忆协议模块不要改——这是系统运行的基础逻辑，保持一致才能在不同目录下通用。
2. 不破坏已有内容
如果目录下已有 CLAUDE.md 或 AGENT.md，默认不覆盖。用户明确要求才覆盖。
3. 生成后立即可用
初始化完成后，下次新开对话就应该能正常工作——读到 MEMORY.md、按协议执行。不需要额外配置。
