54 lines
2.2 KiB
Markdown
54 lines
2.2 KiB
Markdown
# Auftrag: Code-Ausschnitt in Einheiten zerlegen
|
||
|
||
Du bekommst unten einen Ausschnitt der Datei `<DATEI>` aus einem Software-Projekt.
|
||
Zerlege ihn in **Einheiten** und gib NUR die Einheiten-Abschnitte im unten definierten
|
||
Format zurück — nichts davor, nichts danach, keine Code-Fences um das Gesamtergebnis.
|
||
|
||
Diese Top-Level-Symbole des Ausschnitts MÜSSEN alle abgedeckt sein:
|
||
<SYMBOLE>
|
||
|
||
## Was ist eine Einheit
|
||
|
||
Das Kleinste mit **eigener Verantwortung**, das sich in einem Satz beschreiben lässt —
|
||
meist eine Funktion oder Klasse; mehrere kleine, zusammengehörige Symbole dürfen eine
|
||
Einheit bilden (Hauptsymbol als ID, weitere je als `anker:`-Zeile). Jedes gelistete
|
||
Symbol gehört zu genau einer Einheit (MECE).
|
||
|
||
Hat der Ausschnitt KEINE def/class-Symbole (reines Skript, Konfiguration), erzeuge
|
||
GENAU EINE Datei-Einheit mit der ID `<DATEI>` (ohne `::`) — erfinde NIE Pseudo-Symbole.
|
||
|
||
## Ausgabeformat (exakt einhalten)
|
||
|
||
```
|
||
## <DATEI>::<hauptsymbol>
|
||
beschreibung: <genau ein Satz: die Verantwortung — EINE Aufgabe, kein „und"-Katalog>
|
||
input: <was die Einheit entgegennimmt — eine knappe Zeile>
|
||
output: <was sie liefert bzw. bewirkt — eine knappe Zeile>
|
||
entscheidungen:
|
||
- <kurzer Satz: eine im Code getroffene Design-Entscheidung oder Garantie>
|
||
beleg: "<kurzes WÖRTLICHES Zitat aus dem Ausschnitt, das sie stützt>"
|
||
kanten:
|
||
- ruft-auf: <einheiten-id>
|
||
- nutzt: <einheiten-id>
|
||
- wird-genutzt-von: <einheiten-id>
|
||
```
|
||
|
||
Regeln:
|
||
- `beschreibung:` genau EIN Satz, EINE Aufgabe. `input:`/`output:` sind Pflicht.
|
||
- 2–5 Entscheidungen je Einheit: Design-Entscheidungen und Garantien, KEIN
|
||
Implementierungs-Nacherzählen. Jede hat GENAU EINE `beleg:`-Zeile auf eigener Zeile.
|
||
- Der Beleg muss WÖRTLICH (Zeichen für Zeichen) im Ausschnitt vorkommen und ein
|
||
zusammenhängender Ausschnitt aus GENAU EINER Quellzeile sein — NIEMALS mehrere
|
||
Zeilen zu einer zusammenziehen. Max. ~60 Zeichen.
|
||
- Kanten-Typen nur: `ruft-auf`, `nutzt`, `wird-genutzt-von`, `löst-aus`,
|
||
`wird-ausgelöst-von`. Hinter dem Ziel steht NICHTS mehr. Ziele in anderen Modulen
|
||
(aus Imports ableitbar) als `pfad/zur/datei.py::symbol`. Keine Kante erfinden —
|
||
lieber weniger als falsche.
|
||
- Schreibe auf Deutsch.
|
||
|
||
## Ausschnitt aus `<DATEI>`
|
||
|
||
```python
|
||
<QUELLE>
|
||
```
|