项目自动复盘机制

1. 概述

当完成一个复杂项目的开发后，自动将经验沉淀为可复用的知识。

核心功能：

• - 自动识别复盘时机
• 提取标准化最优路径 → 生成skill
• 提取踩坑经验 → 记录到memory

2. 触发条件

满足以下所有条件时触发：

2.1 时间条件

• - 对同一个项目的对话时长 ≥ 2小时
• 或消息轮数 ≥ 50轮

2.2 复杂度条件

• - 经历了多次尝试和修正
• 遇到了多个问题和解决方案
• 涉及多个文件的创建和修改

2.3 用户触发

• - 总结一下
• 把这个过程和经验总结一下
• 复盘一下
• 记录下来

3. 执行流程

步骤1：确认复盘意图

检测到你刚完成了一个复杂项目的开发。是否需要我帮你：

1. 1. 提取标准化流程，生成可复用的skill
2. 记录踩坑经验到memory

这样下次遇到类似项目时可以直接参考。

步骤2：分析对话历史

• - 提取项目目标和背景
• 识别关键步骤和决策点
• 找出遇到的问题和解决方案
• 总结最佳实践

步骤3：生成skill文档

文件位置：/root/.openclaw/workspace/skills//SKILL.md

内容结构：
markdown

项目名称

1. 概述

• - 适用场景
• 核心功能

2. 核心文件清单

• - 需要创建/修改的文件列表

3. 详细步骤

• - 步骤1：...
• 步骤2：...
• ...

4. 常见问题和解决方案

• - 问题1：...
• 问题2：...

5. 案例分析

• - 实际应用示例
• 经验教训

步骤4：生成memory文档

文件位置：/root/.openclaw/workspace/memory/YYYY-MM-DD--pitfalls.md

内容结构：
markdown

项目名称踩坑记录

日期：YYYY-MM-DD
项目：项目描述

1. 问题1标题

问题描述

尝试的解决方案

• - ❌ 方案1 - 为什么失败
• ❌ 方案2 - 为什么失败
• ✅ 方案3 - 最终成功

最终解决方案

经验教训

2. 问题2标题

总结和最佳实践

• - 开发流程建议
• 文件管理建议
• 调试技巧

步骤5：确认和保存

• - 展示生成的文档路径
• 询问用户是否需要修改
• 保存到对应位置

4. 使用示例

场景：开发FitClaw健身教练Agent

对话时长：约3小时
消息轮数：100+轮
涉及文件：10+个

用户触发：

用户：很好，然后小龙虾就先到这一段，然后我交接了。
然后这个过程中，你要做两个：
第一个：把做成一只垂直类的这种小龙虾的流程写成一个 skill
第二个：就是把我们踩过的坑你写在 memory 里面

系统响应：

1. 1. 创建skill：vertical-agent-creator
2. 创建memory：2026-03-12-fitclaw-pitfalls.md

5. 注意事项

5.1 何时使用

• - ✅ 完成了复杂的多步骤项目
• ✅ 经历了多次尝试和修正
• ✅ 积累了可复用的经验
• ❌ 简单的一次性任务
• ❌ 没有通用价值的特定操作

5.2 文档质量

• - 标准化流程要清晰、可复用
• 踩坑记录要详细、有价值
• 包含具体的代码示例和命令
• 记录失败的尝试和原因

5.3 命名规范

• - skill名称：-
• memory文件：YYYY-MM-DD--pitfalls.md

6. 参考案例

案例1：FitClaw开发

• - 生成的skill：vertical-agent-creator
• 生成的memory：2026-03-12-fitclaw-pitfalls.md
• 价值：下次创建垂直类Agent时可直接参考

案例2：生图功能实现

• - 关键经验：API key加密、容灾机制
• 踩坑点：脚本丢失、路径限制
• 可复用性：高（其他需要图片处理的项目都可参考）