Claude Reflect：将对话反馈转化为智能配置

Claude Reflect 是什么

Claude Reflect 是一个 Claude Code 的自学习插件。它的核心功能很简单：自动捕获你对 Claude 的纠正和偏好，写入配置文件，让 Claude 在未来的对话中记住这些经验。

举个例子：

• 你说”不要用 var，用 const”，它记住
• 你说”测试文件放在 __tests__ 目录”，它记住
• 你纠正”这个函数应该返回 Promise”，它也记住

下次 Claude 写代码时，这些偏好会自动生效。不用每次重复。

安装

两条命令：

# 1. 添加 marketplace
claude plugin marketplace add bayramannakov/claude-reflect

# 2. 安装插件
claude plugin install claude-reflect@claude-reflect-marketplace

重启 Claude Code 即可。

系统要求：Python 3.6+，支持 macOS / Linux / Windows。

使用方法

日常使用：什么都不用做

插件通过 Hooks 自动运行。你正常和 Claude 对话，当你做出纠正或表达偏好时，插件会静默捕获并放入队列。

审核队列：/reflect

当你准备好审核时，运行：

/reflect

Claude 会列出所有捕获的学习项，你逐条确认：
– 接受：写入 CLAUDE.md
– 拒绝：丢弃
– 修改：编辑后写入

其他命令

工作原理

架构概览

用户输入
    ↓
┌─────────────────────────────────────┐
│  Hook: UserPromptSubmit             │
│  ├─ 正则匹配（实时捕获）               │
│  └─ 放入 learnings-queue.json       │
└─────────────────────────────────────┘
    ↓
┌─────────────────────────────────────┐
│  /reflect 命令                       │
│  ├─ 语义分析（AI 验证）                │
│  ├─ 过滤误报                          │
│  └─ 人工审核确认                       │
└─────────────────────────────────────┘
    ↓
写入 CLAUDE.md / AGENTS.md

两阶段处理

第一阶段：实时捕获（Hooks）

插件注册了三个 Hooks：

{
  "hooks": [
    {
      "event": "UserPromptSubmit",
      "command": "capture_learning.py"
    },
    {
      "event": "PreCompact",
      "command": "check_learnings.py"
    },
    {
      "event": "PostToolUse",
      "pattern": "Bash",
      "command": "post_commit_reminder.py"
    }
  ]
}

• UserPromptSubmit：每次你发送消息时触发，检测纠正语句
• PreCompact：上下文压缩前提醒处理队列
• PostToolUse：Bash 命令后检查提交提醒

capture_learning.py 从标准输入读取 JSON 格式的 prompt，调用 detect_patterns() 进行正则匹配，匹配成功则写入队列。

第二阶段：语义验证（/reflect）

正则匹配快但粗糙，会产生误报。/reflect 触发 AI 语义分析：

def semantic_analyze(message):
    result = subprocess.run(
        ["claude", "-p", "--output-format", "json"],
        input=ANALYSIS_PROMPT + message,
        capture_output=True
    )
    return parse_response(result.stdout)

AI 会判断：
– is_learning: 这是否是一个可学习的偏好？
– confidence: 置信度分数
– type: correction / positive / explicit

置信度低或类型不匹配的会被过滤。

检测模式

插件识别以下类型的表达：

正则模式在 reflect_utils.py 的 CORRECTION_PATTERNS 中定义。

配置文件输出

学习项最终写入三个可能的位置：

目录结构

claude-reflect/
├── .claude-plugin/     # 插件清单，用于注册
├── hooks/
│   └── hooks.json      # Hook 事件定义
├── scripts/
│   ├── capture_learning.py      # 实时捕获脚本
│   ├── check_learnings.py       # 压缩前检查
│   ├── post_commit_reminder.py  # 提交后提醒
│   └── lib/
│       ├── semantic_detector.py # AI 语义分析
│       └── reflect_utils.py     # 队列管理、模式匹配
└── commands/
    └── reflect.md      # /reflect 命令定义

为什么需要这个工具

Claude Code 的 CLAUDE.md 是一个强大的个性化机制。问题是：手动维护太麻烦。

你每天和 Claude 对话几十次，每次纠正都是一次学习机会。但谁会记得把”不要用分号”这种小事写进配置文件？

Claude Reflect 自动化了这个过程：
1. 捕获发生在对话中的自然纠正
2. 过滤掉噪音（问题、临时指令）
3. 让你审核后一键写入

本质上，它把 Claude Code 从”每次对话重新开始”变成了”持续学习的助手”。

适用场景

• 团队项目：统一编码规范，新人加入直接继承团队偏好
• 个人开发：积累个人代码风格，减少重复沟通
• 跨项目：全局偏好 + 项目特定规则分离管理

局限性

1. 需要 Claude Code CLI：这是 Claude Code 的插件，不是 API 或 Web 版
2. Python 依赖：Hook 脚本用 Python 写，需要 Python 3.6+
3. 语义分析消耗 Token：每次 /reflect 会调用 Claude 进行语义验证

总结

Claude Reflect 解决了一个真实痛点：让 Claude 记住你的偏好。

技术实现不复杂：Hook 捕获 + 正则初筛 + AI 精筛 + 人工确认。但设计上很聪明——两阶段处理平衡了实时性和准确性，人工审核保证了可控性。

如果你是 Claude Code 的重度用户，值得试试。

项目地址：github.com/BayramAnnakov/claude-reflect