Project Retrospective

自动项目复盘机制。当完成复杂项目后，自动提取最优路径生成skill，并记录踩坑经验到memory。

Security Scan

The skill's requirements and instructions are coherent with its stated purpose: it analyzes conversation history, drafts a reusable skill document and a pitfalls (memory) file, and asks the user before saving; it does not request extra credentials or install anything.

Purpose & Capability

The name/description (automatic project retrospective → generate a skill and record pitfalls) matches the instructions: detect long/complex conversations, extract steps/issues, and produce SKILL.md and memory files under the workspace. There are no unrelated env vars or binaries requested.

Instruction Scope

Instructions require reading the dialogue history and extracting project context, which is appropriate for the stated purpose. The skill will write files to /root/.openclaw/workspace/skills/<project-name>/SKILL.md and /root/.openclaw/workspace/memory/.... The SKILL.md specifies that the agent should ask the user to confirm before saving, which limits unilateral actions. One minor scope note: the trigger heuristics (2+ hours or 50+ messages, plus complexity conditions) could be broad and may produce prompts unexpectedly; consider whether you want automatic triggering or explicit user initiation only.

Install Mechanism

Instruction-only skill with no install step and no code files. This is the lowest-risk install mechanism and matches the description.

Credentials

No environment variables, binaries, or external credentials are requested. The skill only reads conversation context and writes workspace files, which fits its purpose.

Persistence & Privilege

The skill persists generated documents into the agent workspace (skills/ and memory/). Persisting new SKILL.md files can create reusable artifacts that might be later used by agents; however, the instructions include a user confirmation step before saving and do not instruct modifying other skills or global agent config. If you are concerned about persistent expansion of capabilities, review the generated files before enabling them or restrict autonomous behavior.

Assessment

This skill analyzes completed conversations and writes two kinds of files into your agent workspace: a SKILL.md for a reusable skill and a pitfalls memory file. It does not request credentials or install software. Before installing, consider: (1) whether you want automatic triggers based on conversation length/turns — you may prefer explicit user initiation to avoid unexpected prompts; (2) review generated SKILL.md and memory files before they are used or shared (they can become reusable artifacts); (3) ensure workspace file permissions and backups are acceptable; (4) if you restrict autonomous agent actions, the skill's confirm-before-save step helps, but you may still want to keep it user-invocable only and not allow unattended autonomous invocation.

项目自动复盘机制

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 里面"

系统响应：

1. 创建skill：vertical-agent-creator
2. 创建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加密、容灾机制
• 踩坑点：脚本丢失、路径限制
• 可复用性：高（其他需要图片处理的项目都可参考）

---

使用建议：每次完成复杂项目后，主动触发复盘机制，持续积累可复用的知识库。