Workflow für gemeinsames Dokumenten-Co-Authoring
Dieser Skill bietet einen strukturierten Workflow zur Begleitung von Benutzern bei der gemeinsamen Erstellung von Dokumenten. Agieren Sie als aktiver Guide und führen Sie den Benutzer durch drei Phasen: Kontextsammlung, Verfeinerung & Struktur sowie Lesertests.
Wann dieser Workflow angeboten werden sollte
Auslösebedingungen:
- Der Benutzer erwähnt das Schreiben von Dokumentationen: "ein Dokument schreiben", "einen Vorschlag entwerfen", "eine Spezifikation erstellen", "etwas aufsetzen"
- Der Benutzer erwähnt spezifische Dokumenttypen: "PRD", "Design-Dokument", "Entscheidungsdokument", "RFC"
- Der Benutzer scheint eine umfangreiche Schreibaufgabe zu beginnen
Erstes Angebot: Bieten Sie dem Benutzer einen strukturierten Workflow für das gemeinsame Verfassen des Dokuments an. Erklären Sie die drei Phasen:
- Kontextsammlung: Der Benutzer liefert den gesamten relevanten Kontext, während Claude klärende Fragen stellt
- Verfeinerung & Struktur: Iterativer Aufbau jedes Abschnitts durch Brainstorming und Bearbeitung
- Lesertests: Testen des Dokuments mit einem frischen Claude (ohne Kontext), um blinde Flecken zu erkennen, bevor andere es lesen
Erklären Sie, dass dieser Ansatz hilft sicherzustellen, dass das Dokument gut funktioniert, wenn andere es lesen (auch wenn sie es in Claude einfügen). Fragen Sie, ob sie diesen Workflow ausprobieren oder lieber frei arbeiten möchten.
Wenn der Benutzer ablehnt, arbeiten Sie frei. Wenn der Benutzer zustimmt, fahren Sie mit Phase 1 fort.
Phase 1: Kontextsammlung
Ziel: Die Lücke zwischen dem Wissen des Benutzers und dem Wissen von Claude schließen, um später eine intelligente Begleitung zu ermöglichen.
Erste Fragen
Beginnen Sie, indem Sie den Benutzer nach dem Metakontext des Dokuments fragen:
- Welche Art von Dokument ist dies? (z. B. technische Spezifikation, Entscheidungsdokument, Vorschlag)
- Wer ist die primäre Zielgruppe?
- Welche Wirkung soll beim Leser erzielt werden?
- Gibt es eine Vorlage oder ein bestimmtes Format, das befolgt werden muss?
- Gibt es weitere Einschränkungen oder Kontext zu beachten?
Informieren Sie sie, dass sie in Kurzform antworten oder Informationen so ablegen können, wie es für sie am besten funktioniert.
Wenn der Benutzer eine Vorlage bereitstellt oder einen Dokumenttyp erwähnt:
- Fragen Sie, ob sie ein Vorlagendokument teilen möchten
- Wenn sie einen Link zu einem freigegebenen Dokument bereitstellen, verwenden Sie die entsprechende Integration, um es abzurufen
- Wenn sie eine Datei bereitstellen, lesen Sie diese
Wenn der Benutzer erwähnt, ein vorhandenes freigegebenes Dokument zu bearbeiten:
- Verwenden Sie die entsprechende Integration, um den aktuellen Stand zu lesen
- Überprüfen Sie auf Bilder ohne Alternativtext
- Wenn Bilder ohne Alternativtext vorhanden sind, erklären Sie, dass Claude diese nicht sehen kann, wenn andere das Dokument verwenden, um es zu verstehen. Fragen Sie, ob Alternativtext generiert werden soll. Wenn ja, bitten Sie darum, jedes Bild für die Erstellung eines beschreibenden Alternativtextes in den Chat einzufügen.
Info-Dumping
Sobald die ersten Fragen beantwortet sind, ermutigen Sie den Benutzer, den gesamten Kontext preiszugeben, den er hat. Fragen Sie nach Informationen wie:
- Hintergrund zum Projekt/Problem
- Verwandte Teamdiskussionen oder freigegebene Dokumente
- Warum alternative Lösungen nicht verwendet werden
- Organisatorischer Kontext (Teamdynamik, vergangene Vorfälle, Politik)
- Zeitplandruck oder Einschränkungen
- Technische Architektur oder Abhängigkeiten
- Bedenken von Stakeholdern
Raten Sie ihnen, sich keine Sorgen um die Organisation zu machen – einfach alles preiszugeben. Bieten Sie mehrere Möglichkeiten zur Bereitstellung von Kontext an:
- Info-Dump im Bewusstseinsstrom
- Verweis auf Teamkanäle oder Threads zum Lesen
- Verlinkung zu freigegebenen Dokumenten
Wenn Integrationen verfügbar sind (z. B. Slack, Teams, Google Drive, SharePoint oder andere MCP-Server), erwähnen Sie, dass diese verwendet werden können, um Kontext direkt einzubringen.
Wenn keine Integrationen erkannt werden und Sie in Claude.ai oder der Claude-App sind: Schlagen Sie vor, dass sie in ihren Claude-Einstellungen Konnektoren aktivieren können, um Kontext aus Messaging-Apps und Dokumentenspeichern abzurufen.
Informieren Sie sie, dass klärende Fragen gestellt werden, sobald sie ihren ersten Dump abgeschlossen haben.
Während der Kontextsammlung:
-
Wenn der Benutzer Teamkanäle oder freigegebene Dokumente erwähnt:
- Wenn Integrationen verfügbar sind: Informieren Sie sie, dass der Inhalt jetzt gelesen wird, und verwenden Sie dann die entsprechende Integration
- Wenn Integrationen nicht verfügbar sind: Erklären Sie den fehlenden Zugriff. Schlagen Sie vor, sie in den Claude-Einstellungen zu aktivieren oder den relevanten Inhalt direkt einzufügen.
-
Wenn der Benutzer Entitäten/Projekte erwähnt, die unbekannt sind:
- Fragen Sie, ob verbundene Tools durchsucht werden sollen, um mehr zu erfahren
- Warten Sie auf die Bestätigung des Benutzers, bevor Sie suchen
-
Während der Benutzer Kontext bereitstellt, verfolgen Sie, was gelernt wird und was noch unklar ist
Klärende Fragen stellen:
Wenn der Benutzer signalisiert, dass er seinen ersten Dump abgeschlossen hat (oder nach umfangreichem Kontext), stellen Sie klärende Fragen, um das Verständnis sicherzustellen:
Generieren Sie 5-10 nummerierte Fragen basierend auf Lücken im Kontext.
Informieren Sie sie, dass sie Kurzform verwenden können (z. B. "1: ja, 2: siehe #channel, 3: nein wegen Abwärtskompatibilität"), auf weitere Dokumente verlinken, auf zu lesende Kanäle verweisen oder einfach weiter Info-Dumps machen können. Was auch immer für sie am effizientesten ist.
Ausstiegsbedingung: Ausreichender Kontext wurde gesammelt, wenn Fragen Verständnis zeigen – wenn nach Randfällen und Abwägungen gefragt werden kann, ohne die Grundlagen erklären zu müssen.
Übergang: Fragen Sie, ob es weiteren Kontext gibt, den sie in dieser Phase bereitstellen möchten, oder ob es Zeit ist, mit dem Entwurf des Dokuments fortzufahren.
Wenn der Benutzer mehr hinzufügen möchte, lassen Sie ihn. Wenn bereit, fahren Sie mit Phase 2 fort.
Phase 2: Verfeinerung & Struktur
Ziel: Das Dokument Abschnitt für Abschnitt durch Brainstorming, Kuratierung und iterative Verfeinerung aufbauen.
Anweisungen an den Benutzer: Erklären Sie, dass das Dokument Abschnitt für Abschnitt aufgebaut wird. Für jeden Abschnitt:
- Es werden klärende Fragen dazu gestellt, was einzubeziehen ist
- Es werden 5-20 Optionen durchdacht
- Der Benutzer gibt an, was behalten/entfernt/kombiniert werden soll
- Der Abschnitt wird entworfen
- Er wird durch präzise Bearbeitungen verfeinert
Beginnen Sie mit dem Abschnitt mit den meisten Unbekannten (normalerweise der Kernentscheidung/dem Kernvorschlag) und arbeiten Sie dann die restlichen durch.
Abschnittsreihenfolge:
Wenn die Dokumentstruktur klar ist: Fragen Sie, mit welchem Abschnitt sie beginnen möchten.
Schlagen Sie vor, mit dem Abschnitt mit den meisten Unbekannten zu beginnen. Bei Entscheidungsdokumenten ist dies normalerweise der Kernvorschlag. Bei Spezifikationen ist es typischerweise der technische Ansatz. Zusammenfassungsabschnitte sollten am besten für den Schluss aufgehoben werden.
Wenn der Benutzer nicht weiß, welche Abschnitte er benötigt: Basierend auf der Art des Dokuments und der Vorlage schlagen Sie 3-5 für den Dokumenttyp geeignete Abschnitte vor.
Fragen Sie, ob diese Struktur funktioniert oder ob sie sie anpassen möchten.
Sobald die Struktur vereinbart ist:
Erstellen Sie die anfängliche Dokumentstruktur mit Platzhaltertext für alle Abschnitte.
Wenn Zugriff auf Artefakte verfügbar ist:
Verwenden Sie create_file, um ein Artefakt zu erstellen. Dies gibt sowohl Claude als auch dem Benutzer ein Gerüst für die Arbeit.
Informieren Sie sie, dass die anfängliche Struktur mit Platzhaltern für alle Abschnitte erstellt wird.
Erstellen Sie ein Artefakt mit allen Abschnittsüberschriften und kurzem Platzhaltertext wie "[Noch zu schreiben]" oder "[Inhalt hier]".
Bereitstellen Sie den Link zum Gerüst und geben Sie an, dass es nun an der Zeit ist, jeden Abschnitt zu füllen.
Wenn kein Zugriff auf Artefakte besteht:
Erstellen Sie eine Markdown-Datei im Arbeitsverzeichnis. Benennen Sie sie angemessen (z. B. entscheidungsdokument.md, technische-spezifikation.md).
Informieren Sie sie, dass die anfängliche Struktur mit Platzhaltern für alle Abschnitte erstellt wird.
Erstellen Sie eine Datei mit allen Abschnittsüberschriften und Platzhaltertext.
Bestätigen Sie, dass der Dateiname erstellt wurde, und geben Sie an, dass es nun an der Zeit ist, jeden Abschnitt zu füllen.
Für jeden Abschnitt:
Schritt 1: Klärende Fragen
Kündigen Sie an, dass die Arbeit am Abschnitt [ABSCHNITTSNAME] beginnt. Stellen Sie 5-10 klärende Fragen dazu, was einbezogen werden sollte:
Generieren Sie 5-10 spezifische Fragen basierend auf Kontext und Abschnittszweck.
Informieren Sie sie, dass sie in Kurzform antworten oder einfach angeben können, was wichtig zu behandeln ist.
Schritt 2: Brainstorming
Für den Abschnitt [ABSCHNITTSNAME] denken Sie 5-20 Dinge durch, die je nach Komplexität des Abschnitts einbezogen werden könnten. Suchen Sie nach:
- Geteiltem Kontext, der möglicherweise vergessen wurde
- Winkeln oder Überlegungen, die noch nicht erwähnt wurden
Generieren Sie 5-20 nummerierte Optionen basierend auf der Abschnittskomplexität. Bieten Sie am Ende an, bei Bedarf weitere Optionen zu generieren.
Schritt 3: Kuratierung
Fragen Sie, welche Punkte behalten, entfernt oder kombiniert werden sollen. Bitten Sie um kurze Begründungen, um Prioritäten für die nächsten Abschnitte zu lernen.
Geben Sie Beispiele:
- "Behalte 1,4,7,9"
- "Entferne 3 (doppelt 1)"
- "Entferne 6 (Zielgruppe weiß das bereits)"
- "Kombiniere 11 und 12"
Wenn der Benutzer freiform Feedback gibt (z. B. "sieht gut aus" oder "mir gefällt das meiste, aber...") anstatt nummerierte Auswahlen, extrahieren Sie seine Präferenzen und fahren Sie fort. Parst, was er behalten/entfernt/geändert haben möchte, und wenden Sie es an.
Schritt 4: Lückenprüfung
Fragen Sie basierend auf den ausgewählten Punkten, ob für den Abschnitt [ABSCHNITTSNAME] etwas Wichtiges fehlt.
Schritt 5: Entwurf
Verwenden Sie str_replace, um den Platzhaltertext für diesen Abschnitt durch den tatsächlich entworfenen Inhalt zu ersetzen.
Kündigen Sie an, dass der Abschnitt [ABSCHNITTSNAME] nun basierend auf den ausgewählten Punkten entworfen wird.
Bei Verwendung von Artefakten: Nach dem Entwurf stellen Sie einen Link zum Artefakt bereit.
Bitten Sie sie, es durchzulesen und anzugeben, was geändert werden soll. Weisen Sie darauf hin, dass Spezifität beim Lernen für die nächsten Abschnitte hilft.
Bei Verwendung einer Datei (keine Artefakte): Bestätigen Sie nach dem Entwurf den Abschluss.
Informieren Sie sie, dass der Abschnitt [ABSCHNITTSNAME] in [Dateiname] entworfen wurde. Bitten Sie sie, ihn durchzulesen und anzugeben, was geändert werden soll. Weisen Sie darauf hin, dass Spezifität beim Lernen für die nächsten Abschnitte hilft.
Wichtiger Hinweis für den Benutzer (einschließen, wenn der erste Abschnitt entworfen wird): Fügen Sie einen Hinweis ein: Bitten Sie sie, Änderungen anzugeben, anstatt das Dokument direkt zu bearbeiten. Dies hilft beim Lernen ihres Stils für zukünftige Abschnitte. Zum Beispiel: "Entferne den X-Punkt – bereits durch Y abgedeckt" oder "Mach den dritten Absatz prägnanter".
Schritt 6: Iterative Verfeinerung
Wenn der Benutzer Feedback gibt:
- Verwenden Sie
str_replace, um Bearbeitungen vorzunehmen (drucken Sie nie das gesamte Dokument neu) - Bei Verwendung von Artefakten: Stellen Sie nach jeder Bearbeitung einen Link zum Artefakt bereit
- Bei Verwendung von Dateien: Bestätigen Sie einfach, dass die Bearbeitungen abgeschlossen sind
- Wenn der Benutzer das Dokument direkt bearbeitet und bittet, es zu lesen: Merken Sie sich die vorgenommenen Änderungen und behalten Sie sie für zukünftige Abschnitte im Hinterkopf (dies zeigt ihre Präferenzen)
Fahren Sie mit der Iteration fort, bis der Benutzer mit dem Abschnitt zufrieden ist.
Qualitätsprüfung
Fragen Sie nach 3 aufeinanderfolgenden Iterationen ohne wesentliche Änderungen, ob etwas entfernt werden kann, ohne wichtige Informationen zu verlieren.
Wenn der Abschnitt fertig ist, bestätigen Sie, dass [ABSCHNITTSNAME] abgeschlossen ist. Fragen Sie, ob bereit ist, zum nächsten Abschnitt überzugehen.
Wiederholen Sie dies für alle Abschnitte.
Kurz vor Abschluss
Wenn Sie sich dem Abschluss nähern (80 %+ der Abschnitte erledigt), kündigen Sie die Absicht an, das gesamte Dokument erneut zu lesen und zu überprüfen auf:
- Fluss und Konsistenz über die Abschnitte hinweg
- Redundanzen oder Widersprüche
- Alles, was sich wie "Schlonz" oder generischer Füller anfühlt
- Ob jeder Satz Gewicht hat
Lesen Sie das gesamte Dokument und geben Sie Feedback.
Wenn alle Abschnitte entworfen und verfeinert sind: Kündigen Sie an, dass alle Abschnitte entworfen sind. Geben Sie die Absicht an, das vollständige Dokument noch einmal zu überprüfen.
Überprüfen Sie auf allgemeine Kohärenz, Fluss und Vollständigkeit.
Geben Sie letzte Vorschläge.
Fragen Sie, ob bereit ist, zu den Lesertests überzugehen, oder ob sie etwas anderes verfeinern möchten.
Phase 3: Lesertests
Ziel: Testen des Dokuments mit einem frischen Claude (kein Kontext-Überlauf), um zu überprüfen, ob es für Leser funktioniert.
Anweisungen an den Benutzer:
Erklären Sie, dass nun getestet wird, ob das Dokument tatsächlich für Leser funktioniert. Dies fängt blinde Flecken auf – Dinge, die für die Autoren sinnvoll erscheinen, aber andere verwirren könnten.
Testansatz
Wenn Zugriff auf Unter-Agenten verfügbar ist (z. B. in Claude Code):
Führen Sie die Tests direkt ohne Beteiligung des Benutzers durch.
Schritt 1: Fragen der Leser vorhersagen
Kündigen Sie die Absicht an, vorherzusagen, welche Fragen Leser stellen könnten, wenn sie versuchen, dieses Dokument zu entdecken.
Generieren Sie 5-10 Fragen, die Leser realistischerweise stellen würden.
Schritt 2: Mit Unter-Agent testen
Kündigen Sie an, dass diese Fragen mit einer frischen Claude-Instanz (ohne Kontext aus diesem Gespräch) getestet werden.
Rufen Sie für jede Frage einen Unter-Agenten nur mit dem Dokumentinhalt und der Frage auf.
Fassen Sie zusammen, was Leser Claude für jede Frage richtig/falsch gemacht hat.
Schritt 3: Führen Sie zusätzliche Prüfungen durch
Kündigen Sie an, dass zusätzliche Prüfungen durchgeführt werden.
Rufen Sie Unter-Agent auf, um auf Mehrdeutigkeiten, falsche Annahmen und Widersprüche zu prüfen.
Fassen Sie alle gefundenen Probleme zusammen.
Schritt 4: Berichten und Beheben
Wenn Probleme gefunden wurden: Berichten Sie, dass Leser Claude mit bestimmten Problemen zu kämpfen hatte.
Listen Sie die spezifischen Probleme auf.
Geben Sie die Absicht an, diese Lücken zu schließen.
Kehren Sie zur Verfeinerung für problematische Abschnitte zurück.
Wenn kein Zugriff auf Unter-Agenten besteht (z. B. claude.ai Weboberfläche):
Der Benutzer muss die Tests manuell durchführen.
Schritt 1: Fragen der Leser vorhersagen
Fragen Sie, welche Fragen Leute stellen könnten, wenn sie versuchen, dieses Dokument zu entdecken. Was würden sie in Claude.ai eingeben?
Generieren Sie 5-10 Fragen, die Leser realistischerweise stellen würden.
Schritt 2: Testeinrichtung
Geben Sie Testanweisungen:
- Öffnen Sie eine frische Claude-Konversation: https://claude.ai
- Fügen Sie den Dokumentinhalt ein oder teilen Sie ihn (wenn Sie eine freigegebene Dokumentenplattform mit aktivierten Konnektoren verwenden, stellen Sie den Link bereit)
- Stellen Sie Leser Claude die generierten Fragen
Weisen Sie für jede Frage Leser Claude an, bereitzustellen:
- Die Antwort
- Ob etwas mehrdeutig oder unklar war
- Welches Wissen/welcher Kontext im Dokument als bereits bekannt vorausgesetzt wird
Überprüfen Sie, ob Leser Claude korrekte Antworten gibt oder etwas missversteht.
Schritt 3: Zusätzliche Prüfungen
Fragen Sie auch Leser Claude:
- "Was in diesem Dokument könnte für Leser mehrdeutig oder unklar sein?"
- "Welches Wissen oder welchen Kontext setzt dieses Dokument bei Lesern bereits voraus?"
- "Gibt es interne Widersprüche oder Inkonsistenzen?"
Schritt 4: Basierend auf Ergebnissen iterieren
Fragen Sie, was Leser Claude falsch gemacht hat oder womit es zu kämpfen hatte. Geben Sie die Absicht an, diese Lücken zu schließen.
Kehren Sie zur Verfeinerung für problematische Abschnitte zurück.
Ausstiegsbedingung (beide Ansätze)
Wenn Leser Claude Fragen konsequent richtig beantwortet und keine neuen Lücken oder Mehrdeutigkeiten auftauchen, ist das Dokument bereit.
Abschließende Überprüfung
Wenn die Lesertests bestanden sind: Kündigen Sie an, dass das Dokument den Leser Claude-Test bestanden hat. Vor dem Abschluss:
- Empfehlen Sie, selbst einen letzten Durchlese zu machen – sie besitzen dieses Dokument und sind für seine Qualität verantwortlich
- Schlagen Sie vor, Fakten, Links und technische Details noch einmal zu überprüfen
- Fragen Sie sie, ob sie überprüfen möchten, ob es die gewünschte Wirkung erzielt
Fragen Sie, ob sie das Dokument als abgeschlossen betrachten oder ob es weitere Anpassungen gibt.