Eo Project Lesson

eo-project-lesson

功能

捕获项目经验教训，写入项目级 lessons/ 目录（每个项目独立，不再有全局 _lessons/）。若项目有看板，同步更新经验教训计数。

配置与目录约定见 [eo-project-init/references/config.md](../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 目录：/lessons/（lazy 创建，本 skill 首次运行时建）。

执行步骤

1. 定位项目

读取 .eo-project.json，获取 project_root / project_name / kanban_path。

2. 提炼经验教训

从用户输入提取：

• 标题：一句话概括
• 类别：pitfall / best-practice / surprise
• 阶段：从活跃 phase 文件读取（若有）
• 内容：发生了什么 + 学到了什么 + 下次怎么做

3. 创建经验文件

• 首次运行时 lazy 建 /lessons/ 目录
• 文件命名：{YYYY-MM-DD}-{简述}.md（不再需要 {项目名} 前缀，因为已按项目隔离）

---
type: lesson
category: "pitfall" | "best-practice" | "surprise"
project: "项目名"
phase: "phase-N-阶段名"
date: YYYY-MM-DD
tags: []
---

# {标题}

## 发生了什么

{背景和经过}

## 学到了什么

{核心教训}

## 下次怎么做

{可操作的改进方案}

4. 更新项目看板（仅 kanban_path 非空）

更新对应项目条目的经验教训计数（读当前 /lessons/ 条目数）。

5. 追加项目日志

在 /log.md 追加一条记录。

6. 输出摘要

• 经验文件路径
• 经验摘要
• 当前项目累计经验数

输出

• 经验文件：/lessons/{date}-{slug}.md
• 看板更新（可选）：经验教训计数
• 项目日志：追加记录

约束

• 经验文件一旦创建不可修改，只能新建补充
• 经验按项目隔离，不再有全局 _lessons/
• 首次运行时 lazy 建 lessons/ 目录
• 能推断的字段自动填充
• 路径通过 .eo-project.json 解析，不硬编码
• kanban_path: null 时不更新看板

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: SimpleEve
• Source: SimpleEve/eo-skills
• License: MIT

Install and usage instructions live in the source repository linked above.