> 🇩🇪 Dies ist die deutsche Übersetzung. [Englische Version](../python-resolver.md).

# Python Build Resolver Agent

## Zweck
Diagnostiziert und behebt Python-Import-Fehler, Laufzeit-Ausnahmen, Type-Annotation-Konflikte (mypy) und Abhängigkeitskonflikte — und gibt korrigierten Code mit einer Erklärung zurück.

## Modellempfehlung
**Haiku 4.5** für Einzeldatei-Fehler (ImportError, AttributeError, NameError, einfache Type-Annotation-Probleme).

**Sonnet 4.6** für Fehler, die mehrere Module umspannen, zirkuläre Imports, mypy-Strict-Mode-Fehler oder Abhängigkeitsversions-Konflikte.

## Tools
- `Read` — die fehlerhaften Datei und verwandte Module lesen
- `Edit` — gezielte Korrekturen anwenden
- `Bash` — `python -m mypy file.py 2>&1`, `python -c "import module"`, `pip show package` zur Diagnose ausführen

## Wann hierher delegieren
- `ImportError` oder `ModuleNotFoundError` beim Start oder beim Test-Run
- `mypy`-Typprüfungsfehler in einer streng typisierten Codebase
- `AttributeError: module 'x' has no attribute 'y'` (API in Paket-Upgrade geändert)
- Zirkuläre Import-Fehler
- Abhängigkeitsversions-Konflikte (`pip install` schlägt fehl oder erzeugt inkompatible Versionen)

## Wann NICHT hierher delegieren
- Logikfehler, die keine Import-/Typfehler sind
- Performance-Probleme
- Laufzeitfehler, die durch falsche Geschäftslogik verursacht werden (keine strukturellen Python-Fehler)

## Prompt-Vorlage
```
You are a Python error resolver. Fix the error — minimal changes only. Do not refactor.

Error:
[paste full traceback or mypy output]

Relevant files:
[paste file contents where errors occur]

Python version: [e.g., 3.12]
Package versions: [paste pip freeze output if relevant]

For each error:
1. Explain why the error occurs in one sentence
2. Apply the minimal fix
3. If a dependency version conflict: specify the exact version constraint to add/change

Do not change logic. Do not refactor. Fix the error only.
```

## Beispiel-Anwendungsfall
**Fehler:**
```
ImportError: cannot import name 'AsyncClient' from 'httpx' (0.23.0)
```

**Was Resolver zurückgibt:**
- Ursache: `AsyncClient` wurde in `httpx 0.18.0` hinzugefügt, aber die Verwendung erfordert `httpx>=0.23.0` für die verwendete spezifische API
- Lösung: `requirements.txt` auf `httpx>=0.23.0,<1.0.0` aktualisieren und `pip install -r requirements.txt` ausführen
- Falls kein Upgrade möglich: äquivalenten Code für die installierte Version zeigen

---

> **Mit uns arbeiten:** Claudient wird von [Uitbreiden](https://uitbreiden.com/) unterstützt — wir bauen KI-Produkte und B2B-Lösungen mit Entwickler-Communities. [uitbreiden.com](https://uitbreiden.com/) · [Reddit](https://www.reddit.com/r/uitbreiden/) · [YouTube](https://www.youtube.com/@UITBREIDEN)
