Mitverfassen von Dokumenten

Quelle: Inhalt angepasst von Anthropics/Skills (MIT).

Diese Fertigkeit bietet einen strukturierten Arbeitsablauf, der Benutzer durch die gemeinsame Dokumentenerstellung führt. Fungieren Sie als aktiver Leitfaden und führen Sie Benutzer durch drei Phasen: Kontexterfassung, Verfeinerung und Struktur sowie Lesertests.

Wann sollte dieser Workflow angeboten werden?

Auslösebedingungen:

• Der Benutzer erwähnt das Schreiben von Dokumentationen: „ein Dokument schreiben“, „einen Vorschlag entwerfen“, „eine Spezifikation erstellen“, „aufschreiben“
• Der Benutzer erwähnt bestimmte Dokumenttypen: „PRD“, „Designdokument“, „Entscheidungsdokument“, „RFC“.
• Der Benutzer scheint mit einer umfangreichen Schreibaufgabe zu beginnen

Erstes Angebot: Bieten Sie dem Benutzer einen strukturierten Workflow für die gemeinsame Erstellung des Dokuments. Erklären Sie die drei Phasen:

1. Kontexterfassung: Der Benutzer stellt den gesamten relevanten Kontext bereit, während Claude klärende Fragen stellt
2. Verfeinerung und Struktur: Bauen Sie jeden Abschnitt durch Brainstorming und Bearbeitung iterativ auf
3. Lesertest: Testen Sie das Dokument mit einem neuen Claude (ohne Kontext), um blinde Flecken zu erkennen, bevor andere es lesen

Erklären Sie, dass dieser Ansatz dazu beiträgt, dass das Dokument gut funktioniert, wenn andere es lesen (auch wenn sie es in Claude einfügen). Fragen Sie, ob sie diesen Arbeitsablauf ausprobieren möchten oder lieber in freier Form arbeiten möchten.

Wenn der Benutzer ablehnt, arbeiten Sie frei. Wenn der Benutzer zustimmt, fahren Sie mit Schritt 1 fort.

Stufe 1: Kontexterfassung

Ziel: Schließen Sie die Lücke zwischen dem, was der Benutzer weiß, und dem, was Claude weiß, und ermöglichen Sie später eine intelligente Führung.

Erste Fragen

Bitten Sie den Benutzer zunächst um Metakontext zum Dokument:

1. Um welche Art von Dokument handelt es sich? (z. B. technische Spezifikation, Entscheidungsdokument, Vorschlag)
2. Wer ist die primäre Zielgruppe?
3. Was ist die gewünschte Wirkung, wenn jemand dies liest?
4. Gibt es eine Vorlage oder ein bestimmtes Format, dem man folgen kann?
5. Gibt es weitere Einschränkungen oder Kontexte, die Sie kennen sollten?

Sagen Sie ihnen, dass sie in Kurzschrift antworten oder Informationen abgeben können, je nachdem, was für sie am besten ist.

Wenn der Benutzer eine Vorlage bereitstellt oder einen Dokumenttyp erwähnt:

• Fragen Sie, ob sie ein Vorlagendokument zum Teilen haben
• Wenn sie einen Link zu einem freigegebenen 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 freigegebenen Dokuments erwähnt:

• Verwenden Sie die entsprechende Integration, um den aktuellen Status auszulesen
• Suchen Sie nach Bildern 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 Alt-Text generiert werden soll. Wenn ja, fordern Sie sie auf, jedes Bild in den Chat einzufügen, um beschreibenden Alternativtext zu generieren.

Info-Dumping

Sobald die ersten Fragen beantwortet sind, ermutigen Sie den Benutzer, den gesamten Kontext, den er hat, wegzuwerfen. Fordern Sie Informationen an wie:

• Hintergrund zum Projekt/Problem
• Verwandte Teamdiskussionen oder gemeinsame Dokumente
• Warum alternative Lösungen nicht genutzt werden
• Organisatorischer Kontext (Teamdynamik, vergangene Vorfälle, Politik)
• Zeitdruck oder Einschränkungen
• Technische Architektur oder Abhängigkeiten
• Bedenken der Stakeholder

Raten Sie ihnen, sich keine Gedanken über die Organisation zu machen, sondern einfach alles rauszuholen. Bieten Sie mehrere Möglichkeiten zur Bereitstellung von Kontext:

• Info-Dump-Bewusstseinsstrom
• Zeigen Sie auf Teamkanäle oder Threads, die Sie lesen möchten
• Link zu freigegebenen Dokumenten

Wenn Integrationen verfügbar sind (z. B. Slack, Teams, Google Drive, SharePoint oder andere MCP-Server), erwähnen Sie, dass diese zum direkten Einbinden von Kontext verwendet werden können.

Wenn keine Integrationen erkannt werden und in Claude.ai oder der Claude-App: Schlagen Sie vor, dass sie Connectors in ihren Claude-Einstellungen aktivieren können, um das direkte Abrufen von Kontext aus Messaging-Apps und der Dokumentenspeicherung zu ermöglichen.

Informieren Sie sie darüber, dass nach Abschluss des ersten Dumps klärende Fragen gestellt werden.

Während der Kontexterfassung:

• Wenn der Benutzer Teamkanäle oder freigegebene Dokumente erwähnt:

  • Wenn Integrationen verfügbar sind: Teilen Sie ihnen mit, 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, Connectors in den Claude-Einstellungen zu aktivieren oder den relevanten Inhalt direkt einzufügen.

• Wenn der Benutzer unbekannte Entitäten/Projekte erwähnt:

  • Fragen Sie, ob nach vernetzten Werkzeugen gesucht werden soll, um mehr zu erfahren
  • Warten Sie vor der Suche auf die Bestätigung des Benutzers

• Während der Benutzer Kontext bereitstellt, können Sie verfolgen, was gelernt wird und was noch unklar ist

Klärende Fragen stellen:

Wenn der Benutzer signalisiert, dass er seinen ersten Speicherauszug erstellt hat (oder nachdem ein wesentlicher Kontext bereitgestellt wurde), 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 Kurzschrift verwenden können, um zu antworten (z. B. „1: Ja, 2: siehe #Kanal, 3: Nein, weil abwärtskompatibel“), auf weitere Dokumente verlinken, auf zu lesende Kanäle verweisen oder einfach weiter Informationen ausgeben können. Was auch immer für sie am effizientesten ist.

Exit-Bedingung: Es wurde ausreichend Kontext gesammelt, wenn Fragen Verständnis zeigen – wenn Randfälle und Kompromisse erfragt werden können, ohne dass die Grundlagen erklärt werden müssen.

Übergang: Fragen Sie, ob es zu diesem Zeitpunkt noch weiteren Kontext gibt oder ob es an der Zeit ist, mit dem Entwurf des Dokuments fortzufahren.

Wenn der Benutzer weitere hinzufügen möchte, lassen Sie ihn. Wenn Sie fertig sind, fahren Sie mit Schritt 2 fort.

Stufe 2: Verfeinerung und Struktur

Ziel: Erstellen Sie das Dokument Abschnitt für Abschnitt durch Brainstorming, Kuratierung und iterative Verfeinerung.

Anweisungen für den Benutzer: Erklären Sie, dass das Dokument Abschnitt für Abschnitt erstellt wird. Für jeden Abschnitt:

1. Es werden klärende Fragen gestellt, was aufgenommen werden soll
2. Es werden 5–20 Optionen erarbeitet
3. Der Benutzer gibt an, was behalten/entfernen/kombinieren soll
4. Der Abschnitt wird ausgearbeitet
5. Es wird durch chirurgische Bearbeitungen verfeinert

Beginnen Sie mit dem Abschnitt mit den meisten Unbekannten (normalerweise der Kernentscheidung/-vorschlag) und arbeiten Sie dann den Rest durch.

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 enthält. Bei Entscheidungsdokumenten ist dies normalerweise der Kernvorschlag. Bei Spezifikationen handelt es sich in der Regel um den technischen Ansatz. Zusammenfassungsabschnitte bleiben am besten für den Schluss.

Wenn der Benutzer nicht weiß, welche Abschnitte er benötigt: Schlagen Sie basierend auf der Art des Dokuments und der Vorlage drei bis fünf 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 Siecreate_file, um ein Artefakt zu erstellen. Dies gibt sowohl Claude als auch dem Benutzer ein Gerüst, von dem aus sie arbeiten können.

Teilen Sie ihnen mit, dass die anfängliche Struktur mit Platzhaltern für alle Abschnitte erstellt wird.

Erstellen Sie ein Artefakt mit allen Abschnittsüberschriften und einem kurzen Platzhaltertext wie „[Zu schreiben]“ oder „[Inhalt hier]“.

Geben Sie den Gerüstlink an und geben Sie an, dass es Zeit ist, jeden Abschnitt auszufüllen.

Wenn kein Zugriff auf Artefakte: Erstellen Sie eine Markdown-Datei im Arbeitsverzeichnis. Benennen Sie es entsprechend (z. B.decision-doc.md,technical-spec.md).

Teilen Sie ihnen mit, dass die anfängliche Struktur mit Platzhaltern für alle Abschnitte erstellt wird.

Erstellen Sie eine Datei mit allen Abschnittsüberschriften und Platzhaltertexten.

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: Fragen klären

Kündigen Sie den Beginn der Arbeiten am Abschnitt [ABSCHNITTNAME] an. Stellen Sie 5–10 klärende Fragen dazu, was enthalten sein sollte:

Generieren Sie 5–10 spezifische Fragen basierend auf dem Kontext und dem Zweck des Abschnitts.

Teilen Sie ihnen mit, dass sie stenographisch antworten können, oder geben Sie einfach an, was wichtig ist.

Schritt 2: Brainstorming

Überlegen Sie sich für den Abschnitt [ABSCHNITTNAME] [5–20] Dinge, die je nach Komplexität des Abschnitts enthalten sein könnten. Suchen Sie nach:

• Geteilter Kontext, der möglicherweise vergessen wurde
• Aspekte oder Überlegungen wurden noch nicht erwähnt

Generieren Sie 5–20 nummerierte Optionen basierend auf der Komplexität des Abschnitts. Bieten Sie am Ende ein weiteres Brainstorming an, wenn sie zusätzliche Optionen wünschen.

Schritt 3: Kuration

Fragen Sie, welche Punkte beibehalten, entfernt oder kombiniert werden sollen. Fordern Sie kurze Begründungen an, um die Prioritäten für die nächsten Abschnitte zu ermitteln.

Geben Sie Beispiele an:

• „1,4,7,9 behalten“
• „3 entfernen (1 Duplikate)“
• „Entferne 6 (das Publikum weiß das bereits)“
• „11 und 12 kombinieren“

Wenn der Benutzer ein Freiform-Feedback gibt (z. B. „Sieht gut aus“ oder „Das meiste gefällt mir, aber...“) anstelle einer nummerierten Auswahl, extrahieren Sie seine Präferenzen und fahren Sie fort. Analysieren Sie, was beibehalten/entfernt/geändert werden soll, und wenden Sie es an.

Schritt 4: Lückenprüfung

Fragen Sie anhand Ihrer Auswahl, ob im Abschnitt [ABSCHNITTNAME] etwas Wichtiges fehlt.

Schritt 5: Entwurf

Verwenden Siestr_replace, um den Platzhaltertext für diesen Abschnitt durch den tatsächlich entworfenen Inhalt zu ersetzen.

Geben Sie bekannt, dass der Abschnitt [ABSCHNITTNAME] jetzt basierend auf der Auswahl entworfen wird.

Bei Verwendung von Artefakten: Stellen Sie nach dem Entwurf einen Link zum Artefakt bereit.

Bitten Sie sie, es durchzulesen und anzugeben, was geändert werden soll. Beachten Sie, dass es beim Lernen für die nächsten Abschnitte hilfreich ist, wenn Sie spezifisch sind.

Bei Verwendung einer Datei (keine Artefakte): Bestätigen Sie nach dem Entwurf den Abschluss.

Teilen Sie ihnen mit, dass der Abschnitt [ABSCHNITTNAME] in [Dateiname] entworfen wurde. Bitten Sie sie, es durchzulesen und anzugeben, was geändert werden soll. Beachten Sie, dass es beim Lernen für die nächsten Abschnitte hilfreich ist, wenn Sie spezifisch sind.

Wichtige Anweisungen für Benutzer (beim Verfassen des ersten Abschnitts einbeziehen): Geben Sie eine Notiz an: Anstatt das Dokument direkt zu bearbeiten, bitten Sie sie, anzugeben, was geändert werden soll. Dies hilft dabei, ihren Stil für zukünftige Abschnitte zu lernen. Zum Beispiel: „Entfernen Sie das Aufzählungszeichen X – bereits abgedeckt durch Y“ oder „Machen Sie den dritten Absatz prägnanter“.

Schritt 6: Iterative Verfeinerung

Wenn der Benutzer Feedback gibt:

• Verwenden Siestr_replace, um Änderungen vorzunehmen (drucken Sie niemals das gesamte Dokument erneut).
• Bei Verwendung von Artefakten: Stellen Sie nach jeder Bearbeitung einen Link zum Artefakt bereit
• Bei Verwendung von Dateien: Bestätigen Sie einfach, dass die Änderungen abgeschlossen sind
• Wenn der Benutzer das Dokument direkt bearbeitet und darum bittet, es zu lesen: Notieren Sie sich die vorgenommenen Änderungen im Kopf und behalten Sie sie für zukünftige Abschnitte im Hinterkopf (dies zeigt seine Präferenzen).

Iterieren Sie weiter, bis der Benutzer mit dem Abschnitt zufrieden ist.

Qualitätsprüfung

Fragen Sie nach drei aufeinanderfolgenden Iterationen ohne wesentliche Änderungen, ob etwas entfernt werden kann, ohne dass wichtige Informationen verloren gehen.

Wenn der Abschnitt fertig ist, bestätigen Sie, dass [ABSCHNITTNAME] abgeschlossen ist. Fragen Sie, ob Sie bereit sind, mit dem nächsten Abschnitt fortzufahren.

Wiederholen Sie dies für alle Abschnitte.

Kurz vor der Fertigstellung

Sobald der Abschluss näher rückt (über 80 % der Abschnitte sind erledigt), kündigen Sie an, dass Sie beabsichtigen, das gesamte Dokument noch einmal zu lesen und auf Folgendes zu prüfen:

• Fluss und Konsistenz über Abschnitte hinweg
• Redundanz oder Widersprüche
• Alles, was sich wie „Slop“ oder generisches 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: Geben Sie bekannt, dass alle Abschnitte ausgearbeitet sind. Geben Sie an, dass Sie beabsichtigen, das gesamte Dokument noch einmal durchzusehen.

Überprüfung auf Gesamtkohärenz, Fluss und Vollständigkeit.

Machen Sie abschließende Vorschläge.

Fragen Sie, ob sie bereit sind, auf Reader Testing umzusteigen, oder ob sie etwas anderes verfeinern möchten.

Stufe 3: Lesertests

Ziel: Testen Sie das Dokument mit einem neuen Claude (kein Kontextauslauf), um sicherzustellen, dass es für Leser funktioniert.

Anweisungen für den Benutzer: Erklären Sie, dass nun Tests durchgeführt werden, um zu sehen, ob das Dokument tatsächlich für die Leser funktioniert. Dadurch werden blinde Flecken aufgedeckt – Dinge, die für die Autoren Sinn ergeben, andere jedoch verwirren könnten.

Testansatz

Wenn Zugriff auf Subagenten verfügbar ist (z. B. in Claude Code):

Führen Sie die Tests direkt und ohne Eingreifen 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 entdecken.

Generieren Sie 5–10 Fragen, die die Leser realistischerweise stellen würden.

Schritt 2: Testen Sie mit Sub-Agent

Kündigen Sie an, dass diese Fragen mit einer neuen Claude-Instanz getestet werden (kein Kontext aus dieser Konversation).

Rufen Sie für jede Frage einen Unteragenten auf, der nur den Dokumentinhalt und die Frage enthält.

Fassen Sie zusammen, was Leser Claude bei jeder Frage richtig/falsch gemacht hat.

Schritt 3: Führen Sie zusätzliche Prüfungen durch

Kündigen Sie an, dass zusätzliche Kontrollen durchgeführt werden.

Rufen Sie einen Subagenten an, um auf Unklarheiten, falsche Annahmen und Widersprüche zu prüfen.

Fassen Sie alle gefundenen Probleme zusammen.

Schritt 4: Melden und beheben

Wenn Probleme gefunden werden: Berichten Sie, dass Leser Claude mit bestimmten Problemen zu kämpfen hatte.

Listen Sie die spezifischen Probleme auf.

Geben Sie an, dass Sie beabsichtigen, diese Lücken zu schließen.

Für problematische Abschnitte kehren Sie zur Verfeinerung zurück.

---

Wenn kein Zugriff auf Subagenten (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 entdecken. Was würden sie in Claude.ai eingeben?

Generieren Sie 5–10 Fragen, die die Leser realistischerweise stellen würden.

Schritt 2: Setup-Tests

Geben Sie Testanweisungen an:

1. Eröffnen Sie ein neues Claude-Gespräch: https://claude.ai
2. Fügen Sie den Dokumentinhalt ein oder teilen Sie ihn (wenn Sie eine freigegebene Dokumentplattform mit aktivierten Connectors verwenden, geben Sie den Link an).
3. Stellen Sie Leser Claude die generierten Fragen

Bitten Sie Leser Claude, für jede Frage Folgendes anzugeben:

• Die Antwort
• Ob etwas unklar oder unklar war
• Von welchem Wissen/Kontext das Dokument ausgeht, ist bereits bekannt

Überprüfen Sie, ob Leser Claude die richtigen Antworten gibt oder etwas falsch interpretiert.

Schritt 3: Zusätzliche Prüfungen

Fragen Sie auch Leser Claude:

• „Was in diesem Dokument könnte für die Leser mehrdeutig oder unklar sein?“
• „Welches Wissen oder welchen Kontext gehen die Leser in diesem Dokument davon aus, dass sie bereits verfügen?“
• „Gibt es interne Widersprüche oder Ungereimtheiten?“

Schritt 4: Iterieren Sie basierend auf den Ergebnissen

Fragen Sie Leser Claude, womit er einen Fehler gemacht oder Probleme hatte. Geben Sie an, dass Sie beabsichtigen, diese Lücken zu schließen.

Gehen Sie bei problematischen Abschnitten zur Verfeinerung zurück.

---

Austrittsbedingung (beide Ansätze)

Wenn Leser Claude die Fragen stets richtig beantwortet und keine neuen Lücken oder Unklarheiten aufdeckt, ist das Dokument fertig.

Abschließende Überprüfung

Wenn der Lesertest erfolgreich ist: Geben Sie bekannt, dass das Dokument den Reader-Claude-Test bestanden hat. Vor der Fertigstellung:

1. Empfehlen Sie ihnen, selbst eine abschließende Lektüre durchzuführen – sie sind Eigentümer dieses Dokuments und für seine Qualität verantwortlich
2. Schlagen Sie vor, alle Fakten, Links oder technischen Details noch einmal zu überprüfen
3. Bitten Sie sie, zu überprüfen, ob es die gewünschte Wirkung erzielt

Fragen Sie, ob sie noch eine Rezension wünschen oder ob die Arbeit erledigt ist.

Wenn der Benutzer eine abschließende Bewertung wünscht, geben Sie diese an. Ansonsten: Kündigen Sie die Fertigstellung des Dokuments an. Geben Sie noch ein paar abschließende Tipps:

• Erwägen Sie, diese Konversation in einem Anhang zu verlinken, damit die Leser sehen können, wie das Dokument entwickelt wurde
• Verwenden Sie Anhänge, um dem Dokument mehr Tiefe zu verleihen, ohne das Hauptdokument aufzublähen
• Aktualisieren Sie das Dokument, sobald Feedback von echten Lesern eingeht

Tipps für eine effektive Anleitung

Ton:

• Seien Sie direkt und prozedural
• Erläutern Sie kurz die Gründe, warum sie sich auf das Benutzerverhalten auswirken
• Versuchen Sie nicht, den Ansatz zu „verkaufen“, sondern führen Sie ihn einfach aus

Abweichungen bei der Handhabung:

• Wenn der Benutzer eine Phase überspringen möchte: Fragen Sie, ob er diese überspringen möchte, und schreiben Sie Freiform
• Wenn der Benutzer frustriert zu sein scheint: Beachten Sie, dass dies länger dauert als erwartet. Schlagen Sie Möglichkeiten vor, schneller voranzukommen
• Geben Sie dem Benutzer immer die Möglichkeit, den Prozess anzupassen

Kontextverwaltung:

• Wenn der Kontext zu etwas Erwähntem fehlt, fragen Sie proaktiv nach
• Lassen Sie nicht zu, dass sich Lücken anhäufen – beheben Sie sie, wenn sie entstehen

Artefaktverwaltung:

• Verwenden Siecreate_filezum Entwerfen vollständiger Abschnitte
• Verwenden Siestr_replacefür alle Bearbeitungen
• Stellen Sie nach jeder Änderung einen Artefaktlink bereit
• Verwenden Sie niemals Artefakte für Brainstorming-Listen – das ist nur Konversation

Qualität vor Geschwindigkeit:

• Hetzen Sie nicht durch die Etappen
• Jede Iteration sollte sinnvolle Verbesserungen bringen
• Das Ziel ist ein Dokument, das für die Leser tatsächlich funktioniert

Siehe in GitHub

Siehe in GitHub