通过对话分析实现自我改进，从用户纠正中提取学习点，将经验编码为持久规则，支持自动反射与技能创建，实现”纠正一次，永不再犯”。
说明：
## 核心用法
`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策略
