| name | eo-project-lesson |
| description | 捕获项目经验教训（踩坑、最佳实践、意外收获），写入当前项目的 lessons/ 目录。通过 .eo-project.json 定位。触发：踩坑了 / 记录经验 / 教训 / lesson learned / /eo-project-lesson。 |
eo-project-lesson
功能
捕获项目经验教训，写入项目级 lessons/ 目录（每个项目独立，不再有全局 _lessons/）。若项目有看板，同步更新经验教训计数。
配置与目录约定见 eo-project-init/references/config.md。
前置
必须能找到 .eo-project.json。找不到 → 报错退出，提示运行 /eo-project-init。
输入
- 经验内容：发生了什么、学到了什么
- 类别（可选，能推断就推断）：
pitfall / best-practice / surprise
路径解析
从 .eo-project.json 读取：
project_root — 项目管理侧根project_name — 填入文件 frontmatterkanban_path — 更新经验教训计数（null 时跳过）
lessons 目录：<project_root>/lessons/（lazy 创建，本 skill 首次运行时建）。
执行步骤
1. 定位项目
读取 .eo-project.json，获取 project_root / project_name / kanban_path。
2. 提炼经验教训
从用户输入提取：
- 标题：一句话概括
- 类别：
pitfall / best-practice / surprise
- 阶段：从活跃 phase 文件读取（若有）
- 内容：发生了什么 + 学到了什么 + 下次怎么做
3. 创建经验文件
- 首次运行时 lazy 建
<project_root>/lessons/ 目录
- 文件命名：
{YYYY-MM-DD}-{简述}.md（不再需要 {项目名} 前缀，因为已按项目隔离）
---
type: lesson
category: "pitfall" | "best-practice" | "surprise"
project: "项目名"
phase: "phase-N-阶段名"
date: YYYY-MM-DD
tags: []
---
# {标题}
## 发生了什么
{背景和经过}
## 学到了什么
{核心教训}
## 下次怎么做
{可操作的改进方案}
4. 更新项目看板（仅 kanban_path 非空）
更新对应项目条目的经验教训计数（读当前 <project_root>/lessons/ 条目数）。
5. 追加项目日志
在 <project_root>/log.md 追加一条记录。
6. 输出摘要
输出
- 经验文件：
<project_root>/lessons/{date}-{slug}.md
- 看板更新（可选）：经验教训计数
- 项目日志：追加记录
约束
- 经验文件一旦创建不可修改，只能新建补充
- 经验按项目隔离，不再有全局
_lessons/
- 首次运行时 lazy 建
lessons/ 目录
- 能推断的字段自动填充
- 路径通过
.eo-project.json 解析，不硬编码
kanban_path: null 时不更新看板
