核心用法
reflect 是一个自改进工作流技能，用于从用户反馈中提取学习点并将其永久化。核心命令包括 /reflect（手动分析会话）、/reflect on/off（开关自动反射）、/reflect status（查看状态）、/reflect review（审核待验证学习）。使用时，技能会扫描对话中的信号（如"never"、"always"、"wrong"等显式纠正），按高/中/低置信度分类，映射到对应的代理文件或MEMORY.md，并生成包含diff的更新提案供用户审批。
显著优点
1. 经验沉淀机制：将一次性纠正转化为跨会话的持久规则，避免重复错误
2. 智能信号检测：三层置信度体系（HIGH/MEDIUM/LOW）区分显式纠正、认可模式和观察模式
3. 灵活目标映射：自动将学习归类到代码风格、架构、流程、领域、工具等类别，匹配正确的代理文件
4. 技能创建能力：符合标准（可复用、非平凡、具体、已验证、无重复）的学习可自动升格为独立SKILL.md
5. 人机协同设计：所有变更需显式用户批准，支持选择性应用和修改后再提交
6. 完善的钩子和集成：支持PreCompact自动触发、与/handover集成、Session Health提醒
潜在缺点与局限性
1. 依赖信号明确性：对用户含蓄反馈或语境依赖的纠正识别能力有限
2. 质量门主观性："非平凡"、"可复用"等判断依赖LLM评估，可能误判
3. 代理文件膨胀风险：持续累积规则可能导致代理文件过长，影响上下文效率
4. 冲突检测不完善：只能检测表面矛盾，深层语义冲突可能遗漏
5. 跨项目迁移复杂：项目特定学习需手动判断何时应全局化
6. 初期配置成本：状态目录、钩子配置、环境变量设置需要一定上手时间
适合人群
- 高频使用Claude Code进行复杂项目开发的工程师
- 需要维护多个项目、希望经验跨项目迁移的团队
- 对代理行为有明确偏好、追求一致性输出的用户
- 愿意投入时间建立个人/团队编码规范体系的开发者
常规风险
1. 过度拟合风险：将特定项目的临时workaround错误编码为通用规则
2. 规则冲突：新旧规则矛盾导致代理行为混乱，需定期审查
3. 自动提交误操作：若用户习惯性按Y，可能接受未仔细审查的变更
4. 隐私泄露：反思日志可能包含敏感代码片段，需注意存储位置权限
5. 版本控制污染：频繁的小幅agent文件更新可能污染git历史，建议配合squash策略