Experience Skill
概述
经验沉淀与检索技能，在开发流程的关键节点自动检索相关经验，在任务完成后沉淀新经验。
核心能力
1. 经验检索 (experience-index)
触发时机:
- 需求分析前
- 方案设计前
- 代码编写前
- 问题诊断时
检索方式:
- 关键词匹配
- 语义搜索 (sou MCP)
- 标签过滤
2. 经验沉淀 (experience-deposit)
触发时机:
- 任务完成后
- 问题解决后
- 用户纠正后
- 重要决策后
沉淀内容:
- 技术决策及原因
- 问题解决方案
- 最佳实践发现
- 踩坑教训
3. 经验匹配 (experience-match)
匹配维度:
- 技术栈 (React, Node, etc.)
- 场景类型 (认证, 支付, etc.)
- 问题类型 (性能, 安全, etc.)
- 复杂度级别
经验库结构
.ai_state/experience/
├── index.md # 经验索引
├── EXP-001.md # 经验条目
├── EXP-002.md
└── categories/
├── decisions.md # 决策类经验索引
├── solutions.md # 解决方案索引
├── best-practices.md # 最佳实践索引
└── pitfalls.md # 踩坑教训索引
经验条目格式
# EXP-001: [经验标题]
## 元信息
- **ID**: EXP-001
- **创建时间**: 2025-01-01
- **关联任务**: REQ-xxx
- **类型**: decision | solution | best-practice | pitfall
- **标签**: [tag1, tag2, tag3]
## 背景
[问题或场景的背景描述]
## 经验内容
[具体的经验、决策或解决方案]
## 适用场景
[什么情况下可以参考这个经验]
## 注意事项
[使用这个经验时需要注意的点]
## 相关链接
- [相关文档]
- [代码示例]
索引文件格式
# 经验索引
## 按类型
### 技术决策
| ID | 标题 | 标签 | 日期 |
|:---|:---|:---|:---|
| EXP-001 | JWT vs Session | auth, security | 2025-01 |
### 解决方案
| ID | 标题 | 标签 | 日期 |
|:---|:---|:---|:---|
| EXP-002 | N+1查询优化 | performance, database | 2025-01 |
## 按标签
- **auth**: EXP-001, EXP-005
- **performance**: EXP-002, EXP-008
- **security**: EXP-001, EXP-003
自动检索流程
需求分析前
1. 提取需求关键词
2. 搜索相关经验:
- 类似功能的实现经验
- 相关技术的决策记录
3. 加载匹配的经验到上下文
4. 输出经验提示
示例输出:
"发现 3 条相关经验:"
"- EXP-001: JWT认证实现 (匹配度: 高)"
"- EXP-003: 用户数据安全规范 (匹配度: 中)"
方案设计前
1. 提取设计关键词
2. 搜索:
- 架构决策经验
- 技术选型经验
- 最佳实践
3. 提供设计建议
示例输出:
"根据经验 EXP-005，建议使用 Redis 做会话存储"
"原因: 支持分布式、性能好、可快速撤销"
代码编写前
1. 识别代码场景
2. 搜索:
- 代码模式经验
- 踩坑教训
3. 提供编码建议
示例输出:
"注意: 根据 EXP-007，此场景需要处理并发问题"
"建议: 使用乐观锁避免数据竞争"
经验沉淀流程
任务完成时
1. 回顾任务过程
2. 提取有价值的经验:
- 重要决策
- 解决的问题
- 发现的最佳实践
3. 生成经验条目
4. 更新索引
自动检测:
- 是否有技术决策
- 是否解决了困难问题
- 是否有用户纠正
- 是否发现更好的方法
用户纠正时
1. 记录错误行为
2. 记录正确做法
3. 分析原因
4. 生成教训经验
5. 标记为 pitfall 类型
格式:
错误: [做了什么]
正确: [应该怎么做]
原因: [为什么]
MCP 集成
检索时
// 语义搜索经验
sou_search({
query: "用户认证相关经验",
scope: ".ai_state/experience/",
limit: 5
})
// 从 Memory MCP 查询
memory_search({
query: "JWT 认证决策",
category: "experience",
limit: 3
})
沉淀时
// 存储到 Memory MCP
memory_store({
category: "experience",
title: "JWT vs Session 决策",
content: "选择 JWT 因为...",
tags: ["auth", "jwt", "decision"]
})
// 同步到本地经验库
// 写入 .ai_state/experience/EXP-xxx.md
使用示例
手动检索
# 搜索经验
/vibe-exp search "缓存策略"
# 查看经验详情
/vibe-exp show EXP-001
# 列出所有经验
/vibe-exp list
手动沉淀
# 添加新经验
/vibe-exp add "标题" --type=decision --tags=tag1,tag2
# 从当前任务沉淀
/vibe-exp deposit
配置
# orchestrator.yaml
experience:
skill_path: skills/experience/SKILL.md
storage:
local: .ai_state/experience/
mcp: memory # 同步到 Memory MCP
auto_search:
enabled: true
phases: [research, innovate, execute]
auto_deposit:
enabled: true
on_complete: true
on_correction: true
search_engine: sou # 或 grep
降级策略
若 sou MCP 不可用:
→ 使用关键词匹配搜索
若 Memory MCP 不可用:
→ 仅使用本地经验库
若本地经验库为空:
→ 提示用户开始积累经验