名称： 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.  使用 Edit 工具应用每个更改
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"

检测到的信号：
- 置信度：高（明确的"never" + "always"）
- 类别：代码风格
- 目标：frontend-developer.md

建议的更改：

## 风格指南
+ * 在 TypeScript 中使用 `const` 或 `let` 代替 `var`

示例 2：流程偏好

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

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

建议的更改：

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

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

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

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

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

故障排除

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

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

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