Claude Reflect System 安装与使用指南：让 AI 从纠正中永久学习 | 极客的赛博空间

Reflect System 是一个用于 Claude Code 的自我学习系统，它能让 AI 助理从您的纠正中永久学习，不再重复相同的错误。通过模式识别，它会将您的反馈（纠正、赞同、建议）自动转化为可复用的技能知识，并支持版本控制和安全回滚。

1. 系统要求

在安装前，请确保您的环境满足以下条件：

首先，将仓库克隆到您的本地机器：

1 2	git clone https://github.com/haddock-development/claude-reflect-system.git cd claude-reflect-system

将核心的 reflect 技能和示例技能 python-project-creator 复制到 Claude Code 的技能目录中：

# 创建技能目录（如果不存在）
mkdir -p ~/.claude/skills

# 复制技能
cp -r reflect ~/.claude/skills/
cp -r python-project-creator ~/.claude/skills/

Reflect 系统需要 pyyaml 库来处理技能文件：

1	pip install pyyaml

或者，如果您使用 uv 或 pip3：

1
2
3

uv pip install pyyaml
# 或
pip3 install pyyaml

在 Claude Code 中，输入以下命令检查系统状态：

1	/reflect-status

如果看到配置信息，则说明安装成功。

系统会根据您的反馈类型，将其归类为不同的置信度等级，并更新到技能文件的相应部分：

信号类型	置信度	触发模式示例	技能文件更新位置
纠正 (Correction)	HIGH (高)	“不要用 X，用 Y”、”永远不要做 X”、”总是检查 Y”	`## Critical Corrections` (关键纠正)
赞同 (Approval)	MEDIUM (中)	“是的，完美！”、”这样很好”、”完全正确”	`## Best Practices` (最佳实践)
观察/建议 (Observation)	LOW (低)	“你考虑过…吗？”、”关于…”	`## Considerations` (考量事项)

命令	功能	说明
`/reflect`	手动触发学习	分析当前会话中的交互，检测学习信号，并提示您应用更改。
`/reflect-on`	开启自动学习	启用会话结束时的自动反射。Claude 会在会话结束时自动运行学习流程。
`/reflect-off`	关闭自动学习	禁用自动反射，恢复手动模式。
`/reflect-status`	查看当前状态	显示反射系统的配置，包括当前模式（手动/自动）、技能列表等。

Reflect System 设计了多重安全机制，确保学习过程可控、可逆：

仓库中包含了 python-project-creator 作为示例技能，展示了学习过程：

问题	可能原因	解决方案
`/reflect` 命令未找到	技能未正确复制到 `~/.claude/skills/` 目录	确认路径是否正确，并检查 Claude Code 是否重新加载了技能。
`pyyaml` 导入错误	Python 环境中未安装 `pyyaml`	执行 `pip install pyyaml` 或 `uv pip install pyyaml`。
`/reflect` 无法检测到纠正	反馈信息不够明确，或模式未匹配	使用更明确的纠正句式，如 “不要用 X，请用 Y”。也可在 `extract_signals.py` 中自定义模式。
学习后技能未生效	技能文件更新但 Claude Code 未重新加载	尝试重启 Claude Code 会话，或检查技能文件是否已正确修改。
Git 提交失败	技能目录不是 Git 仓库或 Git 未安装	确保 `~/.claude/skills/` 是一个 Git 仓库（或执行 `git init`），并确保 Git 已安装。