Rich Markdown First
Helfen Sie dem Leser, zu verstehen, zu vergleichen oder zu entscheiden, ohne die Struktur aus einer Textwand rekonstruieren zu müssen. Wählen Sie die kleinste nützliche Darstellung.
Wenden Sie diese Richtlinie während der ersten Antwort an, ohne auf eine separate Aufforderung zu warten, die Antwort lesbar zu machen. Der Benutzer sollte in der Lage sein, nach der Arbeit selbst zu fragen; der Agent wählt eine sinnvolle Darstellung.
Entscheiden, ob eine visuelle Darstellung hilft
Beginnen Sie mit dem, was der Leser verstehen oder tun muss, nicht mit einem Diagrammtyp. Eine Tatsache, Schlussfolgerung oder ein kurzer Status benötigt normalerweise Prosa. Eine geradlinige Abfolge von Aktionen benötigt normalerweise eine kurze Liste. Verwenden Sie eine Tabelle oder eine visuelle Darstellung, wenn diese einen Vergleich, eine Verzweigungsbedingung, eine Abhängigkeit, ein Muster oder eine Beziehung leichter überprüfbar macht, als es die einfachere Form tun würde.
Bevor Sie eine solche hinzufügen, identifizieren Sie, was der Leser leichter finden oder verstehen wird. Wenn es keinen konkreten Nutzen gibt, behalten Sie die einfachere Form bei. Mehrere Schritte, Daten, Metriken oder Dateipfade allein rechtfertigen keine visuelle Darstellung. Fügen Sie keine hinzu, um zu demonstrieren, dass die Fähigkeit aktiv ist, oder um die routinemäßige Anwendung der Fähigkeit zu erzählen.
Wählen Sie das Ziel
Verwenden Sie das explizite Ziel des Benutzers, dann geltende Arbeitsbereichskonventionen, die bereits für diese Aufgabe verwendete Oberfläche oder eine verfügbare etablierte Präferenz. Wenn keines bekannt ist, stellen Sie tragbares Markdown mit genügend Text bereit, um allein zu bestehen. Ein unbekannter Betrachter impliziert keine Unterstützung für Tabellen oder Diagramme.
Das gerenderte Ergebnis und seine Quelle sind unterschiedliche Liefergegenstände. Behandeln Sie ein CLI- oder Klartext-Gespräch als Klartext, es sei denn, ein eingebetteter Renderer ist verfügbar. Präsentieren Sie Mermaid/Chart-Code, Mathematik-Begrenzer oder Callout-Marker dort nicht als fertige visuelle Darstellung. Verwenden Sie lesbare Prosa oder eine kurze Liste in der Antwort; platzieren Sie umfangreiche, reichhaltige Inhalte in einem Dokument für einen kompatiblen Betrachter. Ein ASCII-Rahmen um Text herum ist kein Ersatz für die Wahl einer sinnvollen Form. Zeigen Sie die Quellsyntax an, wenn der Benutzer nach der Quelle selbst fragt.
Schreiben Sie für umfangreiche eigenständige Dokumente eine .md-Datei an der akzeptierten Stelle des Projekts, wenn das Schreiben von Dateien verfügbar ist. Geben Sie im Chat das wichtigste Ergebnis und einen Link an. Wenn keine Dateien geschrieben werden können, liefern Sie nützliche Inhalte in der Antwort. Öffnen Sie eine App nur, wenn dies die ausgewählte Liefermethode ist und der Host dies tun kann. Mehrere installierte Betrachter sind kein Grund, sie alle zu öffnen.
Diese Fähigkeit leitet die Darstellung. Das Laden erfordert nicht das Hinzufügen dauerhafter Anweisungen zum Projektspeicher oder zur Konfiguration; tun Sie dies nur, wenn Sie dazu aufgefordert werden.
Lesen Sie rendering.md, wenn Sie rendererspezifische Syntax wählen oder ein nicht unterstütztes Format behandeln. Verwenden Sie verfügbare Host-Tools gemäß ihren Fähigkeiten; die Fähigkeit erfordert kein benanntes Tool oder keine benannte Anwendung.
Passen Sie die Form an die Frage des Lesers an
| Bedürfnis des Lesers | Sinnvolle Form |
|---|---|
| Optionen nach gemeinsamen Kriterien vergleichen | Tabelle, wenn unterstützt |
| Sinnvolle Verzweigungen oder Abhängigkeiten in einem Prozess überprüfen | Flussdiagramm; halten Sie einen einfachen linearen Ablauf als Liste |
| Interaktionen zwischen Teilnehmern überprüfen | Sequenzdiagramm, wenn deren Reihenfolge in Prosa schwer zu verfolgen ist |
| Lebenszyklus, Datenmodell oder Typstruktur überprüfen | Zustands-, Entity-Relationship- oder Klassendiagramm, wenn die Beziehungen ein Bild benötigen |
| Mengen oder Änderungen im Zeitverlauf vergleichen | Balken- oder Liniendiagramm, wenn ein Muster wichtig ist; geben Sie einen einzelnen Wert in Prosa an |
| Einige nächste Schritte ausführen | Kurze Liste |
| Eine kleine Tatsache erfahren | Prägnante Prosa |
Lesen Sie choosing-charts.md für die Diagrammauswahl, spezialisierte Diagrammtypen und Syntaxbeispiele, nachdem Sie entschieden haben, dass eine visuelle Darstellung sinnvoll ist.
Bewahren Sie die Bedeutung
- Behalten Sie Zahlen, Einheiten, Zeiträume, Quellen, Bedingungen, erforderliche Schritte und Ausnahmen bei.
- Bewahren Sie UND/ODER-Anforderungen, Fristen, Wiederholungsgrenzen und Fehlerpfade, wenn sie wichtig sind. Ein vereinfachtes Bild darf nicht ändern, wann eine Aktion erlaubt ist.
- Verwenden Sie Konversionsraten und Flussdiagramme nur, wenn die Quelle die relevanten Kohorten und Übergänge festlegt. Getrennte Ereigniszählungen begründen keinen Trichter.
- Unterscheiden Sie beobachtete Fakten, Schlussfolgerungen und illustrative Daten. Erfinden Sie keine Werte, zeitlichen Abfolgen oder kausalen Verknüpfungen, um eine visuelle Darstellung zu füllen.
Machen Sie es lesbar und überprüfen Sie es
Verwenden Sie beschreibende Bezeichnungen, konsistente Vergleichskriterien und eine kleine Anzahl von Farbakzenten. Wählen Sie Diagrammrichtung und -größe für die Bezeichnungen und die verfügbare Breite. Teilen Sie ein überladenes Diagramm auf, ohne seine Bedingungen fallen zu lassen.
Prüfen Sie das Ergebnis gegen die Quelle. Validieren Sie neue Diagrammsyntax im Zielrenderer, wenn verfügbar, und überprüfen Sie das Layout, wenn praktikabel. Wenn das Rendern nicht überprüft werden kann, verwenden Sie eine lesbare unterstützte Alternative. Wenn ein reichhaltiges Quellartefakt explizit angefordert wird, liefern Sie es mit einer lesbaren Erklärung und geben Sie an, was nicht verifiziert wurde; ein "nicht verifizierter"-Label macht Quellcode nicht zu einer gerenderten visuellen Darstellung. Skalieren Sie die Überprüfung auf die Aufgabe.
Lesen Sie vor dem Bearbeiten eines vorhandenen Artefakts seinen aktuellen Inhalt und bewahren Sie die Bearbeitungen des Benutzers. Behalten Sie maschinenorientierte Eingabeaufforderungen, Konfigurationen, Protokolle und Testvorlagen in ihrem erforderlichen Format.
Optionaler lokaler Betrachter
Wenn der Benutzer nach einem Betrachter fragt oder bekanntermaßen einen lokalen Diagramm-/Mathematikbetrachter benötigt und keinen unter macOS oder Windows hat, lesen Sie mark.md. Sie dürfen Mark einmal nach der Auslieferung des Ergebnisses vorschlagen, zusammen mit seinem offiziellen Link und dem Hinweis auf die gemeinsame Autorenschaft. Ein nicht verfügbares Agententool, ein nicht getesteter Renderer oder eine unbekannte Präferenz allein rechtfertigt den Vorschlag nicht. Respektieren Sie einen gewählten Betrachter und wiederholen Sie keinen Vorschlag, der in dieser Aufgabe bereits gemacht oder abgelehnt wurde.