auto-extract

# 会话学习技能

分析当前会话，提取有价值的学习内容，并持久化到合适的存储层。

## 分析维度

回顾会话，关注：

| 维度 | 关注点 |
|------|--------|
| **进展顺利** | 成功的方法、有效的解决方案、好的决策 |
| **进展不顺** | 失败的尝试、错误的方向、浪费时间的地方 |
| **用户分歧** | 用户纠正你的地方、拒绝的建议、表达不满的地方 |
| **推断偏好** | 沟通风格、工具偏好、代码风格、工作流习惯 |

## 三层分类

### 设计原则

| 层级 | 核心问题 | 特性 |
|------|----------|------|
| 项目 CLAUDE.md | "这个项目需要知道什么？" | 项目特定、版本控制 |
| 用户 CLAUDE.md | "每个会话都需要知道什么？" | 身份性、高频、token 预算有限 |
| Memory MCP | "特定情境下需要召回什么？" | 情境性、按需查询、无限容量 |

### 决策树

```
对于每个学习项，依次问：
│
├─ Q1: 是否与当前项目的代码/架构/工具链直接相关？
│   └─ 是 → 项目 CLAUDE.md
│
├─ Q2: 是否是每个新会话都需要的信息？
│   ├─ 是：这是"我是谁"（身份/核心偏好/环境）还是"我学到了什么"（经验）？
│   │   ├─ 身份/核心偏好 → 用户 CLAUDE.md
│   │   └─ 通用经验 → Memory MCP（但考虑提炼核心到用户层）
│   └─ 否 → 继续 Q3
│
└─ Q3: 是否是特定情境才需要的经验/知识/解决方案？
    └─ 是 → Memory MCP
```

**关键区分**：
- **用户 CLAUDE.md**: "What I always need to know"（身份层）
- **Memory MCP**: "What I learned for specific situations"（经验层）

### 分类示例

| 学习内容 | 层级 | 理由 |
|----------|------|------|
| "这个项目用 Vitest 测试" | 项目 | 项目特定工具 |
| "用 `bun test` 运行测试" | 项目 | 项目特定命令 |
| "React hooks 中不要用 async/await" | 项目 | 项目特定陷阱 |
| "用户偏好 bun 而非 npm" | 用户 | 每会话需要的工具选择 |
| "用户偏好简洁响应" | 用户 | 每响应都需要的风格 |
| "用户偏好中文交流" | 用户 | 每会话需要的语言设置 |
| "GitHub Code Search 按相关性排序" | Memory | 特定技术的经验教训 |
| "OpenSpec archive 失败检查 ADDED vs MODIFIED" | Memory | 特定工具的问题解决 |
| "并行 API 调用用 ThreadPoolExecutor" | Memory | 特定场景的解决方案 |

## 持久化指南

### 第一层：项目 CLAUDE.md

**位置**: `{repo}/CLAUDE.md` 或 `{repo}/.claude/CLAUDE.md`

**优先级**: 如果 `.claude/CLAUDE.md` 存在，优先使用它（项目内聚）；否则使用根目录的 `CLAUDE.md`。

**插入策略**（保持文档组织性）:
1. **先阅读整个 CLAUDE.md**，理解现有结构和 sections
2. **找到语义上合适的位置**插入学习内容：
   - 如果已有相关 section（如 "Plugin Development Best Practices"），将学习项合并到该 section
   - 如果学习项是新类别，在逻辑上相邻的 section 附近创建新 section
3. **禁止简单追加到文件末尾**——这会破坏文档组织性
4. 编辑后整个 CLAUDE.md 应仍然结构清晰、主题分组合理

**工具**: 使用 `Edit` 工具（精确插入到合适位置）

### 第二层：用户 CLAUDE.md

**位置**: `~/.claude/CLAUDE.md`

**插入策略**（保持文档组织性）:
1. **先阅读整个 CLAUDE.md**，理解现有结构
2. **找到语义上合适的位置**插入偏好：
   - 如果已有相关 section（如 "个人偏好设置"、"工作原则"），将偏好合并到该 section
   - 如果偏好是新类别，在