eo-project-lesson

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 — 填入文件 frontmatter
• kanban_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 时不更新看板