- name
- project-retrospective
- version
- 1.0.0
- description
- 自动项目复盘机制。当完成复杂项目后，自动提取最优路径生成skill，并记录踩坑经验到memory。
- author
- 小爪 (OpenClaw Community)
- tags
- [retrospective, learning, meta-skill, knowledge-management]
项目自动复盘机制
1. 概述
当完成一个复杂项目的开发后，自动将经验沉淀为可复用的知识。
核心功能：
- 自动识别复盘时机
- 提取标准化最优路径 → 生成skill
- 提取踩坑经验 → 记录到memory
2. 触发条件
满足以下所有条件时触发：
2.1 时间条件
- 对同一个项目的对话时长 ≥ 2小时
- 或消息轮数 ≥ 50轮
2.2 复杂度条件
- 经历了多次尝试和修正
- 遇到了多个问题和解决方案
- 涉及多个文件的创建和修改
2.3 用户触发
用户明确表示要总结，例如：
- "总结一下"
- "把这个过程和经验总结一下"
- "复盘一下"
- "记录下来"
3. 执行流程
步骤1：确认复盘意图
当检测到触发条件时，询问用户：
检测到你刚完成了一个复杂项目的开发。是否需要我帮你：
1. 提取标准化流程，生成可复用的skill
2. 记录踩坑经验到memory
这样下次遇到类似项目时可以直接参考。步骤2：分析对话历史
- 提取项目目标和背景
- 识别关键步骤和决策点
- 找出遇到的问题和解决方案
- 总结最佳实践
步骤3：生成skill文档
文件位置：/root/.openclaw/workspace/skills/<project-name>/SKILL.md
内容结构：
---
name: project-name
description: 简短描述这个skill解决什么问题
---
# 项目名称
## 1. 概述
- 适用场景
- 核心功能
## 2. 核心文件清单
- 需要创建/修改的文件列表
## 3. 详细步骤
- 步骤1：...
- 步骤2：...
- ...
## 4. 常见问题和解决方案
- 问题1：...
- 问题2：...
## 5. 案例分析
- 实际应用示例
- 经验教训步骤4：生成memory文档
文件位置：/root/.openclaw/workspace/memory/YYYY-MM-DD-<project-name>-pitfalls.md
内容结构：
# 项目名称踩坑记录
**日期**：YYYY-MM-DD
**项目**：项目描述
## 1. 问题1标题
### 问题描述
详细描述遇到的问题
### 尝试的解决方案
- ❌ 方案1 - 为什么失败
- ❌ 方案2 - 为什么失败
- ✅ 方案3 - 最终成功
### 最终解决方案
具体的解决步骤
### 经验教训
从这个问题中学到的经验
---
## 2. 问题2标题
...
---
## 总结和最佳实践
- 开发流程建议
- 文件管理建议
- 调试技巧步骤5：确认和保存
- 展示生成的文档路径
- 询问用户是否需要修改
- 保存到对应位置
4. 使用示例
场景：开发FitClaw健身教练Agent
对话时长：约3小时 消息轮数：100+轮 涉及文件：10+个
用户触发：
用户："很好，然后小龙虾就先到这一段，然后我交接了。
然后这个过程中，你要做两个：
第一个：把做成一只垂直类的这种小龙虾的流程写成一个 skill
第二个：就是把我们踩过的坑你写在 memory 里面"系统响应：
- 创建skill：
vertical-agent-creator - 创建memory：
2026-03-12-fitclaw-pitfalls.md
5. 注意事项
5.1 何时使用
- ✅ 完成了复杂的多步骤项目
- ✅ 经历了多次尝试和修正
- ✅ 积累了可复用的经验
- ❌ 简单的一次性任务
- ❌ 没有通用价值的特定操作
5.2 文档质量
- 标准化流程要清晰、可复用
- 踩坑记录要详细、有价值
- 包含具体的代码示例和命令
- 记录失败的尝试和原因
5.3 命名规范
- skill名称：
<domain>-<function> - memory文件：
YYYY-MM-DD-<project>-pitfalls.md
6. 参考案例
案例1：FitClaw开发
- 生成的skill：
vertical-agent-creator - 生成的memory：
2026-03-12-fitclaw-pitfalls.md - 价值：下次创建垂直类Agent时可直接参考
案例2：生图功能实现
- 关键经验：API key加密、容灾机制
- 踩坑点：脚本丢失、路径限制
- 可复用性：高（其他需要图片处理的项目都可参考）
使用建议：每次完成复杂项目后，主动触发复盘机制，持续积累可复用的知识库。