mcpField
C
claude-reflect

claude-reflect

github.com/bayramannakovAgent 工作流1.9k423 次安装4 周前更新
代码仓库

关于 claude-reflect

claude-reflect 是面向 Claude Code 的技能，可捕捉用户纠正，并在写入指令文件前供用户审核。

主要功能

  1. 01自动捕捉纠正内容
  2. 02人工审核学习队列
  3. 03扫描过往会话
  4. 04试运行预览变更
  5. 05从重复模式发现技能

适用场景

  1. 01保留纠正内容供后续会话参考
  2. 02区分全局与项目指导
  3. 03从会话历史中查找遗漏的经验

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bayramannakov/claude-reflect --skill claude-reflect

安装后在 Claude Code 中输入/claude-reflect确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
BACKLOG.md
LICENSE
CHANGELOG.md
RELEASING.md
CLAUDE.md
DISTRIBUTION.md
README.md
.claude-plugin/
marketplace.json
plugin.json
.github/
FUNDING.yml
.github/workflows/
test.yml
commands/
skip-reflect.md
view-queue.md
reflect-skills.md
reflect.md
hooks/
hooks.json
mod/
README.md
mod/.claude-plugin/
plugin.json
mod/hooks/
hooks.json
reflect.test.tsx
register.tsx
mod/types/
index.d.ts
scripts/
check_learnings.py
clear_queue.py
compare_detection.py
capture_learning.py
extract_session_learnings.py
extract_tool_errors.py
scripts/legacy/
capture-learning.sh

详细介绍

Claude Reflect - 自我学习系统

一个两阶段系统，帮助 Claude Code 从用户纠正中学习。

工作原理

阶段 1：捕获（自动） 钩子会检测纠正模式（“不，用 X”“实际上……”“用 X 而不是 Y”），并将其加入队列 ~/.claude/learnings-queue.json。

阶段 2：处理（手动） 用户运行 /reflect，以审核并将排队的学习内容应用到 CLAUDE.md 文件中。

可用命令

命令用途
/reflect在人工审核下处理排队的学习内容
/reflect --scan-history扫描以往会话，查找遗漏的学习内容
/reflect --dry-run预览更改，但不应用
/reflect-skills从重复模式中发现候选技能
/skip-reflect丢弃所有排队的学习内容
/view-queue查看待处理的学习内容，但不进行处理

何时提醒用户

在以下情况下提醒用户使用 /reflect：

  • 完成一项功能或有意义的工作单元
  • 用户做出你应在未来会话中记住的纠正
  • 用户明确说“记住这个”或类似的话
  • 上下文即将压缩，且队列中有内容

纠正检测模式

高置信度纠正：

  • 工具拒绝操作（用户提供指导并停止某项操作）
  • “不，用 X”／“不要用 Y”
  • “实际上……”／“我的意思是……”
  • “用 X 而不是 Y”／“用 X 代替 Y”
  • “记住：”（明确标记）

学习内容的存放位置

  • ~/.claude/CLAUDE.md - 全局学习内容（模型名称、通用模式）
  • ./CLAUDE.md - 项目专属学习内容（约定、工具、结构）
  • ./CLAUDE.local.md - 个人学习内容（特定于机器，会被 gitignore 忽略）
  • ./.claude/rules/*.md - 模块化规则，可按路径限定范围
  • ~/.claude/rules/*.md - 全局模块化规则
  • ~/.claude/projects/<project>/memory/*.md - 自动记忆（低置信度、探索性）
  • commands/*.md - 技能改进（技能执行期间的纠正）

交互示例

User: no, use gpt-5.1 not gpt-5 for reasoning tasks
Claude: Got it, I'll use gpt-5.1 for reasoning tasks.

[Hook captures this correction to queue]

User: /reflect
Claude: Found 1 learning queued. "Use gpt-5.1 for reasoning tasks"
        Scope: global
        Apply to ~/.claude/CLAUDE.md? [y/n]

评论

支持 Markdown