Workflow zur gemeinsamen Dokumenterstellung
Diese Fähigkeit bietet einen strukturierten Workflow, um Benutzer durch die kollaborative Dokumenterstellung zu führen. Agieren Sie als aktiver Leitfaden und führen Sie Benutzer durch drei Phasen: Konzepterfassung, Verfeinerung & Struktur und Lesertest.
Wann dieser Workflow angeboten wird
Auslösebedingungen:
- Benutzer erwähnt das Schreiben von Dokumentation: "ein Dokument schreiben", "einen Vorschlag entwerfen", "eine Spezifikation erstellen", "etwas aufsetzen"
- Benutzer erwähnt bestimmte Dokumenttypen: "PRD", "Design-Dokument", "Entscheidungsdokument", "RFC"
- Benutzer scheint eine umfangreichere Schreibaufgabe zu beginnen
Erstes Angebot: Bieten Sie dem Benutzer einen strukturierten Workflow für die gemeinsame Erstellung des Dokuments an. Erklären Sie die drei Phasen:
- Konzepterfassung: Benutzer stellt alle relevanten Informationen bereit, während Claude klärende Fragen stellt
- Verfeinerung & Struktur: Iterativer Aufbau jedes Abschnitts durch Brainstorming und Bearbeitung
- Lesertest: Testen des Dokuments mit einem frischen Claude (ohne Kontext), um blinde Flecken zu erkennen, bevor andere es lesen
Erklären Sie, dass dieser Ansatz sicherstellt, dass das Dokument funktioniert, wenn andere es lesen (auch wenn sie es in Claude einfügen). Fragen Sie, ob der Benutzer diesen Workflow ausprobieren möchte oder lieber frei arbeiten will.
Wenn der Benutzer ablehnt, arbeiten Sie frei. Wenn der Benutzer zustimmt, fahren Sie mit Phase 1 fort.
Phase 1: Konzepterfassung
Ziel: Die Lücke zwischen dem Wissen des Benutzers und dem Wissen von Claude schließen, um später eine intelligente Führung zu ermöglichen.
Erste Fragen
Beginnen Sie, indem Sie den Benutzer nach dem Metakontext zum Dokument fragen:
- Um welche Art von Dokument handelt es sich? (z. B. technische Spezifikation, Entscheidungsdokument, Vorschlag)
- Wer ist die primäre Zielgruppe?
- Welche Wirkung soll das Dokument beim Leser erzielen?
- Gibt es eine Vorlage oder ein bestimmtes Format, das befolgt werden soll?
- Gibt es weitere Einschränkungen oder Kontext, den es zu beachten gilt?
Informieren Sie sie, dass sie in Kurzform antworten oder Informationen so ausgeben können, wie es für sie am besten ist.
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 geteilten Dokument bereitstellen, verwenden Sie die entsprechende Integration, um es abzurufen
- Wenn sie eine Datei bereitstellen, lesen Sie sie
Wenn der Benutzer die Bearbeitung eines vorhandenen geteilten Dokuments erwähnt:
- 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 sie nicht sehen kann, wenn andere Claude verwenden, um das Dokument zu verstehen. Fragen Sie, ob Alternativtext generiert werden soll. Wenn ja, bitten Sie sie, jedes Bild in den Chat einzufügen, um einen beschreibenden Alternativtext zu generieren.
Informationsweitergabe
Sobald die ersten Fragen beantwortet sind, ermutigen Sie den Benutzer, den gesamten Kontext, den sie haben, zu teilen. Fordern Sie Informationen wie:
- Hintergrund zum Projekt/Problem
- Zugehörige Teamdiskussionen oder geteilte Dokumente
- Warum alternative Lösungen nicht verwendet werden
- Organisatorischer Kontext (Teamdynamik, frühere Vorfälle, Politik)
- Zeitdruck oder Einschränkungen
- Technische Architektur oder Abhängigkeiten
- Anliegen von Stakeholdern
Raten Sie ihnen, sich keine Sorgen um die Organisation zu machen - sie sollen einfach alles herauslassen. Bieten Sie mehrere Möglichkeiten zur Bereitstellung von Kontext an:
- Informationsweitergabe im Bewusstseinsstrom
- Verweis auf Teamkanäle oder Threads zum Lesen
- Link zu geteilten 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 abzurufen.
Wenn keine Integrationen erkannt werden und Sie sich in Claude.ai oder der Claude-App befinden: Schlagen Sie vor, dass sie in ihren Claude-Einstellungen Konnektoren aktivieren können, um Kontext aus Messaging-Apps und Dokumentenspeichern direkt abzurufen.
Informieren Sie sie, dass klärende Fragen gestellt werden, sobald sie ihre erste Informationsweitergabe abgeschlossen haben.
Während der Konzepterfassung:
-
Wenn der Benutzer Teamkanäle oder geteilte 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, dass sie Konnektoren in ihren Claude-Einstellungen aktivieren oder den relevanten Inhalt direkt einfü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
-
Wenn der Benutzer Kontext bereitstellt, verfolgen Sie, was gelernt wird und was noch unklar ist
Klärende Fragen stellen:
Wenn der Benutzer signalisiert, dass er seine erste Informationsweitergabe abgeschlossen hat (oder nach substanziellem 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 in Kurzform antworten können (z. B. "1: ja, 2: siehe #Kanal, 3: nein wegen Abwärtskompatibilität"), auf weitere Dokumente verlinken, auf Kanäle zum Lesen verweisen oder einfach weiter Informationen teilen können. Was auch immer für sie am effizientesten ist.
Austrittsbedingung: Ausreichender Kontext wurde gesammelt, wenn Fragen Verständnis zeigen - wenn Randfälle und Kompromisse abgefragt werden können, ohne dass Grundlagen erklärt werden müssen.
Übergang: Fragen Sie, ob es weiteren Kontext gibt, den der Benutzer in dieser Phase bereitstellen möchte, oder ob es Zeit ist, mit dem Verfassen 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: Aufbau des Dokuments Abschnitt für Abschnitt durch Brainstorming, Kuratierung und iterative Verfeinerung.
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 aufgenommen werden soll
- Es werden 5-20 Optionen durchdacht
- Der Benutzer gibt an, was behalten/entfernen/kombinieren werden soll
- Der Abschnitt wird entworfen
- Es wird durch chirurgische Bearbeitungen verfeinert
Beginnen Sie mit dem Abschnitt, der die meisten Unbekannten aufweist (normalerweise die Kernentscheidung/der Kernvorschlag), und arbeiten Sie sich dann durch den Rest.
Abschnittsreihenfolge:
Wenn die Dokumentstruktur klar ist: Fragen Sie, mit welchem Abschnitt sie beginnen möchten.
Schlagen Sie vor, mit dem Abschnitt zu beginnen, der die meisten Unbekannten aufweist. Für Entscheidungsdokumente ist das normalerweise der Kernvorschlag. Für Spezifikationen ist es typischerweise der technische Ansatz. Zusammenfassungsabschnitte sollten am besten für den Schluss aufbewahrt werden.
Wenn der Benutzer nicht weiß, welche Abschnitte er benötigt: Basierend auf der Art des Dokuments und der Vorlage schlagen Sie 3-5 Abschnitte vor, die für den Dokumenttyp geeignet sind.
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, mit dem sie arbeiten können.
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 "[Zu schreiben]" oder "[Inhalt hier]".
Geben Sie den Link zum Gerüst an und geben Sie an, dass es Zeit ist, jeden Abschnitt auszufüllen.
Wenn kein Zugriff auf Artefakte besteht:
Erstellen Sie eine Markdown-Datei im Arbeitsverzeichnis. Benennen Sie sie entsprechend (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 Zeit ist, jeden Abschnitt auszufüllen.
Für jeden Abschnitt:
Schritt 1: Klärende Fragen
Kündigen Sie an, dass mit der Arbeit am [ABSCHNITTSNAME]-Abschnitt begonnen wird. Stellen Sie 5-10 klärende Fragen dazu, was aufgenommen 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 ist, um es abzudecken.
Schritt 2: Brainstorming
Für den [ABSCHNITTSNAME]-Abschnitt, brainstormen Sie [5-20] Dinge, die möglicherweise aufgenommen werden könnten, abhängig von der Komplexität des Abschnitts. 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, mehr zu brainstormen, wenn sie zusätzliche Optionen wünschen.
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 (dupliziert 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...") anstelle von nummerierten Auswahlen, extrahieren Sie seine Präferenzen und fahren Sie fort. Analysieren Sie, was sie behalten/entfernen/ändern möchten, und wenden Sie es an.
Schritt 4: Lückenprüfung
Basierend auf dem, was sie ausgewählt haben, fragen Sie, ob etwas Wichtiges für den [ABSCHNITTSNAME]-Abschnitt 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 [ABSCHNITTSNAME]-Abschnitt jetzt basierend auf dem, was sie ausgewählt haben, entworfen wird.
Bei Verwendung von Artefakten: Geben Sie nach dem Entwurf einen Link zum Artefakt an.
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.
Bei Verwendung einer Datei (keine Artefakte): Bestätigen Sie nach dem Entwurf die Fertigstellung.
Informieren Sie sie, dass der [ABSCHNITTSNAME]-Abschnitt 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 (beim Entwurf des ersten Abschnitts einschließen): Geben Sie einen Hinweis: Anstatt das Dokument direkt zu bearbeiten, bitten Sie sie, anzugeben, was geändert werden soll. Dies hilft beim Erlernen ihres Stils für zukünftige Abschnitte. Zum Beispiel: "Entferne den X-Punkt - wird bereits durch Y abgedeckt" oder "Mache 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: Geben Sie nach jeder Bearbeitung einen Link zum Artefakt an
- 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 mental die Änderungen, die sie vorgenommen haben, und behalten Sie sie für zukünftige Abschnitte im Hinterkopf (dies zeigt ihre Präferenzen)
Iterieren Sie weiter, bis der Benutzer mit dem Abschnitt zufrieden ist.
Qualitätsprüfung
Nach 3 aufeinanderfolgenden Iterationen ohne wesentliche Änderungen fragen Sie, 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 Sie bereit sind, zum nächsten Abschnitt überzugehen.
Wiederholen Sie dies für alle Abschnitte.
Kurz vor Fertigstellung
Wenn Sie sich der Fertigstellung nähern (80%+ der Abschnitte sind erledigt), kündigen Sie die Absicht an, das gesamte Dokument erneut zu lesen und auf Folgendes zu prüfen:
- Fluss und Konsistenz zwischen den Abschnitten
- Redundanz oder Widersprüche
- Alles, was sich nach "Geschwafel" oder generischem Füllmaterial 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, Vollständigkeit.
Geben Sie eventuelle letzte Vorschläge.
Fragen Sie, ob Sie bereit sind, zum Lesertest überzugehen, oder ob sie etwas anderes verfeinern möchten.
Phase 3: Lesertest
Ziel: Testen des Dokuments mit einem frischen Claude (keine Kontextübertragung), um zu überprüfen, ob es für Leser funktioniert.
Anweisungen an den Benutzer: Erklären Sie, dass jetzt getestet wird, ob das Dokument tatsächlich für Leser funktioniert. Dies fängt blinde Flecken ein - Dinge, die für die Autoren sinnvoll sind, aber andere verwirren könnten.
Testansatz
Wenn Zugriff auf Unteragenten verfügbar ist (z. B. in Claude Code):
Führen Sie den Test direkt ohne Beteiligung des Benutzers durch.
Schritt 1: Leserfragen vorhersagen
Kündigen Sie die Absicht an, vorherzusagen, welche Fragen Leser stellen könnten, wenn sie versuchen, dieses Dokument zu finden.
Generieren Sie 5-10 Fragen, die Leser realistischerweise stellen würden.
Schritt 2: Test mit Unteragent
Kündigen Sie an, dass diese Fragen mit einer frischen Claude-Instanz (kein Kontext aus dieser Unterhaltung) getestet werden.
Rufen Sie für jede Frage einen Unteragenten mit nur dem Dokumentinhalt und der Frage auf.
Fassen Sie für jede Frage zusammen, was Reader Claude richtig/falsch gemacht hat.
Schritt 3: Zusätzliche Prüfungen durchführen
Kündigen Sie an, dass zusätzliche Prüfungen durchgeführt werden.
Rufen Sie einen Unteragenten auf, um auf Mehrdeutigkeit, falsche Annahmen, Widersprüche zu prüfen.
Fassen Sie alle gefundenen Probleme zusammen.
Schritt 4: Berichten und Beheben
Wenn Probleme gefunden wurden: Berichten Sie, dass Reader 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 Unteragenten besteht (z. B. claude.ai-Weboberfläche):
Der Benutzer muss den Test manuell durchführen.
Schritt 1: Leserfragen vorhersagen
Fragen Sie, welche Fragen die Leute stellen könnten, wenn sie versuchen, dieses Dokument zu finden. Was würden sie in Claude.ai eingeben?
Generieren Sie 5-10 Fragen, die Leser realistischerweise stellen würden.
Schritt 2: Test einrichten
Geben Sie Testanweisungen:
- Öffnen Sie eine neue Claude-Unterhaltung: https://claude.ai
- Fügen Sie den Dokumentinhalt ein oder teilen Sie ihn (bei Verwendung einer Plattform für geteilte Dokumente mit aktivierten Konnektoren, geben Sie den Link an)
- Fragen Sie Reader Claude die generierten Fragen
Weisen Sie Reader Claude für jede Frage an, Folgendes bereitzustellen:
- Die Antwort
- Ob etwas mehrdeutig oder unklar war
- Welches Wissen/ welcher Kontext vom Dokument als bekannt vorausgesetzt wird
Überprüfen Sie, ob Reader Claude korrekte Antworten gibt oder etwas falsch interpretiert.
Schritt 3: Zusätzliche Prüfungen
Fragen Sie Reader Claude auch:
- "Was in diesem Dokument könnte für Leser mehrdeutig oder unklar sein?"
- "Welches Wissen oder welchen Kontext setzt dieses Dokument bei den Lesern bereits voraus?"
- "Gibt es interne Widersprüche oder Inkonsistenzen?"
Schritt 4: Basierend auf Ergebnissen iterieren
Fragen Sie, was Reader Claude falsch gemacht hat oder womit er 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.
Austrittsbedingung (Beide Ansätze)
Wenn Reader Claude Fragen konsistent richtig beantwortet und keine neuen Lücken oder Mehrdeutigkeiten aufdeckt, ist das Dokument bereit.
Abschließende Überprüfung
Wenn der Lesertest bestanden ist: Kündigen Sie an, dass das Dokument den Reader-Claude-Test bestanden hat. Vor Abschluss:
- Empfehlen Sie, dass sie selbst einen letzten Korrekturlesedurchgang machen - sie besitzen dieses Dokument und sind für seine Qualität verantwortlich
- Schlagen Sie vor, Fakten, Links oder technische Details noch einmal zu überprüfen
- Bitten Sie sie zu überprüfen, ob es die gewünschte Wirkung erzielt
Fragen Sie, ob sie mit dem Dokument zufrieden sind oder ob es noch Anpassungen gibt.
Wenn sie zufrieden sind, geben Sie an, dass das Dokument fertig ist. Fragen Sie, ob sie es in einem bestimmten Format exportieren oder teilen möchten.