memory-management

记忆管理

记忆让 Claude 成为你的职场协作者，一个懂你内部行话的伙伴。

目标

把简写转化为理解：

User: "ask todd to do the PSR for oracle"
              ↓ Claude decodes
"Ask Todd Martinez (Finance lead) to prepare the Pipeline Status Report
 for the Oracle Systems deal ($2.3M, closing Q2)"

没有记忆，这样的请求毫无意义。有了记忆，Claude 就能知道：

• todd → Todd Martinez，财务负责人，偏好 Slack
• PSR → Pipeline Status Report（每周销售文档）
• oracle → Oracle Systems 交易，而不是公司

架构

CLAUDE.md          ← Hot cache (~30 people, common terms)
memory/
  glossary.md      ← Full decoder ring (everything)
  people/          ← Complete profiles
  projects/        ← Project details
  context/         ← Company, teams, tools

CLAUDE.md（热缓存）：

• 你互动最频繁的前约 30 人
• 约 30 个最常用的缩写或术语
• 活跃项目（5-15 个）
• 你的偏好
• 目标：覆盖 90% 的日常解码需求

memory/glossary.md（完整术语表）：

• 完整的解码表，涵盖所有人员与所有术语
• 当 CLAUDE.md 中找不到时进行搜索
• 可以无限增长

memory/people/、projects/、context/：

• 在执行需要时提供详细信息
• 完整档案、历史与背景

查找流程

User: "ask todd about the PSR for phoenix"

1. Check CLAUDE.md (hot cache)
   → Todd? ✓ Todd Martinez, Finance
   → PSR? ✓ Pipeline Status Report
   → Phoenix? ✓ DB migration project

2. If not found → search memory/glossary.md
   → Full glossary has everyone/everything

3. If still not found → ask user
   → "What does X mean? I'll remember it."

这种分层方式让 CLAUDE.md 保持精简（约 100 行），同时在 memory/ 中支持无限扩展。

文件位置

• 工作记忆： 当前工作目录中的 CLAUDE.md
• 深层记忆： memory/ 子目录

工作记忆格式（CLAUDE.md）

使用表格以保持紧凑。总长目标约 50-80 行。

# Memory

## Me
[Name], [Role] on [Team]. [One sentence about what I do.]

## People
| Who | Role |
|-----|------|
| **Todd** | Todd Martinez, Finance lead |
| **Sarah** | Sarah Chen, Engineering (Platform) |
| **Greg** | Greg Wilson, Sales |
→ Full list: memory/glossary.md, profiles: memory/people/

## Terms
| Term | Meaning |
|------|---------|
| PSR | Pipeline Status Report |
| P0 | Drop everything priority |
| standup | Daily 9am sync |
→ Full glossary: memory/glossary.md

## Projects
| Name | What |
|------|------|
| **Phoenix** | DB migration, Q2 launch |
| **Horizon** | Mobile app redesign |
→ Details: memory/projects/

## Preferences
- 25-min meetings with buffers
- Async-first, Slack over email
- No meetings Friday afternoons

深层记忆格式（memory/）

memory/glossary.md：解码表

# Glossary

Workplace shorthand, acronyms, and internal language.

## Acronyms
| Term | Meaning | Context |
|------|---------|---------|
| PSR | Pipeline Status Report | Weekly sales doc |
| OKR | Objectives & Key Results | Quarterly planning |
| P0/P1/P2 | Priority levels | P0 = drop everything |

## Internal Terms
| Term | Meaning |
|------|---------|
| standup | Daily 9am sync in #engineering |
| the migration | Project Phoenix database work |
| ship it | Deploy to production |
| escalate | Loop in leadership |

## Nicknames → Full Names
| Nickname | Person |
|----------|--------|
| Todd | Todd Martinez (Finance) |
| T | Also Todd Martinez |

## Project Codenames
| Codename | Project |
|----------|---------|
| Phoenix | Database migration |
| Horizon | New mobile app |

memory/people/{name}.md：

# Todd Martinez

**Also known as:** Todd, T
**Role:** Finance Lead
**Team:** Finance
**Reports to:** CFO (Michael Chen)

## Communication
- Prefers Slack DM
- Quick responses, very direct
- Best time: mornings

## Context
- Handles all PSRs and financial reporting
- Key contact for deal approvals over $500k
- Works closely with Sales on forecasting

## Notes
- Cubs fan, likes talking baseball

memory/projects/{name}.md：

# Project Phoenix

**Codename:** Phoenix
**Also called:** "the migration"
**Status:** Active, launching Q2

## What It Is
Database migration from legacy Oracle to PostgreSQL.

## Key People
- Sarah - tech lead
- Todd - budget owner
- Greg - stakeholder (sales impact)

## Context
$1.2M budget, 6-month timeline. Critical path for Horizon project.

memory/context/company.md：

# Company Context

## Tools & Systems
| Tool | Used for | Internal name |
|------|----------|---------------|
| Slack | Communication | - |
| Asana | Engineering tasks | - |
| Salesforce | CRM | "SF" or "the CRM" |
| Notion | Docs/wiki | - |

## Teams
| Team | What they do | Key people |
|------|--------------|------------|
| Platform | Infrastructure | Sarah (lead) |
| Finance | Money stuff | Todd (lead) |
| Sales | Revenue | Greg |

## Processes
| Process | What it means |
|---------|---------------|
| Weekly sync | Monday 10am all-hands |
| Ship review | Thursday deploy approval |

如何交互

解码用户输入（分层查找）

始终先解码简写，再执行请求：

1. CLAUDE.md (hot cache)     → Check first, covers 90% of cases
2. memory/glossary.md        → Full glossary if not in hot cache
3. memory/people/, projects/ → Rich detail when needed
4. Ask user                  → Unknown term? Learn it.

示例：

User: "ask todd to do the PSR for oracle"

CLAUDE.md lookup:
  "todd" → Todd Martinez, Finance ✓
  "PSR" → Pipeline Status Report ✓
  "oracle" → (not in hot cache)

memory/glossary.md lookup:
  "oracle" → Oracle Systems deal ($2.3M) ✓

Now Claude can act with full context.

添加记忆

当用户说“记住这个”或“X 指的是 Y”时：

1. 术语条目（缩写、术语、简写）：

   • 添加到 memory/glossary.md
   • 如果经常使用，添加到 CLAUDE.md 的快速术语表

2. 人员：

   • 创建或更新 memory/people/{name}.md
   • 如果重要，添加到 CLAUDE.md 的关键人员
   • 记录昵称：对解码至关重要

3. 项目：

   • 创建或更新 memory/projects/{name}.md
   • 如果正在进行，添加到 CLAUDE.md 的活跃项目
   • 记录代号：“Phoenix”、“the migration”等

4. 偏好： 添加到 CLAUDE.md 的偏好部分

回忆记忆

当用户问“X 是谁”或“X 是什么意思”时：

1. 先检查 CLAUDE.md
2. 再检查 memory/ 获取完整细节
3. 如果未找到：“我还不知道 X 是什么意思。你能告诉我吗？”

渐进式披露

1. 加载 CLAUDE.md，快速解析任何请求
2. 当需要完整背景来执行时，深入 memory/
3. 示例：起草一封关于 PSR 的邮件给 todd
   • CLAUDE.md 告诉你 Todd = Todd Martinez，PSR = Pipeline Status Report
   • memory/people/todd-martinez.md 告诉你他偏好 Slack，且说话直接

初始化

使用 /productivity:start 通过扫描你的聊天、日历、邮件和文档进行初始化。提取人员、项目，并开始构建术语表。

约定

• CLAUDE.md 中的粗体术语，便于快速浏览
• 保持 CLAUDE.md 在约 100 行以内（“热门 30”规则）
• 文件名：小写，使用连字符（todd-martinez.md、project-phoenix.md）
• 始终记录昵称和别名
• 使用术语表表格，便于查找
• 当某项被频繁使用时，将其提升到 CLAUDE.md
• 当某项过时时，将其降级到仅保留在 memory/ 中

各类内容归属

类型	CLAUDE.md（热缓存）	memory/（完整存储）
人员	前约 30 位常用联系人	glossary.md + people/{name}.md
缩写/术语	约 30 个最常用的	glossary.md（完整列表）
项目	仅活跃项目	glossary.md + projects/{name}.md
昵称	若在前 30 则列入关键人员	glossary.md（所有昵称）
公司背景	仅快速参考	context/company.md
偏好	所有偏好	-
历史/过时内容	✗ 移除	✓ 保留在 memory/ 中

晋升 / 降级

晋升到 CLAUDE.md 的情况：

• 你频繁使用某个术语或提及某个人
• 它属于正在进行的工作

仅在以下情况降级到 memory/：

• 项目已完成
• 不再与某人频繁联系
• 术语很少使用

这能让 CLAUDE.md 保持新鲜且与当前相关。