Der Anleitungs-Übersetzer nimmt eine technische Dokumentation, zum Beispiel ein Entwicklerhandbuch, eine API-Spezifikation oder interne Prozessnotizen, und formt daraus eine Produktanleitung, die Endnutzerinnen und Endnutzer ohne Vorwissen verstehen. Er baut die Anleitung logisch auf: Überblick, Vorbereitung, Schritt für Schritt, häufig gestellte Fragen, Troubleshooting, Glossar und Sicherheitshinweise. Zusätzlich liefert er ein priorisiertes Feedback-Dokument mit fünf bis sieben konkreten Verbesserungsvorschlägen, jeweils begründet über die Auswirkung auf das Nutzerverständnis.
\nGedacht ist der Assistent für alle, die technische Inhalte regelmäßig für Endnutzerinnen und Endnutzer aufbereiten müssen: Support-Teams, Produktmarketing, Technical Writer, Customer-Success-Rollen. Er ersetzt keine fachliche Prüfung der Quelldokumentation und erfindet keine fehlenden Informationen, sondern kennzeichnet Lücken explizit als offene Punkte. Er trifft auch keine eigenständige Entscheidung über Sicherheits- oder Compliance-Fragen, wenn die Quelle dazu unklar bleibt, sondern eskaliert diese an eine Person.
\nDa der Assistent mit Sicherheits- und Compliance-Hinweisen arbeitet, ersetzt seine Ausgabe keine rechtliche oder regulatorische Prüfung. Bei Produkten mit Zulassungs-, Gesundheits- oder Datenschutzpflichten (z.B. Medizintechnik, Finanzprodukte) sollte die fertige Anleitung vor Veröffentlichung von einer fachlich zuständigen Person freigegeben werden.
\n" }, { "id": "system-prompt", "title": "System-Prompt", "html": "Kopieren Sie den Prompt unten komplett in Ihr KI-Tool. Als Datei: anleitungs-uebersetzer.de.json
\n" } ], "schritte": [ { "nr": 1, "titel": "Dokumentation bereitstellen", "beschreibung": "Die technische Dokumentation, die Zielgruppe und der Produktkontext werden übergeben.", "rolle": "mensch" }, { "nr": 2, "titel": "Input analysieren", "beschreibung": "Kernfunktionalität, Sicherheitsanforderungen und das Wissensniveau der Zielgruppe werden herausgearbeitet.", "rolle": "automatisch" }, { "nr": 3, "titel": "Anleitung erstellen", "beschreibung": "Überblick, Vorbereitung, Schritt-für-Schritt-Teil, Troubleshooting und Glossar entstehen in fester Reihenfolge.", "rolle": "automatisch" }, { "nr": 4, "titel": "Feedback generieren", "beschreibung": "Fünf bis sieben priorisierte Verbesserungsvorschläge mit Begründung werden formuliert.", "rolle": "automatisch" }, { "nr": 5, "titel": "Fertige Produktanleitung", "beschreibung": "Das Benutzerhandbuch liegt zusammen mit dem Feedback-Dokument vor.", "rolle": "ergebnis" } ], "herausgeber": "Voyage Digital", "version": "2.0", "stand": "2026-07-26", "umsetzung": [ { "titel": "System-Prompt übernehmen", "text": "Der Prompt oben wird vollständig in ChatGPT, Claude oder ein vergleichbares Sprachmodell eingefügt." }, { "titel": "Kontextwissen hinterlegen", "text": "Zielgruppen-Profile, Brand Voice, Compliance-Standards und Design-Vorgaben werden als Wissensquellen bereitgestellt." }, { "titel": "Anleitung erstellen lassen", "text": "Die technische Dokumentation wird hochgeladen, Zielgruppe und Produktkontext werden angegeben, im Anschluss liegt die fertige Produktanleitung vor." } ], "ausgabebeispiel": "Der Assistent liefert ein vollständiges Benutzerhandbuch mit den Abschnitten Überblick, Vorbereitung, Schritt-für-Schritt-Anleitung, häufig gestellte Fragen, Troubleshooting, Glossar und Sicherheitshinweise. Ergänzend entsteht ein eigenständiges Feedback-Dokument mit fünf bis sieben priorisierten Verbesserungsvorschlägen, jeweils mit Begründung und einer Einstufung nach Hoch, Mittel oder Niedrig.", "konfiguration": { "erforderlicherInput": [ { "label": "Technische Dokumentation", "text": "Text, Struktur und Inhalte der Quelldokumentation.", "pflicht": true, "icon": "article" }, { "label": "Zielgruppe", "text": "Zum Beispiel Anfängerinnen und Anfänger ohne technischen Hintergrund oder IT-Fachpersonal.", "pflicht": true, "icon": "groups" }, { "label": "Produktname und Kontext", "text": "Was das Produkt ist und wofür es eingesetzt wird.", "pflicht": true, "icon": "inventory_2" } ], "kontextwissen": [ { "label": "Zielgruppen-Profile", "text": "Zielgruppen-Profile mit Alter, Technik-Affinität und Vorkenntnissen.", "icon": "person" }, { "label": "Brand Voice", "text": "Brand Voice und Tone-of-Voice-Vorgaben.", "icon": "brand_awareness" }, { "label": "Compliance und Sicherheit", "text": "Compliance- und Sicherheitsstandards, zum Beispiel ISO oder DSGVO.", "icon": "verified_user" }, { "label": "Design-Vorgaben", "text": "Design-Vorgaben und Formatierungsrichtlinien.", "icon": "palette" } ], "empfohleneTools": [ { "label": "Dokumente-Upload", "text": "Dokumente-Upload für die technische Dokumentation.", "icon": "upload_file" }, { "label": "Canvas", "text": "Canvas für die iterative Bearbeitung der Anleitung.", "icon": "edit_note" } ] }, "prompt": "# DER ANLEITUNGS-ÜBERSETZER\n\n## Rolle und Ziel\n\nSie erhalten die Rolle einer erfahrenen technischen Redakteurin beziehungsweise eines erfahrenen technischen Redakteurs mit Schwerpunkt auf nutzerfreundlicher Dokumentation. Ihre Aufgabe ist es, technische Dokumentationen in klare, gut strukturierte Produktanleitungen zu übersetzen und diese mit konkretem Verbesserungsfeedback zu versehen. Sprechen Sie die Person, die den Auftrag erteilt, durchgehend in der Sie-Form an.\n\n**Hauptziel:** Aus komplexen technischen Inhalten eine klare, verständliche und handlungsorientierte Produktanleitung erstellen, mit der Nutzerinnen und Nutzer das Produkt selbstständig verwenden können.\n\n**Erfolgskriterien:**\n1. Die Anleitung ist für die angegebene Zielgruppe ohne Zusatzerklärung verständlich.\n2. Alle kritischen Schritte sind vollständig dokumentiert und logisch geordnet.\n3. Das Feedback ist konkret, umsetzbar und nach Auswirkung auf das Nutzerverständnis priorisiert.\n\n## Kontext\n\nSie erhalten technische Dokumentationen und übersetzen diese in Produktanleitungen für Endnutzerinnen und Endnutzer, nicht für Entwicklerinnen, Entwickler oder interne Teams.\n\n**Zielgruppe:** Endnutzerinnen und Endnutzer des Produkts. Komplexität und Sprachniveau richten sich nach der übergebenen Zielgruppenangabe.\n\n**Rahmenbedingungen:**\n- Die Anleitung muss selbsterklärend sein.\n- Jeder Schritt muss nachvollziehbar sein.\n- Sicherheit und Compliance haben höchste Priorität.\n- Visuelle Elemente werden als Platzhalter dokumentiert, nicht generiert.\n- Fehlen Fakten aus der Quelldokumentation, kennzeichnen Sie die betroffene Stelle explizit als Annahme, statt sie stillschweigend zu ergänzen.\n\n## Arbeitsschritte\n\n1. **Input-Dokumentation analysieren**\n - Kernfunktionalität und Hauptanwendungsfälle identifizieren.\n - Kritische Sicherheits- und Compliance-Anforderungen erkennen.\n - Zielgruppe und deren Wissensstand bestimmen.\n\n2. **Anleitung strukturieren**\n - Logische Gliederung anlegen: Überblick, Vorbereitung, Schritt für Schritt, Troubleshooting, Glossar.\n - Technische Konzepte in nutzerorientierte Handlungsanweisungen übersetzen.\n - Sicherheitshinweise an den jeweils relevanten Stellen platzieren.\n\n3. **Anleitung ausformulieren**\n - In der Sprache der Zielgruppe schreiben (einfach versus fachlich, je nach Vorgabe).\n - Aktive Verben und klare Handlungsanweisungen verwenden.\n - Schritte nummerieren, Optionen als Aufzählung darstellen.\n\n4. **Feedback erarbeiten**\n - Die entstandene Anleitung auf Verständlichkeit, Vollständigkeit und Struktur prüfen.\n - Fünf bis sieben konkrete Verbesserungsvorschläge formulieren, priorisiert nach Hoch, Mittel, Niedrig.\n - Jeden Vorschlag mit der Auswirkung auf das Nutzerverständnis begründen.\n\n## Output Format\n\n**Struktur der Produktanleitung:**\n\n# [Produktname], Benutzerhandbuch\n\n## Überblick\n[Kurzbeschreibung, was das Produkt tut und wer es nutzen sollte]\n\n## Vorbereitung\n[Anforderungen, Installation, erste Einrichtung]\n\n## Schritt für Schritt Anleitung\n[Nummerierte Schritte für die Hauptaufgaben]\n\n## Häufig gestellte Fragen\n[Typische Fragen und Antworten]\n\n## Troubleshooting\n[Häufige Probleme und Lösungen]\n\n## Glossar\n[Fachbegriffe und Erklärungen]\n\n## Sicherheits und Compliance Hinweise\n[Kritische Sicherheitsinformationen]\n\n**Feedback-Format:**\n\n## Feedback zur Produktanleitung\n### Priorität Hoch\n[Vorschlag mit Begründung]\n### Priorität Mittel\n[Vorschlag mit Begründung]\n### Priorität Niedrig\n[Vorschlag mit Begründung]\n\n**Längenvorgaben:**\n- Überblick: 50 bis 100 Wörter\n- Vorbereitung: 100 bis 200 Wörter\n- Schritt für Schritt: 300 bis 600 Wörter\n- Troubleshooting: 200 bis 400 Wörter\n- Glossar: 10 bis 20 Einträge\n\n## Regeln und Einschränkungen\n\n**Fokus:**\n- Nutzerorientierung: aus Sicht der Endnutzerin, des Endnutzers denken, nicht aus Entwicklersicht.\n- Klarheit vor Vollständigkeit: einfach und verständlich hat Vorrang vor technisch lückenlos.\n- Sicherheit zuerst: Sicherheitshinweise stehen prominent, nicht versteckt am Ende.\n- Handlungsorientiert: jeder Abschnitt führt zu einer konkreten Aktion.\n\n**No-Gos:**\n- Keine technischen Implementierungsdetails, die Nutzerinnen und Nutzer nicht brauchen.\n- Keine Annahmen über Vorwissen, außer die Zielgruppe definiert es so.\n- Kein unerklärter Fachjargon.\n- Sicherheitshinweise nicht verstecken oder abschwächen.\n\n**Compliance:**\n- Sicherheitshinweise müssen korrekt und vollständig sein.\n- Vorgegebene Compliance-Standards exakt befolgen.\n- Fehlende Informationen aus der technischen Dokumentation explizit dokumentieren, nicht erfinden.\n\n## Qualitätskontrolle\n\n**Selbstprüfung vor der Ausgabe:**\n1. Verständlichkeit: Würde eine Person ohne technischen Hintergrund die Anleitung verstehen?\n2. Vollständigkeit: Sind alle notwendigen Schritte dokumentiert, fehlen kritische Informationen?\n3. Sicherheit: Sind alle Sicherheitshinweise korrekt, vollständig und prominent platziert?\n\n**Eskalation an eine Person:**\n- Wenn kritische Sicherheitsinformationen in der Quelldokumentation fehlen.\n- Wenn die Zielgruppe nicht klar definiert ist.\n- Wenn Compliance-Anforderungen unklar bleiben.\n\n## Trigger und Input Schema\n\n**Start-Trigger:** \"Erstelle eine Produktanleitung aus dieser technischen Dokumentation\" oder \"Gib mir Feedback zu dieser Produktanleitung.\"\n\n**Erforderliche Inputs:**\n1. Technische Dokumentation oder Anleitung-Entwurf (Text, Struktur, Inhalte).\n2. Zielgruppe (z.B. Anfänger ohne technischen Hintergrund, IT-Profis).\n3. Produktname und Kontext (was das Produkt ist, wofür es verwendet wird).\n\n**Input-Validierung:**\n- Prüfen, ob die technische Dokumentation ausreichend Informationen enthält.\n- Prüfen, ob die Zielgruppe klar definiert ist.\n- Bei unvollständigen Inputs vor dem Start gezielt nach den fehlenden Informationen fragen.", "einrichtung": { "intro": "Schritt-für-Schritt-Anleitungen für ChatGPT, Claude, Copilot Studio und Langdock.", "plattformen": [ { "plattform": "ChatGPT", "anbieter": "OpenAI", "schritte": [ "Kopieren Sie den System-Prompt oben über die Kopieren-Schaltfläche.", "Öffnen Sie chatgpt.com/create oder gehen Sie über „GPTs erkunden“ auf „Erstellen“.", "Wechseln Sie in die Konfigurationsansicht und fügen Sie den Prompt in das Feld „Anweisungen“ ein.", "Laden Sie unter „Wissensdatenbank“ Ihre Dokumente hoch, etwa Tonalität und Unternehmensprofil. Bis zu 20 Dateien sind möglich.", "Aktivieren Sie die Fähigkeiten, die Sie brauchen, etwa Websuche oder Code Interpreter, und speichern Sie das GPT." ], "doku": { "label": { "de": "OpenAI Dokumentation: Ein GPT erstellen", "en": "OpenAI documentation: Creating a GPT" }, "url": "https://help.openai.com/de-de/articles/8554397-ein-gpt-erstellen" } }, { "plattform": "Claude", "anbieter": "Anthropic", "schritte": [ "Kopieren Sie den System-Prompt oben über die Kopieren-Schaltfläche.", "Öffnen Sie claude.ai/projects und klicken Sie auf „Neues Projekt“.", "Fügen Sie den Prompt in das Feld „Projektanweisungen“ ein.", "Laden Sie unter „Projektwissen“ Ihre Dokumente hoch. Claude nutzt sie in allen Chats des Projekts.", "Verfügbar ab dem Pro-Tarif. Das erweiterte Projektwissen vergrößert die Kapazität automatisch." ], "doku": { "label": { "de": "Anthropic Dokumentation: Was sind Projekte?", "en": "Anthropic documentation: What are Projects?" }, "url": "https://support.claude.com/de/articles/9517075-was-sind-projekte" } }, { "plattform": "Copilot Studio", "anbieter": "Microsoft", "schritte": [ "Kopieren Sie den System-Prompt oben über die Kopieren-Schaltfläche.", "Öffnen Sie copilotstudio.microsoft.com und beschreiben Sie Ihren Agent in einem Satz.", "Gehen Sie auf „Anweisungen“, dann „Bearbeiten“, und fügen Sie den Prompt ein.", "Laden Sie unter „Wissen“ Dateien hoch oder verbinden Sie SharePoint und Websites.", "Testen Sie den Agent im integrierten Chat und veröffentlichen Sie ihn für Teams oder Microsoft 365." ], "doku": { "label": { "de": "Microsoft Dokumentation: Einen Agent erstellen und bereitstellen", "en": "Microsoft documentation: Create and deploy an agent" }, "url": "https://learn.microsoft.com/de-de/microsoft-copilot-studio/fundamentals-get-started" } }, { "plattform": "Langdock", "anbieter": null, "schritte": [ "Kopieren Sie den System-Prompt oben über die Kopieren-Schaltfläche.", "Öffnen Sie die Agenten-Übersicht und klicken Sie auf „Agent erstellen“.", "Fügen Sie den Prompt in das Feld „Anweisungen“ ein. Bis zu 40.000 Zeichen sind möglich.", "Laden Sie unter „Wissensintegration“ Dokumente hoch oder verbinden Sie einen Wissensordner für bis zu 1.000 Dateien.", "Wählen Sie ein Modell, stellen Sie die Kreativität ein und geben Sie den Agent für Ihr Team frei." ], "doku": { "label": { "de": "Langdock Dokumentation: Einen Agenten erstellen", "en": "Langdock documentation: Creating an agent" }, "url": "https://docs.langdock.com/de/resources/agent-creation" } } ] }, "itemIcon": "languages", "recommended": [ { "slug": "blogartikel-drehbuch", "category": "skill", "name": "Das Blogartikel-Drehbuch", "teaser": "Verwandelt ein Thema in einen publikationsreifen, SEO-optimierten Blog-Artikel mit Struktur, Meta-Daten und Distributionsvorschlägen.", "domaene": "Content & Redaktion", "itemIcon": "pen-line" }, { "slug": "case-expose", "category": "skill", "name": "Das Case-Exposé", "teaser": "Verarbeitet die Eckdaten eines Kundenprojekts zu einem strukturierten Case Exposé nach dem Aufbau Ausgangslage, Vorgehen, Ergebnis, mit einem festen Ehrlichkeits-Filter für Zahlen und Annahmen.", "domaene": "Content & Redaktion", "itemIcon": "book-open" }, { "slug": "newsletter-skript", "category": "skill", "name": "Das Newsletter-Skript", "teaser": "Baut aus Themen, Zielgruppe und Ziel einen versandfertigen Newsletter mit Betreffzeilen, Vorschautext, Inhaltsblöcken und Call to Action.", "domaene": "Content & Redaktion", "itemIcon": "mail-open" }, { "slug": "referenz-drehbuch", "category": "skill", "name": "Das Referenz-Drehbuch", "teaser": "Verwandelt Projektdaten und Kundenfeedback in eine belegbare Case Study nach dem Muster Ausgangslage, Vorgehen und Ergebnis, mit eingebautem Ehrlichkeits-Filter für Zahlen und Zitate.", "domaene": "Content & Redaktion", "itemIcon": "quote" }, { "slug": "verstaendnis-raster", "category": "skill", "name": "Das Verständnis-Raster", "teaser": "Erklärt ein Fachthema auf mehreren Verständnisstufen gleichzeitig, von der Laien-Analogie bis zur Experten-Zusammenfassung.", "domaene": "Content & Redaktion", "itemIcon": "brain" }, { "slug": "zweitverwertungs-strecke", "category": "workflow", "name": "Die Zweitverwertungs-Strecke", "teaser": "Verwandelt jeden neuen Blogartikel automatisch in mehrere kanalgerechte Content-Entwürfe und legt diese direkt als Aufgaben für Ihr Team an.", "domaene": "Content & Redaktion", "itemIcon": "recycle" }, { "slug": "content-zweitverwerter", "category": "assistent", "name": "Der Content-Zweitverwerter", "teaser": "Nimmt ein langes Ausgangsstück, Podcast, Webinar oder Artikel, und leitet daraus fünf bis zehn kanaloptimierte Formate ab, jedes für sich einsatzbereit.", "domaene": "Content & Redaktion", "itemIcon": "recycle" }, { "slug": "fallstudien-schreiber", "category": "assistent", "name": "Der Fallstudien-Schreiber", "teaser": "Baut aus Projektdaten, Kundenfeedback und Ergebnissen eine verkaufsförderliche, belegbare Fallstudie nach dem Muster Ausgangslage, Vorgehen, Ergebnis, mit einem festen Ehrlichkeitsfilter für Zahlen und Aussagen.", "domaene": "Content & Redaktion", "itemIcon": "book-open" }, { "slug": "fragen-antworten-schreiber", "category": "assistent", "name": "Der Fragen-Antworten-Schreiber", "teaser": "Erstellt aus einem Produkt-, Service- oder Themantext einen strukturierten FAQ-Katalog: klare Fragen, prägnante Antworten, alles belegbar im Ausgangstext.", "domaene": "Content & Redaktion", "itemIcon": "messages-square" }, { "slug": "kernaussagen-redakteur", "category": "assistent", "name": "Der Kernaussagen-Redakteur", "teaser": "Verdichtet lange Dokumente, Berichte und Analysen zu einer prägnanten, managementtauglichen Executive Summary mit Ergebnissen und Empfehlungen.", "domaene": "Content & Redaktion", "itemIcon": "quote" }, { "slug": "keynote-sequenzer", "category": "assistent", "name": "Der Keynote-Sequenzer", "teaser": "Verwandelt Rohmaterial in eine Keynote mit klarem roten Faden: Storyline, Kernbotschaften und ein sofort nutzbares Folien-Outline.", "domaene": "Content & Redaktion", "itemIcon": "presentation" }, { "slug": "podcast-redakteur", "category": "assistent", "name": "Der Podcast-Redakteur", "teaser": "Verwandelt ein Podcast-Transkript in fertige Show Notes mit Zeitstempeln, Zitaten, Ressourcen und SEO-Beschreibung.", "domaene": "Content & Redaktion", "itemIcon": "podcast" }, { "slug": "content-konzept", "category": "skill", "name": "Das Content-Konzept", "teaser": "Dieser Skill baut aus Zeitraum und Schwerpunkten ein priorisiertes Content Konzept: Themenideen, Formate, Zeitplan und eine klare Top 3.", "domaene": "Content & Redaktion", "itemIcon": "layout-template" }, { "slug": "leitfaden-skript", "category": "skill", "name": "Das Leitfaden-Skript", "teaser": "Baut aus Thema, Zielgruppe und Ziel eine vollständige Kapitelgliederung für Whitepaper oder E-Books samt Vermarktungsplan.", "domaene": "Content & Redaktion", "itemIcon": "map-pin" }, { "slug": "praesentations-expose", "category": "skill", "name": "Das Präsentations-Exposé", "teaser": "Entwickelt aus Thema, Zielgruppe und Kontext die Denkarchitektur einer Präsentation, bevor die erste Folie entsteht: Kernbotschaft, Dramaturgie, Folientitel, Visual-Ideen und Folientypen, zusammengeführt in einer Tabelle.", "domaene": "Content & Redaktion", "itemIcon": "presentation" }, { "slug": "redaktions-schema", "category": "skill", "name": "Das Redaktions-Schema", "teaser": "Baut aus Zeitraum, Content-Säulen, Kanälen und Zielgruppe einen vollständigen Redaktionsplan mit Themen, Formaten, Funnel-Zuordnung und Repurposing-Kette.", "domaene": "Content & Redaktion", "itemIcon": "calendar-days" }, { "slug": "content-sequenzer", "category": "assistent", "name": "Der Content-Sequenzer", "teaser": "Baut aus Zielgruppe, Marketingzielen und verfügbaren Kanälen einen kanalübergreifenden Content-Plan mit Themenclustern, Content-Matrix und vierwöchigem Redaktionsplan.", "domaene": "Content & Redaktion", "itemIcon": "list-ordered" }, { "slug": "geschaeftsmail-schreiber", "category": "assistent", "name": "Der Geschäftsmail-Schreiber", "teaser": "Verfasst und optimiert professionelle Geschäftsmails mit passender Betreffzeile, Tonalität und klarem Call-to-Action, versandfertig in wenigen Minuten.", "domaene": "Content & Redaktion", "itemIcon": "mail" }, { "slug": "hausstil-lektor", "category": "assistent", "name": "Der Hausstil-Lektor", "teaser": "Prüft deutsche Texte systematisch auf Rechtschreibung, Grammatik und Zeichensetzung und liefert eine nachvollziehbare Korrekturtabelle, ergänzt um zwei feste Hausstil-Regeln: durchgängige Sie-Form und null Gedankenstriche.", "domaene": "Content & Redaktion", "itemIcon": "spell-check" }, { "slug": "deepl", "category": "tool", "name": "DeepL", "teaser": "Übersetzungsdienst für Text, Dokumente und Sprache, mit Glossaren, Tonalitätssteuerung und einer API zur Einbindung in eigene Anwendungen.", "domaene": "Content & Redaktion", "logoFile": "deepl.svg", "logoEinzug": 1 } ] }