====== Commands im Seolizer Framework ======
**Steuerlogik für präzises, reproduzierbares Prompting**

===== Was sind Commands? =====
Commands sind kurze Steueranweisungen wie ''summarize.article'' oder ''rewrite.humanize'', die im Prompt-Framework von Seolizer das Verhalten des Sprachmodells definieren.  
Sie sind modular, kombinierbar und dienen als Schnittstelle zwischen menschlicher Absicht und maschinenlesbarer Struktur.

Jeder Command ist in der Datei ''commands.schema.json'' registriert und besitzt einen eindeutigen ''code'' nach dem Muster:

  * ''[Gruppe].[Aktion]''  
    Beispiele:
      - ''rewrite.humanize'' → formuliert Text natürlicher
      - ''explain.stepbystep'' → erklärt komplexe Inhalte schrittweise
      - ''summarize.article'' → erstellt eine strukturierte Einleitung
      - ''format.jsonify'' → erzwingt strukturierte JSON-Ausgabe
      - ''role.actas'' → Modell übernimmt eine definierte Persona

Commands sind **frameworkweit gültig** – sie werden auch in anderen Schemas wie ''qa.json'', ''summarize.json'' oder ''review.json'' verwendet.

===== Aufbau und Ort der Verwendung =====

In der ''article.json'' können Commands an mehreren Stellen vorkommen:

^ Bereich ^ Feld ^ Zweck ^
| Global | ''global_style.style_commands'' | Steuert den Stil und die Ausdrucksweise des gesamten Artikels |
| Global | ''global_style.format_commands'' | Legt globale Formatregeln fest (z. B. Ausgabeformat) |
| Abschnittsweise | ''introduction.command'' / ''summary.command'' | Lokale Commands für spezielle Abschnitte |
| Steuerung | ''command_execution.mode'' | Legt fest, ob Commands nur deklariert oder automatisch ausgeführt werden |
| Konfliktregelung | ''output.render_conflict_policy'' | Bestimmt, ob globale oder lokale Commands Priorität haben |

===== Beispiel: Einleitung automatisch generieren =====

<code json>
"introduction": {
  "present": true,
  "instructions": "Führe in das Thema strukturierter JSON-Prompts ein.",
  "length": { "unit": "words", "max": 140 },
  "command": "summarize.article",
  "exec": { "mode": "execute", "hide_command_fields_in_output": true }
}
</code>

In diesem Beispiel übernimmt der Command ''summarize.article'' automatisch die Erstellung der Einleitung.  
Über ''exec.mode'' wird festgelegt, dass der Befehl ausgeführt und die Steuerfelder nicht im fertigen Text angezeigt werden.

===== Globale Commands für Stil und Format =====
<code json>
"global_style": {
  "tone": "didactic",
  "style_commands": ["rewrite.humanize", "explain.stepbystep"],
  "format_commands": ["format.includeexclude"]
}
</code>

Diese Commands wirken auf den gesamten Artikel und geben ihm einen gleichbleibenden didaktischen Stil.  
Sie können in Einzelfällen durch lokale Abschnitts-Commands überschrieben werden.

===== Kategorien der Commands =====

^ Kategorie ^ Beispiel ^ Funktion ^
| **rewrite** | ''rewrite.humanize'' | Formuliert Text natürlicher |
| **explain** | ''explain.stepbystep'' | Erklärt Inhalte schrittweise |
| **summarize** | ''summarize.tldr'' | Erzeugt eine Kurzfassung |
| **format** | ''format.jsonify'' | Formatiert die Ausgabe strukturiert |
| **extract** | ''extract.facts'' | Extrahiert Fakten aus Fließtexten |
| **qa** | ''qa.answer'' | Beantwortet Fragen anhand von Kontext |
| **role** | ''role.actas'' | Definiert eine Persona oder Rolle |
| **review** | ''review.style'' | Bewertet Textqualität oder Ton |
| **toolcall** | ''tool.execute'' | Startet einen Tool- oder API-Aufruf |

===== Erweiterung der Command-Registry =====
Die ''commands.schema.json'' ist bewusst offen gestaltet.  
Neue Commands können über einheitliche Codes ergänzt werden, solange sie dem gültigen Enum-Schema folgen:

<code json>
{
  "code": "rewrite.formal",
  "label": "Schreibt den Text in formeller Sprache",
  "category": "rewrite"
}
</code>

So lässt sich das Framework dynamisch erweitern – etwa um projektspezifische Commands wie ''qa.medical'' oder ''extract.references''.

===== Alle verfügbaren Commands im Seolizer Framework =====
Das Seolizer Framework stellt eine zentrale Command-Registry bereit, in der alle Befehle nach Themenbereichen gruppiert sind.  
Commands sind kurze Steueranweisungen, die das Verhalten eines LLM festlegen – ähnlich wie Funktionsaufrufe in einer Programmiersprache.  
Jeder Command folgt der Syntax ''[gruppe].[aktion]''.

==== ✏️ Rewrite-Commands (Umformulierung & Stil) ====
  * ''rewrite.humanize'' – formuliert Texte natürlicher, menschlicher und flüssiger
  * ''rewrite.academic'' – schreibt im wissenschaftlichen, formalen Stil
  * ''rewrite.formal'' – hebt den Ton auf geschäftlich-offizielle Sprache
  * ''rewrite.casual'' – macht Texte informell und alltagstauglich
  * ''rewrite.toneto'' – ändert gezielt die Tonalität, z. B. zu "freundlich", "technisch" oder "didaktisch"
  * ''rewrite.expand'' – erweitert Inhalte um erläuternde Details
  * ''rewrite.shrink'' – kürzt Texte auf Kernaussagen
  * ''rewrite.simplify'' – vereinfacht Satzbau und Wortwahl
  * ''rewrite.jargonize'' – versieht Texte mit Fachsprache
  * ''rewrite.clean'' – entfernt Redundanzen und stilistische Störungen
  * ''rewrite.format'' – erzwingt strukturelles Re-Formatting (z. B. Markdown, Liste, Codeblock)

==== 💡 Explain-Commands (Erklärung & Didaktik) ====
  * ''explain.stepbystep'' – erklärt komplexe Themen in nachvollziehbaren Schritten
  * ''explain.eli5'' – erklärt so einfach, dass ein Kind es verstehen würde („Explain like I’m five“)
  * ''explain.technical'' – erklärt mit technischer Tiefe und Fachbegriffen
  * ''explain.context'' – ergänzt notwendiges Hintergrundwissen
  * ''explain.factcheck'' – überprüft Aussagen auf sachliche Richtigkeit
  * ''explain.clarify'' – löst unklare Formulierungen oder doppeldeutige Begriffe auf
  * ''explain.contrast'' – stellt Unterschiede oder Gegenüberstellungen heraus

==== 🧭 Summarize- & Structure-Commands (Zusammenfassung & Gliederung) ====
  * ''summarize.tldr'' – erstellt eine ultrakurze Zusammenfassung (TL;DR)
  * ''summarize.article'' – fasst Hauptpunkte zu einer Einleitung oder Abstract zusammen
  * ''summarize.section'' – verdichtet einen einzelnen Abschnitt
  * ''structure.outline'' – generiert eine gegliederte Inhaltsstruktur (Überschriftenplan)
  * ''structure.checklist'' – erstellt Aufgaben- oder Prüflisten
  * ''structure.timeline'' – ordnet Inhalte chronologisch an

==== ⚙️ Format-Commands (Ausgabe & Strukturierung) ====
  * ''format.markdown'' – formatiert den Text als Markdown-Dokument
  * ''format.html'' – erzeugt validen HTML-Code
  * ''format.jsonify'' – gibt strukturierte JSON-Ausgabe zurück
  * ''format.includeexclude'' – steuert, welche Datenfelder oder Textteile berücksichtigt werden
  * ''format.define'' – konvertiert Rohtext in definierte Felder oder Objekte
  * ''format.validate'' – überprüft Ausgabe gegen Schema

==== 🔍 Extract-Commands (Fakten & Informationen) ====
  * ''extract.facts'' – zieht konkrete Fakten oder Datenpunkte aus Texten
  * ''extract.keyphrases'' – extrahiert Schlagworte und Begriffe
  * ''extract.entities'' – erkennt Entitäten (Personen, Orte, Organisationen)
  * ''extract.metrics'' – extrahiert Zahlen, Werte und Kennzahlen
  * ''extract.actionitems'' – listet Aufgaben oder Handlungsempfehlungen
  * ''extract.references'' – zieht Quellen oder Zitate heraus

==== 🎯 Classify-Commands (Kategorisierung & Bewertung) ====
  * ''classify.topic'' – ordnet Inhalte Themenbereichen zu
  * ''classify.sentiment'' – analysiert Stimmung (positiv, neutral, negativ)
  * ''classify.intent'' – erkennt die Absicht eines Satzes oder Absatzes
  * ''classify.audience'' – erkennt, für welche Zielgruppe der Text geeignet ist
  * ''classify.domain'' – ordnet Inhalte einem Fachgebiet zu

==== 🧪 Review-Commands (Analyse & Feedback) ====
  * ''review.style'' – bewertet den Schreibstil nach Klarheit, Struktur und Tonalität
  * ''review.logic'' – prüft logische Konsistenz und Argumentation
  * ''review.grammar'' – analysiert Grammatik und Satzbau
  * ''review.quality'' – beurteilt Textqualität oder Kohärenz
  * ''review.score'' – vergibt eine numerische Bewertung (z. B. 0–100)

==== 🗣️ Role-Commands (Rollen & Personas) ====
  * ''role.actas'' – lässt das Modell eine bestimmte Rolle einnehmen (z. B. Lehrer, Arzt, SEO-Experte)
  * ''role.emulate'' – imitiert Stil oder Denkweise einer bekannten Person oder Marke
  * ''role.limitto'' – beschränkt die Perspektive (z. B. nur Schüler, nur Experte)
  * ''role.combine'' – kombiniert mehrere Rollen (z. B. „Coach und Programmierer“)

==== 🧰 Toolcall-Commands (Funktion & API-Integration) ====
  * ''tool.execute'' – führt ein Tool mit Parametern aus
  * ''tool.query'' – sendet strukturierte Datenabfragen
  * ''tool.evaluate'' – verarbeitet und bewertet Tool-Ergebnisse
  * ''tool.chain'' – führt mehrere Tools sequentiell aus
  * ''tool.describe'' – beschreibt ein Tool oder dessen Ergebnis

==== 🧩 Fewshot- & Learning-Commands (Beispiele & Training) ====
  * ''fewshot.addexample'' – fügt ein Trainingsbeispiel hinzu
  * ''fewshot.clear'' – entfernt bisherige Beispiele
  * ''fewshot.match'' – nutzt Beispielähnlichkeiten für neue Antworten
  * ''fewshot.combine'' – kombiniert mehrere Beispiele zu einer Meta-Instruktion

==== 🧠 QA-Commands (Fragen & Antworten) ====
  * ''qa.answer'' – beantwortet eine konkrete Frage
  * ''qa.elaborate'' – erklärt die Antwort detaillierter
  * ''qa.cite'' – liefert Quellenangaben oder Referenzen
  * ''qa.compare'' – vergleicht zwei Antwortoptionen
  * ''qa.reason'' – begründet, warum eine Antwort gewählt wurde

==== 🌐 Universal- & Workflow-Commands ====
  * ''workflow.chain'' – verbindet mehrere Commands oder Schemata zu einer Pipeline
  * ''workflow.fallback'' – definiert alternative Commands, falls ein anderer fehlschlägt
  * ''universal.auto'' – entscheidet automatisch über passende Command-Kombination
  * ''universal.debug'' – gibt interne Zwischenschritte aus (z. B. für Entwickler)
  * ''universal.randomize'' – variiert Ausdruck oder Stil zufällig

===== Anwendung =====
Commands können in fast allen Seolizer-Schemas eingesetzt werden – besonders in ''article.json'', ''qa.json'', ''summarize.json'' und ''review.json''.  
Global (über ''global_style.style_commands'') gelten sie für den gesamten Text, lokal (z. B. in ''introduction'' oder ''summary'') nur für einzelne Abschnitte.  
Mehrere Commands lassen sich kombinieren, um komplexe LLM-Verhaltensweisen zu erzeugen – etwa:

<code json>
"global_style": {
  "style_commands": ["rewrite.humanize", "explain.stepbystep", "summarize.section"],
  "format_commands": ["format.markdown"]
}
</code>

So entstehen kontrollierte, reproduzierbare und klar strukturierte Prompt-Workflows.

===== Fazit =====
Commands sind das Herzstück der Seolizer-Promptsprache.  
Sie verbinden strukturierte Eingaben mit klar definiertem Verhalten, machen Prompts reproduzierbar und automatisierbar – und heben den Prozess des Schreibens und Erklärens auf eine professionelle, API-ähnliche Ebene.