From e3cf9a83f44e723be7bbd9f5b32c6e10bfc546e1 Mon Sep 17 00:00:00 2001 From: team3 Date: Fri, 12 Jun 2026 07:46:42 +0200 Subject: [PATCH] =?UTF-8?q?Prompts:=20Section-Spec=20und=20Guide-Pipeline?= =?UTF-8?q?=20dom=C3=A4nen-adaptiv=20(BEISPIELFORMAT)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 (1M context) --- templates/Format/Section.md | 24 +++++++++++++++++++++--- templates/Prompt/Guide-Auswahl.md | 2 +- templates/Prompt/Guide-Fakten-Thema.md | 2 +- templates/Prompt/Guide-Lese-Check.md | 2 +- templates/Prompt/Guide-Sections-Fix.md | 4 +--- templates/Prompt/Guide-Writer.md | 6 ++---- 6 files changed, 27 insertions(+), 13 deletions(-) diff --git a/templates/Format/Section.md b/templates/Format/Section.md index e998d49..55d6ffb 100644 --- a/templates/Format/Section.md +++ b/templates/Format/Section.md @@ -3,7 +3,15 @@ SECTION-AUFBAU Jeder Baustein wird GENAU eine Section mit: 1. Titel — der Baustein-Titel (kommt aus dem Marker, nicht in den Body schreiben) 2. Beschreibung — was es ist und wozu: MAXIMAL 1–2 Sätze -3. Beispiele — KURZ und SIMPEL: wenige Zeilen Code, das Minimalbeispiel, keine Realwelt-Komplexität. Höchstens 1 knapper Satz Einordnung dazu. Ein Beispiel pro relevanter Variante: simple Bausteine eines, variantenreiche mehrere. Geordnet vom Üblichen zum Speziellen. Weglassen, wenn ohne Mehrwert. +3. Beispiele — KURZ und SIMPEL: das Minimalbeispiel im themengerechten Format (siehe BEISPIELFORMAT), keine Realwelt-Komplexität. Höchstens 1 knapper Satz Einordnung dazu. Ein Beispiel pro relevanter Variante: simple Bausteine eines, variantenreiche mehrere. Geordnet vom Üblichen zum Speziellen. Weglassen, wenn ohne Mehrwert. + +BEISPIELFORMAT — am Thema ausrichten, nicht pauschal an Code: +- Code-/Tool-Thema (Sprache, Framework, CLI, Konfiguration): Codeblock mit Sprachangabe, wenige Zeilen, Minimalbeispiel. +- Sprach-Thema (Vokabeln, Grammatik, Formulierungen): 1–3 Beispielsätze oder ein Mini-Dialog, fremdsprachiger Teil *kursiv*, deutsche Übersetzung in Klammern wo nötig. +- Konzept-Thema (Psychologie, Kommunikation, Methoden, Theorie): ein Mini-Szenario in 2–4 Sätzen (Situation → Anwendung → Wirkung), ein Schema oder eine Formel. +Mischthemen: pro Beispiel das Format wählen, das den Punkt am direktesten zeigt. +Ein Beispiel ist immer KONKRET (echter Code, echte Sätze, echte Situation) — nie die Beschreibung, was ein Beispiel zeigen würde. +Jedes Beispiel benennt seine Variante: in Code als Kommentar in der Code-Syntax (z. B. ``, `// Mit Default-Wert`), in Prosa als vorangestelltes fettes Label (z. B. **Höfliche Bitte:**). Jede Section ist ATOMAR: allein verständlich, ohne dass der Leser eine andere Section gelesen hat. Test: Ergibt der Text Sinn, wenn man NUR diese Section liest? Verweise auf andere Bausteine sind erlaubt, ihr Inhalt darf aber nie vorausgesetzt werden — benutzte Begriffe in einem Halbsatz auflösen. @@ -11,9 +19,9 @@ Umfang: kurz. Die Länge einer Section kommt aus der ZAHL der Beispiele (Variant Tonalität: klares Deutsch, direkt, praxisorientiert. Fachbegriffe beim ersten Auftreten kurz erklären. Keine Füllsätze, keine Einleitungsfloskeln. -Markdown im Section-Body: normale Absätze, `inline-code` für Bezeichner, Codeblöcke mit Sprachangabe, **fett** sparsam für Kernaussagen. Keine eigenen Überschriften außer `### Beispiel` bzw. `### Beispiele` vor den Beispielen. +Markdown im Section-Body: normale Absätze, `inline-code` für Bezeichner, Codeblöcke mit Sprachangabe NUR für Code-Beispiele — Beispielsätze, Dialoge und Szenarien als normaler Text, NIE in einen Codeblock zwingen. **fett** sparsam für Kernaussagen. Keine eigenen Überschriften außer `### Beispiel` bzw. `### Beispiele` vor den Beispielen. -Beispiel einer fertigen Section (nur der Body): +Beispiel einer fertigen Section (Code-Thema, nur der Body): Arrays speichern mehrere Werte unter einem Namen. PHP unterscheidet indizierte Arrays (`[0 => 'a']`) und assoziative Arrays (`['key' => 'wert']`) — intern sind beide geordnete Hashmaps. @@ -24,3 +32,13 @@ $preise['kirsche'] = 3.90; // ergänzen echo $preise['apfel']; // 1.2 ``` Assoziative Arrays sind der Arbeitsalltag: Datenbankzeilen, Konfiguration, JSON. + +Beispiel einer fertigen Section (Konzept-Thema, nur der Body): + +Paraphrasieren wiederholt die Aussage des Gegenübers in eigenen Worten, um Verständnis zu prüfen und Eskalation zu bremsen. + +### Beispiel +**Vorwurf abfedern:** +A: „Nie hältst du dich an Absprachen!" +B: „Du bist sauer, weil ich den Termin gestern verschoben habe — richtig?" +Die Paraphrase bestätigt nicht den Vorwurf, sondern prüft die Botschaft dahinter. diff --git a/templates/Prompt/Guide-Auswahl.md b/templates/Prompt/Guide-Auswahl.md index d8bb448..be73ae1 100644 --- a/templates/Prompt/Guide-Auswahl.md +++ b/templates/Prompt/Guide-Auswahl.md @@ -7,7 +7,7 @@ BAUSTEINE (unsortiertes Inventar): Denke vom Ziel her: Was soll der Leser am Ende KÖNNEN? - Wähle, was der Leser dafür praktisch braucht und wirklich benutzt. -- Lass weg: Interna (was das Werkzeug intern tut, ohne dass man es anfasst), Spezialfälle und Alternativen zum selben Problem — ein Weg reicht. +- Lass weg: Interna (was das Werkzeug oder die Theorie intern tut, ohne dass man es selbst anfasst), Spezialfälle und Alternativen zum selben Problem — ein Weg reicht. - "Klingt fundamental" ist kein Kriterium. Frage stattdessen: Fasst der Leser das selbst an? - Verwende die Titel EXAKT so, wie sie in der Liste stehen. Keine neuen erfinden. diff --git a/templates/Prompt/Guide-Fakten-Thema.md b/templates/Prompt/Guide-Fakten-Thema.md index 79a7925..a70e9f7 100644 --- a/templates/Prompt/Guide-Fakten-Thema.md +++ b/templates/Prompt/Guide-Fakten-Thema.md @@ -1 +1 @@ -Prüfe unsichere oder veraltbare Fakten (z. B. Versionsnummern) per Websuche. \ No newline at end of file +Prüfe unsichere oder veraltbare Fakten (Versionsnummern, aktuelle Empfehlungen, Forschungsstand) per Websuche, BEVOR du sie in eine Section schreibst. Nichts Unbelegtes behaupten. \ No newline at end of file diff --git a/templates/Prompt/Guide-Lese-Check.md b/templates/Prompt/Guide-Lese-Check.md index 065c298..cb9d457 100644 --- a/templates/Prompt/Guide-Lese-Check.md +++ b/templates/Prompt/Guide-Lese-Check.md @@ -9,7 +9,7 @@ SECTIONS: Prüfe jede Section: 1. Ist die Beschreibung für Anfänger verständlich und maximal 1–2 Sätze? -2. Sind die Beispiele kurz, simpel und plausibel korrekt? +2. Sind die Beispiele kurz, simpel, plausibel korrekt — und im themengerechten Format laut Spezifikation (kein Codeblock um Prosa-Beispiele, kein Prosa-Pseudo-Beispiel, wo Code gefragt ist)? 3. Ist das Markdown sauber (keine abgebrochenen Code-Blöcke, keine Platzhalter, kein Fremdtext)? Du PRÜFST nur und notierst Probleme — du änderst nichts. Nur echte Mängel notieren, keine Geschmacksfragen. diff --git a/templates/Prompt/Guide-Sections-Fix.md b/templates/Prompt/Guide-Sections-Fix.md index 31472e2..8058746 100644 --- a/templates/Prompt/Guide-Sections-Fix.md +++ b/templates/Prompt/Guide-Sections-Fix.md @@ -16,9 +16,7 @@ Schreibe NUR die Datei {out_path} in GENAU diesem Format — für JEDE beanstand Beschreibung… ### Beispiel -```sprache -… -``` +(Beispiel im themengerechten Format laut SECTION-SPEZIFIKATION: Codeblock NUR bei Code-Themen, sonst Beispielsätze oder Mini-Szenario) Die Marker-Zeilen exakt so schreiben. Kein Text außerhalb der Sections. {extra} diff --git a/templates/Prompt/Guide-Writer.md b/templates/Prompt/Guide-Writer.md index 00a1d47..4077bb9 100644 --- a/templates/Prompt/Guide-Writer.md +++ b/templates/Prompt/Guide-Writer.md @@ -5,7 +5,7 @@ Dir zugeteilt sind folgende Kapitel und Bausteine — verbindlich: jede zugeteil {facts} -Beispiel-Tiefe für dieses Format ({format_name}): MiniGuide = nur die üblichen Varianten eines Bausteins, Guide = die gängigen Varianten, FullGuide = alle relevanten Varianten inkl. Nischenfällen. +Beispiel-Tiefe für dieses Format ({format_name}): MiniGuide = nur die üblichen Varianten eines Bausteins, Guide = die gängigen Varianten, FullGuide = alle relevanten Varianten inkl. Nischenfällen. Eine Variante ist eine eigenständige Verwendungsform des Bausteins — Code-Variante, Satzmuster oder Anwendungsfall. SECTION-SPEZIFIKATION: {spec} @@ -17,9 +17,7 @@ Schreibe NUR die Datei {out_path} in GENAU diesem Format — pro Kapitel ein kap Beschreibung… ### Beispiel -```sprache -… -``` +(Beispiel im themengerechten Format laut SECTION-SPEZIFIKATION: Codeblock NUR bei Code-Themen, sonst Beispielsätze oder Mini-Szenario) Die Marker-Zeilen exakt so schreiben. Kein Text außerhalb der Sections, kein Dokument-Titel, kein Inhaltsverzeichnis. {extra} \ No newline at end of file