SkillMap

Oct 30, 2026

把你的纠正变成 Claude Code 的永久记忆

claude-reflect 盯住你做出的纠正、和你一起复核，再把持久规则写进 CLAUDE.md——还会从会话历史里挖出值得做成命令的内容。

#tutorial#claude-code#context-engineering#workflow

每个开发者每周都要纠正编码 agent 几十次——「不对，用 pnpm」「先跑测试」——而会话一结束，这些纠正大多就蒸发了。BayramAnnakov/claude-reflect，一个 2k star 的 MIT 插件（当前 v3.3.1），选择把它们接住：钩子把识别到的纠正排进队列，你逐条复核，教训就永久落进 CLAUDE.md。

为什么这个 Skill 重要

CLAUDE.md 记忆通常依赖你记得去手动编辑。claude-reflect 用两阶段流程补上这个缺口。第一阶段自动：一个捕获钩子在每条提示上运行，识别「不对，用 X」「别用 Y」这类纠正模式，也识别正面反馈，以及置信度最高的显式 remember: 标记。第二阶段手动：你运行 /reflect，AI 语义过滤器用任意语言校验队列，没有你的批准，任何内容都进不了配置。

同一套循环反过来还能发现你自己都没察觉的习惯。/reflect-skills 命令分析你的会话历史，找出重复出现的任务模式，从里面起草新的斜杠命令。

安装

# Add the marketplace
claude plugin marketplace add bayramannakov/claude-reflect

# Install the plugin
claude plugin install claude-reflect@claude-reflect-marketplace

# IMPORTANT: Restart Claude Code to activate the plugin

重启之后，钩子自动配置，命令即刻可用。前置条件很轻：Claude Code 加 Python 3.6 以上。macOS、Linux、Windows 全部支持——Windows 原生运行，无需 WSL。

还有第二条更新的安装路径：reflect-mod 变体（3.3 新增）在你输入时就用一次性模型检查每条短提示，把发现的规则显示在提示框上方的小条里供你立即保存。它需要 Claude Code 2.1.286 或更新版本并开启 mods。插件和 mod 只装其一，绝不要都装——都装的话，每条纠正会被捕获两次。

实战：别再重复纠正同一件事

  1. 安装插件并重启 Claude Code。

  2. 像平常一样干活。Claude 出错时，按你本能的方式纠正它：

记住：Python 项目一律使用 venv，不要用全局 pip

捕获钩子把它排进队列。此时什么都不会写入。

  1. 提交一次代码后（钩子会提醒你），复核队列：
/reflect

你会看到一张汇总表，每条学习记录都可以采纳、先编辑再采纳、或者跳过。获批准的学习记录会同步到全局的 ~/.claude/CLAUDE.md、项目的 CLAUDE.md，以及存在 AGENTS.md 时的 AGENTS.md——Codex、Cursor、Aider、Jules、Zed、Factory 就是这样共享同一批规则的——纠正如果与某个技能相关，还会写进 .claude/commands/*.md。

  1. 随时检查规则落在了哪里：
/reflect --targets

实战：发现你一直在手敲的那条命令

README 里的完整示例：68 个会话里，你用四种不同说法要过生产力复盘。/reflect-skills 按意图把它们归为一组，提议创建 /daily-review 并给出证据——15 次相似请求——外加过程中学到的纠正（「用本地时区」「聊天软件也算工作」）。批准后，它会把草稿技能文件写进 .claude/commands/，带上上下文、步骤和护栏。

先限定时间窗并做一次干跑：

/reflect-skills --days 30 --dry-run

默认分析当前项目最近 14 天；--all-projects 扫描全部项目，代价是更慢。

技巧

  • 不能丢的规则用显式标记：remember: always use venv for Python projects——README 给了它最高置信度。
  • 在新机器上首次使用？/reflect --scan-history --days 90 可以把安装之前的会话里的教训捞回来。
  • CLAUDE.md 会随时间堆积近似重复项；/reflect --dedupe 找出语义相似的条目并提议合并版本。
  • 模型名称和通用模式放全局记忆；项目专属约定留在项目 CLAUDE.md——/reflect-skills 会逐个问你应该把新技能放在哪里。
  • Claude Code 默认在 30 天后删除本地会话。scan-history 和技能发现都依赖这段历史，README 建议在 ~/.claude/settings.json 里调大 cleanupPeriodDays（示例设为 99999）。

何时不用这个 Skill

如果你用的是 reflect-mod 变体，每条被检查的提示都是一次计到自己 Claude 账户上的小型模型调用，而且它需要 Claude Code 2.1.286 或更新版本——Python 插件两者皆无。README 把它保留给 /reflect-skills、--scan-history、--dedupe、--organize，以及 Codex 和 Cursor 用户。另外，队列复核刻意设计成手动的：如果你想让纠正不经人工直接写进配置，这个工具的审批环节正是它的价值所在，而不是可以关掉的障碍。

查看 排行榜 了解更多 skill。