---
description: 总结开发经验 — 将技术教训与用户价值取向保存为可复用的经验文档
---

# 总结开发经验

## 经验核心价值

经验库的真正价值在于**价值取向**（用户决策偏好）。技术问题多种解法不难找，选哪个方向才难。用户每次技术选择都隐藏着底层价值观和偏好。

| 层次 | 内容 | AI 获取难度 |
|---|---|---|
| 技术知识 | 框架模式、API 细节、常见坑 | 低 |
| **价值取向** | 用户决策偏好、取舍价值观 | 高（仅互动中获得） |

## 经验目录

| 目录 | 用途 | 子目录示例 |
|---|---|---|
| `./experiences/` | 项目相关 | 按需创建 |
| `~/mtools/experiences/` | 跨项目通用 | `react/`, `nodejs/`, `general/` 等按技术栈分类 |

> 子目录保存时动态创建。

**第一步：判断是否有新经验**

回顾本次开发：用户是否在多方案中做了选择？是否修改方案？是否指出 bug？是否纠正你的假设？以上全否则告知用户"无需总结"，跳到第六步。

**第二步：提取价值取向（核心）**

1. **方案选择取舍**：用户选了哪个方案？反映更看重什么（简洁 vs 性能、灵活 vs 规范）？
2. **方案调整价值观**：用户修改了什么？揭示你与用户的什么价值观差异？**往往最重要**
3. **代码问题**：什么类型的 bug？是你缺知识还是缺意识？

**第三步：判断归属**

- 通用经验（框架模式、跨项目取舍）→ `~/mtools/experiences/<分类>/`
- 项目经验（与项目业务强相关）→ `./experiences/`

**第四步：检查是否修正已有经验**

`/dev-new` 已加载经验列表，若同主题经验已存在则**修改原文件**（追加案例、补充取向、更新要点，矛盾时以最新为准），不同主题才新建。

**第五步：编写/修正文档**

```markdown
---
description: 一句话描述（技术点 + 价值取向）
---

# <经验标题>

## 场景
## 价值取向（核心）
— 用户做了什么决策？反映什么偏好？AI 默认倾向 vs 用户选择？将来类似取舍偏向哪个方向？

## 技术要点
## 教训
— 为什么发生/选错？如何避免？
```

可根据情况省略部分章节。文件命名：`<经验主题>.md`（中文，简洁）

**第六步：引导下一步**

引导用户 `/dev-commit`。

## 注意

- 价值取向是文档**核心**章节，必须分析，不能省略
- 若用户没提出修改意见或 bug，如实记录，不硬凑