名称： reflect
描述： 通过对话分析实现自我提升。从修正和成功模式中提取经验，永久编码到智能体定义中。核心理念：一次修正，永不再犯。
版本： "2.0.0"
user-invocable: true
触发器：
- reflect
- self-reflect
- review session
- what did I learn
- extract learnings
- analyze corrections
允许工具：
- Read
- Write
- Edit
- Grep
- Glob
- Bash
元数据：
clawdbot:
emoji: "🪞"
config:
stateDirs: ["~/.reflect"]

Reflect - 智能体自我提升技能

将您的AI助手转变为持续进化的伙伴。每一次修正都将转化为永久性的改进，并在所有未来会话中持续生效。

快速参考

使用时机

• 完成复杂任务后
• 当用户明确修正行为时（如“永远不要做X”、“总是Y”）
• 在会话边界或上下文压缩前
• 当发现值得保留的成功模式时

工作流程

步骤 1：扫描对话以识别信号

分析对话，识别修正信号和学习机会。

信号置信度等级：

完整检测规则请参见 signal_patterns.md。

步骤 2：分类并匹配目标文件

将每个信号映射到相应的目标：

映射规则请参见 agent_mappings.md。

步骤 3：检查是否值得创建新技能

某些经验应创建为新技能，而非仅更新智能体：

值得创建技能的标准：
- 非显而易见的调试（>10分钟调查）
- 误导性错误（根本原因与消息不符）
- 通过实验发现的变通方案
- 配置洞察（与文档不同）
- 可重用模式（有助于类似情况）

质量门控（必须全部通过）：
- [ ] 可重用：有助于未来任务
- [ ] 非琐碎：需要探索，而非仅查阅文档
- [ ] 具体：能描述确切的触发条件
- [ ] 已验证：解决方案确实有效
- [ ] 无重复：尚不存在

步骤 4：生成提案

以结构化格式呈现发现：

# 反思分析

## 会话上下文
- **日期**: [时间戳]
- **分析的消息数**: [数量]

## 检测到的信号

| # | 信号 | 置信度 | 来源引述 | 类别 |
|---|--------|------------|--------------|----------|
| 1 | [学习内容] | 高 | "[原话]" | 代码风格 |

## 建议的更改

### 更改 1：更新 [智能体名称]
**目标**: `[文件路径]`
**部分**: [部分名称]
**置信度**: 高

```diff
+ 根据经验添加的新规则

审阅提示

应用这些更改吗？(Y/N/modify/1,2,3)

### 步骤 5：经用户批准后应用

**当选择 `Y`（批准）时：**
1. 使用编辑工具应用每个更改
2. 提交并附带描述性信息
3. 更新指标

**当选择 `N`（拒绝）时：**
1. 丢弃建议的更改
2. 记录拒绝以供分析

**当选择 `modify`（修改）时：**
1. 单独呈现每个更改
2. 允许在应用前编辑

**当选择性批准时（例如 `1,3`）：**
1. 仅应用指定的更改
2. 提交部分更新

## 状态管理

状态存储在 `~/.reflect/`（可通过 `REFLECT_STATE_DIR` 配置）：

```yaml
# reflect-state.yaml
auto_reflect: false
last_reflection: "2026-01-26T10:30:00Z"
pending_reviews: []

指标追踪

# reflect-metrics.yaml
total_sessions_analyzed: 42
total_signals_detected: 156
total_changes_accepted: 89
acceptance_rate: 78%
confidence_breakdown:
  high: 45
  medium: 32
  low: 12
most_updated_agents:
  code-reviewer: 23
  backend-developer: 18
skills_created: 5

安全护栏

人工参与循环

• 绝不在未经用户明确批准的情况下应用更改
• 应用前始终显示完整的差异对比
• 允许选择性应用

增量更新

• 仅添加到现有部分
• 绝不删除或重写现有规则
• 保留原始结构

冲突检测

• 检查建议的规则是否与现有规则冲突
• 检测到冲突时警告用户
• 建议解决策略

输出位置

项目级别（随仓库版本控制）：
- .claude/reflections/YYYY-MM-DD_HH-MM-SS.md - 完整反思记录
- .claude/skills/{name}/SKILL.md - 新技能

全局（用户级别）：
- ~/.reflect/learnings.yaml - 学习日志
- ~/.reflect/reflect-metrics.yaml - 聚合指标

示例

示例 1：代码风格修正

用户说：“在TypeScript中永远不要使用 var，总是使用 const 或 let”

检测到的信号：
- 置信度：高（明确的“从不”+“总是”）
- 类别：代码风格
- 目标：frontend-developer.md

建议的更改：

## 风格指南
+ * 在TypeScript中使用 `const` 或 `let`，而非 `var`

示例 2：流程偏好

用户说：“提交前总是运行测试”

检测到的信号：
- 置信度：高（明确的“总是”）
- 类别：流程
- 目标：CLAUDE.md

建议的更改：

## 提交规范
+ * 创建提交前运行测试套件

示例 3：从调试中创建新技能

上下文：花费30分钟调试React水合不匹配问题

检测到的信号：
- 置信度：高（非琐碎调试）
- 类别：新技能
- 质量门控：全部通过

建议的技能：react-hydration-fix/SKILL.md

故障排除

未检测到信号：
- 会话可能没有修正内容
- 检查是否使用了自然语言修正

冲突警告：
- 审阅引用的现有规则
- 决定新规则是否应覆盖旧规则
- 可在应用前修改

未找到智能体文件：
- 检查智能体名称拼写
- 可能需要先创建智能体文件