mcpField
R
reflect

reflect

github.com/haddock-developmentAgent 工作流38482 次安装41 周前更新
代码仓库

关于 reflect

reflect 是面向 Claude Code 的 Skill，可从对话中的纠正和重复模式中提取信号，并提议更新相关 Skill。支持手动分析，也可在会话结束时自动运行并提供审核与安全保护。

主要功能

  1. 01检测对话中的反馈信号
  2. 02按指定或全部 Skill 分析
  3. 03会话结束时自动反思
  4. 04交互式审核更新提案
  5. 05备份与 YAML 校验

适用场景

  1. 01将纠正转化为可复用的 Skill 指引
  2. 02梳理 Claude Code 会话中的重复模式

安装

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

$npx skills add https://github.com/haddock-development/claude-reflect-system --skill reflect

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

包含的文件

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

README.md
USER_GUIDE.md
.state/
auto-reflection.json
last-reflection.timestamp
commands/
reflect-meta.md
reflect-promote.md
reflect-stats.md
references/
signal-patterns.md
scripts/
extract_signals.py
hook-stop.sh
learning_ledger.py
meta_learning.py
present_review.py
promote_learning.py
reflect.py
scope_analyzer.py
semantic_detector.py
toggle-off.sh
toggle-on.sh
toggle-status.sh
update_skill.py

详细介绍

Reflect - 自我改进技能

概述

此技能通过分析纠正、认可和模式，让 Claude Code 从对话中学习，然后建议更新相关技能。它实现了一套「纠正一次，永不再犯」的学习系统。

使用模式

1. 手动反思（/reflect）

触发对当前对话的分析：

/reflect [skill-name]
  • 不指定技能名称：分析对话中使用的所有技能
  • 指定技能名称：聚焦于特定技能
2. 自动反思

通过 /reflect-on 启用后，会在会话结束时通过 Stop hook 自动运行。

3. 切换命令
  • /reflect-on - 启用自动反思
  • /reflect-off - 禁用自动反思
  • /reflect-status - 显示当前配置

置信度级别

HIGH - 明确纠正：

  • 用户针对 Claude 的做法提出具体替代方案
  • 模式：「不要做 X，而要做 Y」
  • 操作：直接更新并附带弃用警告

MEDIUM - 认可和模式：

  • 用户认可特定做法
  • 某模式多次成功
  • 操作：添加到「最佳实践」部分

LOW - 观察：

  • 用户提出疑问或建议替代方案
  • 模式：「你考虑过……吗？」或「为什么不试试……？」
  • 操作：添加到「注意事项」部分

工作流

  1. 信号检测 - 扫描对话记录，查找纠正和模式
  2. 上下文分析 - 提取信号周围 5 条消息的上下文
  3. 技能映射 - 将信号匹配到相关技能
  4. 更改提议 - 生成拟议更新的差异
  5. 用户审核 - 通过自然语言编辑进行交互式审批
  6. 应用更改 - 安全更新 YAML/markdown 文件并创建备份
  7. Git 提交 - 自动提交并附上描述性消息

脚本

核心引擎
  • scripts/reflect.py - 主要编排逻辑
  • scripts/extract_signals.py - 模式检测引擎
  • scripts/update_skill.py - 安全更新技能文件
  • scripts/present_review.py - 交互式审核界面
自动化
  • scripts/hook-stop.sh - Stop hook 集成
  • scripts/toggle-on.sh - 启用自动反思
  • scripts/toggle-off.sh - 禁用自动反思
  • scripts/toggle-status.sh - 显示状态

安全功能

  • 所有编辑前创建带时间戳的备份
  • 写入前验证 YAML
  • 锁文件可防止并发运行
  • 出错时妥善处理并回滚
  • 提交前检查 Git 状态

参考资料

详细的模式库请参阅 references/signal-patterns.md。

评论

支持 Markdown