Analyzes conversation transcripts to extract user corrections, patterns, and preferences, then proposes skill improvements. Use this skill when users provide corrections, express preferences about code style, or when patterns emerge from successful approaches. Can be triggered manually with /reflect or automatically at session end when enabled.
"Correct once, never again"
Ein intelligentes Lernsystem für Claude Code, das aus Ihren Korrekturen lernt und Skills automatisch verbessert.
# Status prüfen
/reflect-status
# Manuelle Analyse nach einer Session mit Korrekturen
/reflect
# Mit AI-powered Semantic Detection (Multi-Language!)
/reflect --semantic
# Cross-Skill Learnings anzeigen
/reflect-stats
# Learnings zu global promoten
/reflect-promote
# Auto-Reflection aktivieren (optional)
/reflect-on
Semantic Detection nutzt Claude selbst als ML-Engine für intelligentere Pattern-Erkennung:
| Feature | Regex (Standard) | Semantic (--semantic) | |---------|------------------|----------------------| | Sprachen | Englisch + Deutsch | Alle Sprachen | | Genauigkeit | Gut | Exzellent | | Geschwindigkeit | Sofort | ~2-3s pro Message | | False Positives | Möglich | Sehr selten |
🇬🇧 "No, use uv instead of pip" → ✓ Detected
🇩🇪 "Nein, benutze pytest statt unittest" → ✓ Detected
🇪🇸 "No, usa Python en vez de JavaScript" → ✓ Detected
🇫🇷 "Non, utilise toujours ruff" → ✓ Detected
Learnings werden über Skills und Repositories hinweg getrackt. Wenn ein Learning in 2+ Repos auftaucht, kann es zu deiner globalen ~/.claude/CLAUDE.md promoted werden.
Repo A: "Verwende uv statt pip" → Learning gespeichert
Repo B: "Verwende uv statt pip" → Gleiche Learning erkannt!
↓
Threshold erreicht (2 Repos)
↓
/reflect-promote → Global CLAUDE.md
↓
Claude weiß es ÜBERALL ✨
# Statistiken anzeigen
/reflect-stats
# Promotion-Kandidaten anzeigen
python3 ~/.claude/skills/reflect/scripts/promote_learning.py list
# Preview einer Promotion
python3 ~/.claude/skills/reflect/scripts/promote_learning.py preview <fingerprint>
# Learning promoten
python3 ~/.claude/skills/reflect/scripts/promote_learning.py promote <fingerprint>
# Alle eligible Learnings promoten
python3 ~/.claude/skills/reflect/scripts/promote_learning.py all --dry-run
$ python3 promote_learning.py list
2 learnings ready for promotion:
[a1b2c3d4] (3 repos)
Use uv instead of pip for Python projects
From: python-project-creator
[e5f6g7h8] (2 repos)
Always run tests before committing
From: general
| Datei | Beschreibung |
|-------|--------------|
| ~/.claude/reflect/learnings.db | SQLite Ledger |
| ~/.claude/CLAUDE.md | Globale Regeln |
| ~/.claude/backups/ | Automatische Backups |
Reflect analysiert Ihre Konversationen mit Claude und:
Session 1: "Verwende uv statt pip"
Session 2: Claude verwendet wieder pip 😞
Session 3: "Ich hab's dir doch gesagt!" 😤
Session 1: "Verwende uv statt pip" → /reflect → Skill aktualisiert
Session 2: Claude verwendet uv ✅
Session 3: Claude verwendet uv ✅
Session N: Claude verwendet uv ✅
--semantic) - AI-powered, Multi-Language/reflect nach Bedarf/reflect-on und /reflect-offreflect/
├── README.md # Diese Datei
├── USER_GUIDE.md # Ausführlicher Guide
├── SKILL.md # Skill-Definition
├── commands/ # Slash Commands
│ ├── reflect-promote.md # /reflect-promote
│ └── reflect-stats.md # /reflect-stats
├── scripts/
│ ├── reflect.py # Haupt-Engine
│ ├── extract_signals.py # Pattern-Detection (Regex + Semantic)
│ ├── semantic_detector.py # AI-powered Detection
│ ├── learning_ledger.py # SQLite Cross-Skill Tracking (NEU!)
│ ├── scope_analyzer.py # Project vs Global (NEU!)
│ ├── promote_learning.py # Promotion zu Global (NEU!)
│ ├── update_skill.py # Safe Skill-Updates
│ ├── present_review.py # Interactive Review
│ └── ...
├── .state/
│ └── auto-reflection.json # Toggle-Status
└── references/
└── signal-patterns.md # Pattern-Library
| Command | Beschreibung |
|---------|--------------|
| /reflect | Manuelle Analyse (Regex) |
| /reflect --semantic | Manuelle Analyse (AI-powered) |
| /reflect <skill> | Analysiere nur einen Skill |
| /reflect-on | Auto-Reflection aktivieren |
| /reflect-off | Auto-Reflection deaktivieren |
| /reflect-status | Status anzeigen |
| /reflect-stats | Cross-Skill Statistiken (NEU!) |
| /reflect-promote | Learnings zu Global promoten (NEU!) |
| Option | Beschreibung |
|--------|--------------|
| --semantic | AI-powered Detection (Multi-Language) |
| --model <name> | Modell für Semantic (default: haiku) |
| Taste | Aktion |
|-------|--------|
| A | Approve - Alle Änderungen übernehmen |
| M | Modify - Mit Natural Language modifizieren |
| S | Skip - Diesen Skill überspringen |
| Q | Quit - Review abbrechen |
/reflect --semantic nach Sessions mit Korrekturen/reflect-stats regelmäßig prüfen/reflect-promote für reife Learnings| Problem | Lösung |
|---------|--------|
| Keine Signale erkannt | --semantic nutzen |
| Ledger leer | Mehr /reflect Sessions durchführen |
| Promotion schlägt fehl | Threshold noch nicht erreicht (2 repos) |
| Backup nötig | ~/.claude/backups/ prüfen |
MIT License
Inspiriert von:
Entwickelt für Claude Code mit ❤️
Happy Learning! 🚀
Version: 1.2.0 | Semantic Detection: v1.1 | Cross-Skill Learning: v1.2
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer