Communitygithub.com

Kommentar- und Diskussionssystem

Entwerfen und implementieren Sie ein systematisches Framework für verschachtelte Konversationen, das Verschachtelungstiefen, Aktionshierarchien und Community-Signalisierung verwaltet, um Engagement und Lesbarkeit zu fördern.

Was ist Kommentar- und Diskussionssystem?

Dieses Skill definiert eine umfassende Methodik zur Gestaltung strukturierter, threading-basierter Diskussionssysteme – ideal für Community-Foren, Blog-Kommentare, SaaS-Zusammenarbeit und Support-Q&A. Es beschreibt, wie Kommentare als einheitliche „Nodes“ aufgebaut werden (Avatar, Metadaten, Inhalt, Aktionsleiste), wie Threads durch konsistente Einrückungen, vertikale Thread-Linien und eine maximale Verschachtelungstiefe (3-5 Ebenen) organisiert werden, und wie Aktionen nach Priorität gewichtet und visuell hervorgehoben werden (primär: Antworten und Abstimmungen; sekundär: Teilen, Melden; Overflow: Bearbeiten/Löschen). Darüber hinaus werden Entscheidungsregeln für die Sortierung („Top“ vs. „Neueste“), die Anzeige von Abstimmungen (nur Upvotes oder auch Downvotes) und die mobile Anpassung (Reduzierung der Einrückung, Full-Screen-Fokus-Modus) bereitgestellt. Wichtige Einschränkungen umfassen Barrierefreiheit (Tastaturnavigation, semantisches HTML), Performance (Lazy Loading für viele Kommentare) und die Vermeidung typischer Fehlermuster wie „Einrückungstod“ oder „Aktionsüberflutung“. Dieses Skill ist plattformunabhängig und kann in Web-Apps, Content-Management-Systemen oder kollaborativen Tools integriert werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/comment-and-discussion-system

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Kommentar- und Diskussionssystem?

Zweck

Das Kommentar- und Diskussionssystem bietet eine Methodik zur Gestaltung interaktiver Gesprächsebenen. Es stellt sicher, dass komplexe Multi-User-Dialoge lesbar, navigierbar und organisiert bleiben. Durch die Definition von Regeln für Threading, Verschachtelungsgrenzen, Aktionspriorität und Beitragssignalisierung verhindert dieses System „Informationsspaghetti“ und hilft Benutzern, die wertvollsten Beiträge in Umgebungen mit hohem Volumen zu finden.

Anwendungsfälle

  • Community-Foren: Gestaltung von threaded Diskussionen für Nischen-Communities.
  • Artikel-/Blog-Kommentare: Ermöglicht Leserfeedback zu langen Inhalten.
  • SaaS-Zusammenarbeit: Strukturierung interner Diskussionen innerhalb von Projektaufgaben, Dokumenten oder Pull Requests.
  • Support-Foren: Organisation von Kundenfragen und Mitarbeiterantworten.
  • Social Feeds: Verwaltung von Interaktionen zu geteilten Beiträgen oder Medien.

Wann NICHT zu verwenden

  • Direktnachrichten (Chat): Für Echtzeit-1-zu-1- oder kleine Gruppennachrichten verwenden Sie ein Layout, das für „Message Bubbles“ und sofortige Zustellung optimiert ist.
  • Ankündigungsfeeds: Wenn Benutzer nicht antworten oder interagieren können; eine einfache Liste von Benachrichtigungen ist ausreichend.
  • Interaktionsarme Seiten: Wenn eine Seite weniger als 3 Kommentare insgesamt erwartet, ist eine flache Liste ohne Threading effizienter.
  • Transaktionsprotokolle: Für automatisierte Systemaudit-Logs verwenden Sie timeline-activity-system.

Eingaben

  1. Hierarchiemodell: Wie tief können Threads gehen? (Flach, verschachtelt oder hybrid).
  2. Benutzeridentitätsdaten: Avatare, Anzeigenamen und Rollen (z. B. Moderator, Autor, Mitarbeiter).
  3. Engagement-Metriken: Stimmenanzahlen (Up/Down), Antwortanzahlen und Zeitstempel.
  4. Kontextbezogene Metadaten: „Verifizierter Kauf“, „Top-Contributor“ oder „Autor“-Abzeichen.

Ausgaben

  1. Kommentar-Anatomie-Spezifikation: Visuelle Definition eines einzelnen Kommentar-,Knotens‘ (Avatar, Meta, Inhalt, Aktionen).
  2. Threading-Blueprint: Räumliche Regeln für die Verschachtelung, einschließlich Einrückungsinkrementen und vertikalen „Thread-Linien“.
  3. Aktionshierarchie-Karte: Prioritätsreihung für „Antworten“, „Abstimmen“, „Bearbeiten“ und „Melden“.
  4. Responsive-Anpassungsstrategie: Regeln zum Einklappen von Threads oder zum Glätten von Layouts auf mobilen Geräten.

Workflow

1. Kommentar-Anatomie definieren

Legen Sie eine konsistente „Knoten“-Struktur fest:

  • Der Header: Benutzeravatar (Größe je nach Verschachtelungsebene), Anzeigename, Rollenabzeichen und relativer Zeitstempel (z. B. „vor 2 Std.“).
  • Der Inhalt: Der Textinhalt, unterstützt Markdown oder Rich Text, wo angemessen.
  • Die Aktionsleiste: Primäre (Antworten, Abstimmen) und sekundäre (Teilen, Melden, Bearbeiten) Aktionen.

2. Threading- und Verschachtelungsregeln festlegen

Verwalten Sie die räumliche Beziehung zwischen Antworten:

  • Einrückung: Verwenden Sie ein konsistentes Inkrement (z. B. 24px oder 1.5rem) für verschachtelte Antworten.
  • Thread-Linien: Verwenden Sie dezente vertikale Linien (1px Breite), um eine Antwort visuell mit ihrem übergeordneten Element zu verbinden.
  • Verschachtelungslimit: Setzen Sie eine maximale Tiefe (normalerweise 3–5 Ebenen) fest, bevor der Thread abgeflacht wird oder ein Link „Diesen Thread fortsetzen“ zu einer neuen Ansicht erforderlich ist.

3. Aktionspriorität einstufen

Nicht alle Aktionen sind gleich; verwenden Sie visuelles Gewicht, um den Benutzer zu leiten:

  • Primär: „Antworten“ und „Abstimmen“ sollten sofort sichtbar sein.
  • Sekundär: „Teilen“ oder „Link“ können nur als Text oder Symbol dargestellt werden.
  • Überlauf: Platzieren Sie „Bearbeiten“, „Löschen“ und „Melden“ in einem „Mehr“-Menü (Auslassungspunkte), um Unordnung zu vermeiden.

4. Signalisierung und Vertrauen implementieren

Verwenden Sie visuelle Hinweise, um Kontext bereitzustellen:

  • Autor/Mitarbeiter-Hervorhebung: Verwenden Sie eine auffällige Hintergrundfarbe oder ein markantes Abzeichen für den ursprünglichen Autor oder offizielle Mitarbeiter.
  • Neue/hervorgehobene Kommentare: Verwenden Sie eine dezente Hintergrundabschwächung oder einen linken Randakzent, um ungelesene oder neu gepostete Kommentare zu signalisieren.
  • Abstimmungsvisualisierung: Verwenden Sie Farbe (z. B. Orange für Upvotes, Blau für Downvotes) nur, wenn aktiv.

5. Responsive Anpassungen planen

Threads verbrauchen schnell horizontalen Platz; passen Sie sie für schmale Viewports an:

  • Mobile Abflachung: Reduzieren Sie die Einrückungsinkremente auf Mobilgeräten (z. B. von 24px auf 8px) oder begrenzen Sie die Verschachtelung auf 2 Ebenen, bevor Sie flach werden.
  • Der „Full-Screen“-Pivot: Ermöglichen Sie bei tiefen Threads, dass durch Tippen auf eine Antwort diese und ihre Kinder in einem dedizierten, vollbreiten „Fokusmodus“ geöffnet werden.

Entscheidungsregeln

  • Einrückung vs. Flach: Verwenden Sie Einrückung für „Entdeckung“ (wo der Kontext des übergeordneten Elements entscheidend ist). Verwenden Sie flache Listen mit „@mention“-Referenzen für „Aufgaben“-Umgebungen (wo die aktuellsten Informationen Priorität haben).
  • Abstimmungsanzeige: Zeigen Sie Downvotes nur an, wenn die Community eine „Selbstregulierung“ benötigt. Für die meisten wachstumsorientierten Umgebungen zeigen Sie nur Upvotes an.
  • Standardsortierung: Verwenden Sie standardmäßig „Top“ (gewertete Punktzahl) für Communities, aber „Neueste“ für zeitkritische Kollaborationstools.
  • Kürzungsregel: Kürzen Sie extrem lange Kommentare (>500 Wörter) mit einem „Weiterlesen“-Button, um den vertikalen Rhythmus des Threads zu erhalten.

Einschränkungen

  • Barrierefreiheit: Kommentare müssen über die Tastatur navigierbar sein (Tab durch Aktionen). Verwenden Sie semantisches HTML (<article> für Kommentare, <ul>/<li> für Verschachtelung). Jede Aktion muss eine klare Beschriftung haben. „Thread-Linien“ sollten rein dekorativ sein (vor ARIA verborgen) oder aria-hidden="true" verwenden.
  • Reaktionsfähigkeit: Die Einrückung darf den Inhalt nicht über den Bildschirmrand drücken. Verwenden Sie padding-left oder margin-left auf Containern, niemals feste Breiten für verschachtelte Blöcke.
  • Leistung: Verwenden Sie für Threads mit hohem Volumen (>100 Kommentare) „Lazy Loading“ oder „Load More“-Paginierung, um lange anfängliche Renderzeiten zu vermeiden.

Häufige Fehlermuster

  • Einrückungstod: Unendliche Verschachtelung zulassen, bis der Text auf der rechten Seite des Bildschirms nur noch 1 Zeichen breit ist.
  • Aktionsüberflutung: 10+ Schaltflächen unter jedem einzelnen Kommentar anzeigen, was ein „Meer von Symbolen“ erzeugt.
  • Unsichtbare Hierarchie: Fehlende Unterscheidung zwischen dem „Autor“ und einem regulären Kommentator, was es schwierig macht, offizielle Antworten zu finden.
  • Der „Verlorene Elternteil“: Tiefe Threads ohne Thread-Linien, was es schwierig macht, nachzuvollziehen, welche Antwort zu welchem übergeordneten Element gehört.
  • Fehlender Status: Kein „Ausstehend“- oder „Sende“-Status anzeigen, wenn ein Benutzer einen Kommentar einreicht.

Validierungskriterien

  • Die Verschachtelungstiefe ist begrenzt und geht in eine flache oder „Fokus“-Ansicht über.
  • Die visuelle Hierarchie unterscheidet zwischen Autor, Mitarbeiter und regulären Benutzern.
  • Thread-Linien verbinden Antworten klar mit ihren übergeordneten Kommentaren.
  • Primäre Aktionen (Antworten/Abstimmen) sind visuell prominenter als sekundäre.
  • Die Einrückung passt sich an mobile Viewports an, um horizontalen Überlauf zu verhindern.
  • Kommentare sind semantisch als verschachtelte Liste oder Artikel ausgezeichnet.
  • Aktionsschaltflächen haben eine minimale Berührungszielgröße von 44x44px.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and specify a systematic dark theme framework, establishing rules for elevation-based surface colors, desaturated brand accents, text legibility, and media adaptation to ensure an accessible, low-fatigue experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Verwandte Skills