用途:Reflect 用于让 Claude Code 从对话中学习。它扫描对话记录,识别用户的纠正、认可和重复出现的模式,然后把信号映射到相关技能,生成技能更新建议,由用户审核后应用。
主要能力:支持三种使用模式。手动反思使用 /reflect [skill-name] 分析当前对话,不带技能名时分析对话中用到的所有技能,带技能名时只聚焦该技能。自动反思通过 /reflect-on 启用后,在会话结束经由 Stop hook 自动运行。开关命令为 /reflect-on、/reflect-off、/reflect-status,分别用于启用、禁用和查看配置。
置信分级:HIGH 对应显式纠正,例如用户以具体替代方案否定 Claude 的做法,模式为“不要做 X,改做 Y”,动作是直接更新并附加弃用警告;MEDIUM 对应用户认可或模式多次成功,动作是加入“Best Practices”章节;LOW 对应用户提问或提出替代方案,如“有没有考虑过……”或“为什么不试试……”,动作是加入“Considerations”章节。
工作流程:检测信号,提取信号前后约 5 条消息的上下文,将信号映射到相关技能,生成变更差异,进入交互式审核并支持自然语言编辑,随后以安全的 YAML/markdown 方式更新并备份,最后自动提交 Git 并附描述性信息。
脚本:核心引擎包括 scripts/reflect.py 主编排逻辑、scripts/extract_signals.py 模式检测、scripts/update_skill.py 安全更新技能文件、scripts/present_review.py 交互审核界面;自动化包括 scripts/hook-stop.sh、scripts/toggle-on.sh、scripts/toggle-off.sh、scripts/toggle-status.sh。
安全特性:所有编辑前生成带时间戳的备份,写入前校验 YAML,使用锁文件防止并发运行,错误处理支持回滚,提交前检查 Git 状态。详细模式库见 references/signal-patterns.md。
限制:资料未提供具体安装命令、支持平台范围、收费方式和运行环境要求,暂未提供。