/ 目录 / 演练场 / claude-reflect
● 社区 BayramAnnakov ⚡ 即开即用

claude-reflect

作者 BayramAnnakov · BayramAnnakov/claude-reflect

Claude Code 悄悄学习你的纠正方式——捕获规则、偏好和认可,然后将其写入 CLAUDE.md / AGENTS.md。

claude-reflect 在 Claude Code 会话后台运行,监视你纠正、表扬或重述偏好的时机。它将这些提炼为持久规则,并更新 CLAUDE.md 和 AGENTS.md,让后续会话继承这些规则。这是手动维护指令文件的轻量替代方案。

为什么要用

核心特性

实时演示

实际使用效果

就绪

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-reflect-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-reflect-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/BayramAnnakov/claude-reflect",
          "~/.claude/skills/claude-reflect"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add claude-reflect-skill -- git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: claude-reflect

无需手动维护,让 CLAUDE.md 自动演进

👤 讨厌维护文档的独立开发者 ⏱ ~5 min beginner

何时使用: 你希望 CLAUDE.md 能跟上你的偏好,而不需要成为一项写作负担。

前置条件
  • Skill 已安装 — git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect
  • 已启用反射 — 在项目的 CLAUDE.md 前言中添加 use claude-reflect
步骤
  1. 正常工作
    Just code with Claude as usual. Correct it when wrong, praise it when right.✓ 已复制
    → Skill 在后台悄悄捕获——你感觉不到
  2. 每日结束时审查
    Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ 已复制
    → 5–10 条候选规则,附带来源(哪次会话、哪个 prompt)
  3. 提交差异
    Apply approved rules and commit CLAUDE.md.✓ 已复制
    → 整洁的 git diff;规则现在生效

结果: CLAUDE.md 随你成长,无需手动维护成本。

注意事项
  • Skill 将一次性的临时上下文捕获为持久规则 — 始终审查每日候选项;拒绝任何仅适用于特定情境的规则
搭配使用: filesystem

从集体纠正中建立团队 AI 规范

👤 正在统一 AI 工作流的技术负责人 ⏱ ~60 min intermediate

何时使用: 多名开发者都在对 Claude 的相同问题进行纠正;你想建立共享规则集。

步骤
  1. 收集每位开发者的草稿
    Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ 已复制
    → 分支中有 N 条待审规则
  2. 合并会话
    Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ 已复制
    → 共识规则集
  3. 推广
    Merge to main. New AGENTS.md applies to everyone.✓ 已复制
    → 团队使用相同基线;各自的本地规则保留

结果: 自下而上的规范统一,无需流程委员会。

注意事项
  • 话多的开发者主导;安静的人的规律被遗漏 — 确保每个人都运行 skill;按反射事件加权,而非按文件编辑次数
搭配使用: github

审计并清理 CLAUDE.md 中的过时规则

👤 长期使用 CLAUDE.md 的用户 ⏱ ~25 min intermediate

何时使用: 你的 CLAUDE.md 现在有 600 行,Claude 的上下文已经臃肿。

步骤
  1. 评分相关性
    Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ 已复制
    → 每条规则的得分
  2. 提出删除建议
    Suggest 30 rules to remove (stale or obsolete).✓ 已复制
    → 带理由的删除列表
  3. 差异对比并提交
    Apply approved removals; commit with message 'reflect: prune stale rules'.✓ 已复制
    → 更精简的 CLAUDE.md

结果: CLAUDE.md 变得真正有人读,而非随意扫一眼。

注意事项
  • 删除了一条「没被应用是因为 Claude 一直在遵守它」的规则 — 拿不准时保留——但标注「最后验证时间」,以便下个季度复查

组合

与其他 MCP 搭配,撬动十倍杠杆

claude-reflect-skill + pro-workflow-skill

pro-workflow 用于显式捕获,claude-reflect 用于被动捕获——双通道学习

Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ 已复制
claude-reflect-skill + github

通过 PR 审查规则变更

Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
watch_session 始终在线的后台进程 0
review_candidates since? 每日/每周审批循环 0
consolidate scope? 定期去重 / 矛盾解决 0
score_rules 清理前的审计 0
apply_to_files approved_ids[], files[] 将已审批的候选项写入 CLAUDE.md / AGENTS.md 0

成本与限制

运行它的成本

API 配额
无——本地
每次调用 Token 数
后台捕获免费;审查/整合在配置了本地 LLM 时使用
费用
免费
提示
保守地审批候选项——质量优于数量

安全

权限、密钥、影响范围

最小权限: filesystem-write
凭据存储: Skill 状态在 .claude/reflect/ 中;如需共享可提交到仓库
数据出站: 默认无

故障排查

常见错误与修复

没有候选项被捕获

确认 skill 在 CLAUDE.md 前言中被调用;检查 .claude/reflect/log 中是否有条目

候选项全是噪音

收紧触发灵敏度;只从明确的纠正中捕获,而非普通聊天

AGENTS.md 与 CLAUDE.md 产生漂移

定期运行整合;工具设计为保持同步,但手动编辑会导致分歧

审批 prompt 太多压力大

每天用 --limit 5 运行审查;养成习惯,而不是一次处理 50 条

替代方案

claude-reflect 对比其他方案

替代方案何时用它替代权衡
pro-workflow-skill你偏好显式捕获和 worktree 编排更手动;对并行工作更有力
Manual CLAUDE.md curation你足够自律,可以自己编写规则经常被忽略;依赖意志力

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills