Self Reflection技能使用说明

智能体会重复犯错。并非因为它们能力不足——而是因为它们会遗忘。这项技能改变了这一点。你的智能体在交付前会暂停，捕捉自身的盲点，并记住教训以供下次使用。

适用场景

当用户需要超越“看起来没问题”的质量保证时。智能体负责交付前评估、错误后分析、跨会话模式检测，以及在重复犯错前主动提出经验教训。

运作机制

         ┌──────────────────────────────────────────────┐
         │              SELF REFLECTION LOOP            │
         └──────────────────────────────────────────────┘
                              │
         ┌────────────────────┼────────────────────┐
         ▼                    ▼                    ▼
    ┌─────────┐         ┌──────────┐         ┌─────────┐
    │  PRE    │         │  POST    │         │PATTERN  │
    │DELIVERY │         │ MISTAKE  │         │DETECTED │
    └────┬────┘         └────┬─────┘         └────┬────┘
         │                   │                    │
         │  "Before I send   │  "User corrected   │  Same mistake
         │   this, let me    │   me. Why?"        │  3 times...
         │   double-check"   │                    │
         │                   │                    │
         └───────────────────┴────────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │ 7-DIMENSION     │
                    │ EVALUATION      │
                    │ (30 seconds)    │
                    └────────┬────────┘
                              │
              ┌───────────────┴───────────────┐
              ▼                               ▼
       ┌─────────────┐                 ┌─────────────┐
       │  ALL CLEAR  │                 │ ISSUE FOUND │
       │  Deliver    │                 │ Fix first   │
       └─────────────┘                 └──────┬──────┘
                                              │
                                              ▼
                                    ┌─────────────────┐
                                    │  LOG LESSON     │
                                    │  Miss → Root    │
                                    │  → Prevention   │
                                    └────────┬────────┘
                                              │
                                              ▼
                                    ┌─────────────────┐
                                    │  INJECT NEXT    │
                                    │  TIME           │
                                    │  "Before we     │
                                    │   proceed..."   │
                                    └─────────────────┘

三大触发机制

1. 🔍 交付前检查

在发送重要工作前，暂停30秒。快速扫描7个维度。

适用时机：代码、架构、策略，任何用户将据此采取行动的可交付成果。

2. ❌ 错误后分析

用户纠正了你。这是宝贵数据。在会话结束前将其捕获。

适用时机：当用户说“其实...”、“不，那是错的”、“我的意思是...”，或出现沮丧信号时。

3. 🔄 模式检测

同一类问题出现3次以上？这不是巧合——这是一个盲点。

适用时机：记录5次反思、周度回顾或心跳触发后。

架构

记忆存储于~/reflection/目录下。配置说明参见memory-template.md文件。

~/reflection/
├── memory.md           # Status + preferences + stats
├── reflections.md      # Log (most recent first)
├── patterns.md         # Detected patterns
└── archive/            # Monthly archives

快速参考

核心规则

1. 行动前检查经验教训

开展重要工作前，请扫描~/reflection/patterns.md文件。提取相关经验：

"在继续之前——我有一项关于[主题]的过往工作经验：[摘要]。"

2. 使用七维度评估

任何维度评分低于7/10 → 交付前务必修正。

3. 记录所有修正

当用户纠正你时：

1. 立即停止并确认
2. 分析根本原因
3. 记录至~/reflection/reflections.md：

## YYYY-MM-DD | [category]
**Miss:** What went wrong
**Root:** Why (5 whys)
**Fix:** Prevention rule

4. 识别模式（积累5次反思后）

• 同一类别出现3次以上 → 制定预防规则
• 相同错误出现两次 → 升级为模式问题
• 呈现改进趋势 → 记录有效方法

5. 每次反思的归类

默认分类：技术层面、沟通层面、预设假设、流程规范、范围界定

6. 月度归档

将已处理的反思移动到~/reflection/archive/YYYY-MM.md。保持reflections.md简洁。

7. 追踪连续记录

重复错误后的天数。模式重现时重置。庆祝里程碑。

模式生命周期

┌──────────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   EMERGING   │ ──▶ │    ACTIVE    │ ──▶ │  MONITORING  │ ──▶ │   RESOLVED   │
│  2 similar   │     │  3+ times    │     │  Prevention  │     │  30 days     │
│  reflections │     │  → create    │     │  in place    │     │  clean       │
└──────────────┘     │    rule      │     └──────────────┘     └──────────────┘
                     └──────────────┘

模式位于~/reflection/patterns.md中：

## [Pattern Name]
category: technical
frequency: 4 occurrences
status: active | monitoring | resolved

**Pattern:** What keeps happening
**Root:** Why this pattern exists
**Prevention:** Rule to break it
**Last seen:** YYYY-MM-DD
**Streak:** X days without recurrence

"下次注入"的超能力

该技能的真实价值：在重复犯错之前提取经验教训。

工作原理：

1. 开始工作前，识别任务领域
2. 检查~/reflection/patterns.md中的活跃模式
3. 如果存在相关模式 → 自然地提及它

示例：

"在我们构建这个API之前——我有一个关于超时处理的教训，来自之前的项目。这次让我确保包含适当的错误超时处理。"

设置

首次使用时，请阅读setup.md以获取集成指南。它会在~/reflection/目录下创建记忆文件（如果用户询问，会告知数据存储位置）。

常见陷阱

相关技能

使用以下命令安装clawhub install <slug>（如果用户确认）：

• 记忆— 持久性记忆模式
• 决策— 自主决策能力
• 学习— 自适应学习系统

反馈

• 如有帮助：clawhub 星辉反思
• 保持更新：clawhub 同步