# 经验模板

开发过程中记录的纠正、经验与知识缺口。

**分类**：correction | insight | knowledge_gap | best_practice
**区域**：frontend | backend | infra | tests | docs | config
**状态**：pending | in_progress | resolved | wont_fix | promoted | promoted_to_skill

## 状态定义

| 状态 | 含义 |
|--------|---------|
| `pending` | 尚未处理 |
| `in_progress` | 正在处理中 |
| `resolved` | 问题已修复，或知识已吸收并更新 |
| `wont_fix` | 决定不处理（原因写在 Resolution 中） |
| `promoted` | 已提升到 `CLAUDE.md`、`AGENTS.md` 或 `copilot-instructions.md` |
| `promoted_to_skill` | 已提炼成可复用 skill |

## 技能提炼字段

当某条 learning 被提升为 skill 时，需要新增这些字段：

```markdown
**Status**: promoted_to_skill
**Skill-Path**: skills/skill-name
```

示例：
```markdown
## [LRN-20250115-001] best_practice

**Logged**: 2025-01-15T10:00:00Z
**Priority**: high
**Status**: promoted_to_skill
**Skill-Path**: skills/docker-m1-fixes
**Area**: infra

### Summary
Docker build 在 Apple Silicon 上因平台不匹配而失败
...
```

---