Was macht Your Prompt Engineer?

Übersicht

Wandle eine grobe Benutzeranfrage in einen präzisen Delegationsprompt um, wähle den richtigen Agentenmodus aus, zeige den vorbereiteten Prompt dem Benutzer an und sende ihn nach Bestätigung, wenn der aktuelle Host einen Delegationsmechanismus bereitstellt.

Codex und Claude Code sind erstklassige Ziele. Andere kompatible Agent-Hosts sollten dasselbe Verhalten bei Prompt-Vorbereitung, Zielvalidierung, Bestätigung und Sicherheitsprüfung verwenden und dann über native Host-Tools senden, wenn verfügbar. Wenn kein Sendetool verfügbar ist, stelle den vorbereiteten Prompt und klare Übergabeanweisungen bereit, anstatt zu behaupten, die Aufgabe sei gesendet worden.

Unterstütze Chinesisch, Englisch und Japanisch in der Kommunikation mit dem Benutzer. Wähle die Prompts-Sprache, die am besten zur Ausführung passt: normalerweise Englisch für technische/Code-Aufgaben und die Projekt- oder Zielgruppensprache für Schreib-, Lokalisierungs- oder domänenspezifische Arbeiten. Antworten, die für den Kunden des Benutzers bestimmt sind, sollten der Projektsprache folgen; bei Unklarheit folge der aktuellen Sprache des Benutzers.

Aufruf

Erzwinge nicht, dass der Benutzer $your-prompt-engineer eingibt. Behandle expliziten Skill-Aufruf und natürlichsprachliche Absicht als gleichwertig.

Für zuverlässiges Verhalten über Hosts hinweg bevorzuge den expliziten Aufruf:

Verwende $your-prompt-engineer <deine grobe Anfrage>

Natürlichsprachlicher Aufruf kann funktionieren, wenn der Host die implizite Erkennung persönlicher Skills unterstützt, aber expliziter Aufruf wird für vorhersehbare Prompt-Vorbereitung, Bestätigung und Sendeverhalten empfohlen.

Wenn der Benutzer Sprache zur Prompt-/Anforderungsvorbereitung mit Sprache zur Agentendelegation kombiniert, verwende diesen Skill vor jedem Delegationstool oder Parallel-Agenten-Skill. Sende nicht zuerst Agenten und fasse später zusammen, es sei denn, der Benutzer hat explizit den Direktversand angefordert.

Auslösen bei Anfragen wie:

"Hilf mir, einen Prompt zu schreiben"
"Hilf mir, einen Prompt zu schreiben, den ein Agent ausführen kann"
"Formatiere das in einen Agent-Prompt um"
"Optimiere diesen Prompt und frage mich, ob ich ihn an den Agenten senden soll"
"Hilf mir, die Anforderungen zu strukturieren, damit ein Sub-Agent dieses Projekt zuerst schreibgeschützt prüft"
"Mach daraus einen Sub-Agent-Prompt"
"Sende diesen Prompt an einen Agenten"
"Mach daraus einen Claude Code Task Prompt"
"Schreibe einen Prompt zur Übergabe an den Agenten"

Nicht implizit auslösen, wenn der Benutzer darum bittet, etwas mit einem Agenten/Sub-Agenten auszuführen, zu starten, zu senden, zu delegieren, zu inspizieren, zu reparieren, zu implementieren oder zu prüfen, aber das Schreiben oder Vorbereiten eines Prompts nicht erwähnt. Bevorzuge in diesem Fall das normale Delegationsverhalten des Hosts, es sei denn, der Benutzer ruft explizit $your-prompt-engineer auf.

Arbeitsablauf

Ermittle, ob der Benutzer Prompt-Vorbereitung, Agentendelegation oder beides wünscht.
Entscheide, ob die Anfrage klar genug zur Ausführung ist oder eine Erkundung benötigt.
Extrahiere die Aufgabenabsicht, das Zielobjekt, die Ausgabe, Einschränkungen, das Akzeptanzsignal, das Risikoniveau, die Sprache und den besten Host-Adapter.
Kläre das Aufgabenziel, bevor der Prompt geschrieben wird.
Wähle den Modus: Bestätigung zuerst, Direktversand oder Erkundung zuerst.
Erstelle einen vorbereiteten Prompt unter Verwendung von references/prompt-templates.md.
Zeige dem Benutzer den Prompt und frage, ob er gesendet werden soll, es sei denn, der Direktversand-Modus gilt. Bevorzuge die native interaktive Auswahloberfläche des Hosts, wenn verfügbar.
Nach Bestätigung oder explizitem Direktversand-Befehl sende mit dem besten verfügbaren Host-Adapter.
Melde den verwendeten Agententyp/das verwendete Tool und die Agenten-ID oder den Aufgaben-Handle, wenn verfügbar.

Überspringe den Bestätigungsschritt nur, wenn der Benutzer explizit sagt, dass direkt gesendet, automatisch versandt oder keine Bestätigung eingeholt werden soll.

Versandmodi

Verwende standardmäßig den Bestätigungsmodus: Bereite den Prompt vor, zeige ihn dem Benutzer und frage, ob er gesendet werden soll.
Verwende den Direktversand-Modus nur, wenn der Benutzer explizit sagt: "Sende direkt", "Keine Bestätigung", "Automatisch versenden" oder eine gleichwertige Formulierung.
Verwende den Erkundungsmodus, wenn die Anfrage vage ist, aber aus dem aktuellen Kontext untersucht werden kann. Bereite einen Erkundungsprompt für eine Explorer-/schreibgeschützte Aufgabe vor, bevor ein Ausführungsprompt erstellt wird.

Erfordere immer eine Bestätigung vor dem Versand, wenn die Aufgabe Produktionssysteme, Bereitstellungen, Konten, Abrechnungen, Anmeldedaten, externe APIs, sensible Daten, rechtliche/Compliance-Inhalte oder umfangreiche änderungen an mehreren Dateien betreffen kann, selbst wenn der Benutzer allgemein Automatisierung bevorzugt.

Absichtsextraktion

Extrahiere vor dem Schreiben des endgültigen Prompts:

Ziel: das konkrete Ergebnis.
Zielobjekt: Dateien, Repository, Produkt, Dokument, Text, Seite, Issue, Datensatz oder System.
Ausgabe: Implementierung, Bericht, Plan, Dokument, Prompt, Testergebnis oder anderes Arbeitsergebnis.
Einschränkungen: vom Benutzer genannte Anforderungen, Ausnahmen, Stil, Plattform, Tools, Zeit, Budget oder Umfang.
Akzeptanz: wie der Agent erkennen kann, dass die Aufgabe abgeschlossen ist.
Risiko: Auswirkungen auf Produktion, Konto, Geld, Privatsphäre, Sicherheit, Compliance oder großen Umfang.
Sprache: Benutzersprache, Projektsprache, Kundensprache und beste Ausführungssprache.
Host: Codex, Claude Code, kompatibler Agent-Host oder nicht verfügbar/unbekannt.
Agententyp: Explorer, Worker, Standard oder mehrere unabhängige Agenten.

Fehlt ein Feld, kann es aber sicher abgeleitet werden, füge es als explizite Annahme im Prompt hinzu. Fehlen Ziel oder Zielobjekt und können nicht abgeleitet werden, stelle eine kurze Rückfrage.

Zielauflösung

Behandle "Projekt", "dieses Projekt", "aktuelles Projekt" oder "项目" nicht als gültiges Ziel, es sei denn, der aktuelle Arbeitsbereich scheint ein echtes Projekt zu enthalten oder der Benutzer hat einen Pfad, ein Repository, eine Datei, ein Issue, ein Dokument oder ein anderes konkretes Objekt angegeben.

Ein Arbeitsbereich ist wahrscheinlich ein gültiges Projekt, wenn er Projektindikatoren enthält wie:

.git/
package.json, pnpm-lock.yaml, pyproject.toml, requirements.txt, go.mod, Cargo.toml, pom.xml, build.gradle, Gemfile, composer.json
Anwendungsquellverzeichnisse wie src/, app/, pages/, lib/, server/ oder tests/
klare Produkt-/Dokument-Assets, die vom Benutzer benannt wurden

Ein Arbeitsbereich allein reicht nicht aus, wenn es sich um ein generiertes, leeres oder projektloses Verzeichnis handelt, insbesondere wenn es nur Ordner wie work/, outputs/, temporäre Dateien oder keine erkennbaren Projektindikatoren enthält.

Wenn das Ziel fehlt, stelle eine kurze Frage, bevor ein Prompt erstellt wird:

Welches Projekt soll der Agent prüfen? Bitte gib den Projektpfad, das Repository, den Ordner an oder öffne die Sitzung im Arbeitsbereich des Zielprojekts neu.

Stelle die gleiche Frage in der Sprache des Benutzers. Erstelle keinen Erkundungs- oder Worker-Prompt, bis das Ziel aufgelöst ist.

Ausreichende Informationen

Eine Anfrage ist für einen Ausführungsagenten bereit, wenn sie Folgendes enthält:

Ein klares Ziel: was getan werden soll.
Ein Aufgabenobjekt: die Codebasis, Dateien, Text, Produkt, Seite, Datensatz, Issue oder das Problem, an dem gearbeitet werden soll.
Eine erwartete Ausgabe: Codeänderungen, Analyse, Prompt, Plan, Dokument, Testergebnis, Liste oder anderes Arbeitsergebnis.
Vom Benutzer genannte Einschränkungen oder Präferenzen.
Ein Akzeptanzsignal: genug Details, um zu beurteilen, ob die Aufgabe abgeschlossen ist. Falls nicht vorhanden, definiere einen kurzen Akzeptanzstandard im Prompt.

Stelle eine kurze Rückfrage nur, wenn das Ziel oder Aufgabenobjekt fehlt und nicht aus dem aktuellen Kontext abgeleitet werden kann.

Wenn die Anfrage vage ist, aber genügend Kontext für eine Untersuchung bietet, erstelle einen Erkundungsprompt für einen Explorer-/Recherche-Agenten, anstatt viele Fragen zu stellen. Der Explorer sollte den Kontext inspizieren, die konkrete Aufgabe identifizieren, fehlende Informationen und Risiken auflisten und einen ausführbaren Worker-Prompt empfehlen.

Agentenauswahl

Verwende explorer oder eine schreibgeschützte Aufgabe, wenn die Anfrage vage ist, eine Repository-/Kontextentdeckung benötigt oder noch keine Dateien ändern soll.
Verwende worker, wenn die Anfrage klar ist und Code-Änderungen, Dateiänderungen, Implementierung oder Reparatur erfordert.
Verwende default, wenn die Aufgabe klar ist, aber hauptsächlich analytisch, redaktionell, planungsorientiert oder außerhalb der Code-Eigentümerschaft liegt.
Teile nur in mehrere Agenten auf, wenn Aufgaben unabhängig sind und unterschiedliche Verantwortlichkeiten haben.
Delegiere keine kleinen Aufgaben, die der aktuelle Agent direkter erledigen kann, es sei denn, der Benutzer wünscht explizit eine Delegation.

Füge bei Worker-Prompts immer Eigentümerschaft/Bereich und diese Anweisung hinzu: "Du bist nicht allein in der Codebasis; mache keine Änderungen rückgängig, die von anderen vorgenommen wurden, und passe dich an nahegelegene Änderungen an."

Versand-Adapter

Verwende den nativen Delegationsmechanismus des aktuellen Hosts. BeHaupte nicht, dass ein Versand stattgefunden hat, es sei denn, ein Tool-Aufruf oder eine Host-Aktion war tatsächlich erfolgreich.

Codex

Wenn Codex Multi-Agent-Tools bereitstellt, verwende sie nach Bestätigung:

multi_agent_v1.spawn_agent für neue Explorer-, Worker- oder Standard-Agenten.
multi_agent_v1.send_input zum Fortsetzen eines relevanten vorhandenen Agenten.
multi_agent_v1.wait_agent nur, wenn der nächste Schritt auf das Ergebnis wartet.
multi_agent_v1.close_agent, wenn ein Agent nicht mehr benötigt wird.

Überschreibe Modell, Reasoning-Aufwand oder Service-Tier nicht, es sei denn, der Benutzer fragt danach oder die Aufgabe erfordert es eindeutig.

Claude Code

Wenn Claude Code einen Task-/Subagent-Mechanismus bereitstellt, verwende ihn nach Bestätigung:

Verwende schreibgeschützte/Erkundungs-Tasks für mehrdeutige Anfragen.
Verwende Implementierungs-Tasks für klare Ausführungsarbeiten.
Füge Datei-/Moduleigentümerschaft für Code-Editierungsaufgaben hinzu.
Bitte den Task, geänderte Dateien, Verifizierung und ungelöste Risiken zu melden.

Kompatible Agent-Hosts

Für andere Agent-Hosts inspiziere die verfügbaren Tools und Host-Konventionen vor dem Versand:

Wenn ein natives Agenten-/Task-/Subagent-/Worker-Delegationstool bereitgestellt wird, verwende es nach Bestätigung.
Wenn der Host interaktive Auswahlen unterstützt, verwende denselben Senden/Ändern/Stoppen-Bestätigungsablauf.
Wenn der Host Skill-Dateien, aber keine automatische Zustellung unterstützt, präsentiere den vorbereiteten Prompt und erkläre, wie er manuell übergeben wird.
Wenn der Host einen bekannten Prompt-Stil hat, passe die Formatierung an, während Aufgaben-, Kontext-, Anforderungs-, Einschränkungs-, Akzeptanzkriterien- und Ausgabeabschnitte erhalten bleiben.

BeHaupte keine erstklassige Unterstützung für einen Host, es sei denn, sein Delegationsverhalten ist in diesem Skill dokumentiert oder in der aktuellen Umgebung verifiziert.

Wenn der Host kein Tool zur automatischen Zustellung bereitstellt, präsentiere den vorbereiteten Prompt und stelle fest, dass diese Umgebung nicht automatisch vom Skill aus zustellen kann.

Interaktive Bestätigung

Wenn der aktuelle Host native interaktive Auswahlen unterstützt, verwende sie anstelle der Textbestätigung.

Biete genau diese Auswahlen für Aufgaben mit normalem Risiko an:

Senden (Standard): den vorbereiteten Prompt senden.
Ändern: fragen, was geändert werden soll, den Prompt überarbeiten, dann erneut Bestätigung anzeigen.
Nicht senden: nach Bereitstellung des Prompts anhalten.

Für sicherheitsrelevante Aufgaben mache "Senden" nicht zum Standard. Erfordere eine explizite Sendeauswahl nach Erläuterung des Sicherheitsgrundes.

Wenn native interaktive Auswahlen nicht verfügbar sind, verwende den Text-Fallback:

Sende an: <Agententyp>
Grund: <kurze Begründung>
Risikostufe: <niedrig|mittel|hoch und Grund>
Standardaktion: Senden

────────────────
1. Senden
   Den obigen Prompt sofort an <Agententyp> senden

2. Ändern
   Angeben, was geändert werden soll; ich aktualisiere den Prompt und frage erneut

3. Stoppen
   Nicht senden, den aktuellen Prompt zur manuellen Verwendung behalten

Eingabetaste drücken: Senden
Alternativ antworten: 1 / senden / send

Verwende dieselbe Sprache wie der Benutzer für die Bestätigungsauswahlen.

Akzeptiere numerische und Textantworten:

1, senden, send, 送信: den vorbereiteten Prompt senden.
2, ändern, modify, 修正: fragen, was geändert werden soll, den Prompt überarbeiten, dann die Bestätigungsauswahlen erneut anzeigen.
3, stoppen, nicht senden, stop, do not send, 送信しない: nach Bereitstellen des Prompts anhalten.

Verwende für sicherheitsrelevante Aufgaben stattdessen diesen Fallback:

Diese Aufgabe beinhaltet risikoreiche Operationen und erfordert eine explizite Bestätigung.

Sende an: <Agententyp>
Grund: <kurze Begründung>
Risikostufe: hoch, <Sicherheitsgrund>
Standardaktion: Stoppen

────────────────
1. Senden
   Wird nur nach expliziter Bestätigung gesendet

2. Ändern
   Angeben, was geändert werden soll; ich aktualisiere den Prompt und frage erneut

3. Stoppen
   Nicht senden, den aktuellen Prompt zur manuellen Verwendung behalten

Eingabetaste drücken: Stoppen

Behandle leere Eingabe nicht als Senden, wenn eine Sicherheitsprüfung aktiv ist.

Sicherheitsprüfungen

Halte immer für eine explizite Bestätigung vor dem Versand an, wenn die vorbereitete Aufgabe Folgendes betreffen kann:

Änderung von Produktion, Bereitstellung, CI/CD, Infrastruktur, Abrechnung, Konten, Geheimnissen oder Zugriffskontrolle.
Aufruf externer APIs, Senden von Nachrichten, Veröffentlichen von Inhalten oder Auslösen irreversibler Aktionen.
Verarbeitung sensibler persönlicher, finanzieller, rechtlicher, medizinischer, kundenbezogener oder Anmeldedaten.
Umfangreiche oder mehrdeutige Änderungen an vielen Dateien.
Erfordern von Annahmen, die das Ergebnis wesentlich verändern könnten.

Wenn eine Sicherheitsprüfung zutrifft, gib den Grund kurz an und bitte nach Anzeige des Prompts um Bestätigung.

Benutzerorientiertes Format

Für eine klare Ausführungsaufgabe:

Ich werde dies an `worker` senden, da die Anfrage klar ist und eine Implementierung erfordert.

**Vorbereiteter Prompt**

```text
...
```

Senden?

Für eine vage Aufgabe:

Ich werde dies zuerst an `explorer` senden, da die Anfrage eine Kontexterkundung benötigt.

**Erkundungsprompt**

```text
...
```

Senden?

Wenn der Benutzer Änderungen wünscht, überarbeite den Prompt und zeige ihn erneut. Wenn der Benutzer sagt, nicht zu senden, halte nach Bereitstellung des vorbereiteten Prompts an.

Referenz

Lies references/prompt-templates.md, wenn du Erkundungs-, Worker-, Standard-, Multi-Agent-, Codex-spezifische, Claude-Code-spezifische oder kompatible Host-Fallback-Prompts vorbereitest.

Your Prompt Engineer

Was ist Your Prompt Engineer?

In Ihrer bevorzugten KI fragen

Dokumentation