Communitygithub.com

Système de Commentaires et de Discussions

Concevoir et implémenter un cadre structuré pour des conversations en fil, gérant les niveaux d'imbrication, les hiérarchies d'actions et la signalisation communautaire afin de favoriser l'engagement et la lisibilité.

Qu'est-ce que Système de Commentaires et de Discussions ?

Ce système fournit une méthodologie complète pour concevoir des couches de conversation interactives, garantissant que les dialogues complexes restent lisibles, navigables et organisés. Il définit des règles pour le threading, les limites d'imbrication, la priorité des actions et la signalisation des contributeurs, évitant ainsi le 'spaghetti d'informations'. Le système est utile pour les forums communautaires, les commentaires d'articles, la collaboration SaaS, les Q&A de support et les fils sociaux. Il détaille un flux de travail en cinq étapes : définir l'anatomie d'un commentaire, établir les règles de threading et d'imbrication, hiérarchiser les actions, implémenter la signalisation de confiance, et planifier les adaptations responsive. Les décisions clés incluent le choix entre l'indentation et l'affichage à plat en fonction du contexte, l'affichage des votes, le tri par défaut et la troncature des longs commentaires. Le système met l'accent sur l'accessibilité, la réactivité et la performance, avec des contraintes sur la navigation au clavier, l'adaptation mobile et le chargement paresseux pour les fils à fort volume.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Système de Commentaires et de Discussions ?

Objectif

Le Système de Commentaires et de Discussions fournit une méthodologie pour concevoir des couches de conversation interactives. Il garantit que les dialogues complexes et multi-utilisateurs restent lisibles, navigables et organisés. En définissant des règles pour le threading, les limites d'imbrication, la priorité des actions et la signalisation des contributeurs, ce système évite le « spaghetti d'informations » et aide les utilisateurs à trouver les contributions les plus précieuses dans des environnements à fort volume.

Cas d'Utilisation

  • Forums Communautaires : Conception de discussions en fil pour des communautés de niche.
  • Commentaires d'Articles/Blogs : Permettre les retours des lecteurs sur du contenu long.
  • Collaboration SaaS : Structurer les discussions internes au sein des tâches de projet, des documents ou des pull requests.
  • Q&A de Support : Organiser les questions des clients et les réponses du personnel.
  • Flux Sociaux : Gérer les interactions sur des publications ou des médias partagés.

Quand NE PAS Utiliser

  • Messagerie Directe (Chat) : Pour la messagerie en temps réel de 1 à 1 ou en petit groupe, utilisez une mise en page optimisée pour les « bulles de messages » et la livraison instantanée.
  • Flux d'Annonces uniquement : Là où les utilisateurs ne peuvent pas répondre ou interagir ; une simple liste de notifications suffit.
  • Pages à Faible Interaction : Si une page attend moins de 3 commentaires au total, une liste plate sans threading est plus efficace.
  • Journaux Transactionnels : Pour les journaux d'audit système automatisés, utilisez timeline-activity-system.

Entrées

  1. Modèle Hiérarchique : Quelle est la profondeur maximale des threads ? (Plat, imbriqué ou hybride).
  2. Données d'Identité Utilisateur : Avatars, noms d'affichage et rôles (par exemple, Modérateur, Auteur, Personnel).
  3. Métriques d'Engagement : Nombre de votes (Pour/Contre), nombre de réponses et horodatages.
  4. Métadonnées Contextuelles : Badges « Achat Vérifié », « Meilleur Contributeur » ou « Auteur ».

Sorties

  1. Spécification de l'Anatomie d'un Commentaire : Définition visuelle d'un « Nœud » de commentaire unique (Avatar, Méta, Corps, Actions).
  2. Plan de Threading : Règles spatiales pour l'imbrication, y compris les incréments d'indentation et les « Lignes de Fil » verticales.
  3. Carte de Hiérarchie des Actions : Classement des priorités pour « Répondre », « Voter », « Modifier » et « Signaler ».
  4. Stratégie d'Adaptation Responsive : Règles pour réduire les threads ou aplatir les mises en page sur mobile.

Flux de Travail

1. Définir l'Anatomie du Commentaire

Établir une structure de « Nœud » cohérente :

  • L'En-tête : Avatar de l'utilisateur (taille en fonction du niveau d'imbrication), nom d'affichage, badges de rôle et horodatage relatif (par exemple, « il y a 2h »).
  • Le Corps : Le contenu textuel, prenant en charge le markdown ou le texte enrichi le cas échéant.
  • La Barre d'Actions : Actions principales (Répondre, Voter) et secondaires (Partager, Signaler, Modifier).

2. Établir les Règles de Threading et d'Imbrication

Gérer la relation spatiale entre les réponses :

  • Indentation : Utilisez un incrément cohérent (par exemple, 24px ou 1.5rem) pour les réponses imbriquées.
  • Lignes de Fil : Utilisez des lignes verticales subtiles (largeur de 1px) pour relier visuellement une réponse à son parent.
  • Limite d'Imbrication : Définissez une profondeur maximale (généralement 3 à 5 niveaux) avant d'aplatir le thread ou d'exiger un lien « Continuer ce fil » vers une nouvelle vue.

3. Classer la Priorité des Actions

Toutes les actions ne sont pas égales ; utilisez le poids visuel pour guider l'utilisateur :

  • Primaires : « Répondre » et « Voter » doivent être immédiatement visibles.
  • Secondaires : « Partager » ou « Lien » peuvent être uniquement textuels ou sous forme d'icône.
  • Débordement : Placez « Modifier », « Supprimer » et « Signaler » dans un menu « Plus » (ellipsis) pour réduire l'encombrement.

4. Implémenter la Signalisation et la Confiance

Utilisez des indices visuels pour fournir du contexte :

  • Surlignage Auteur/Personnel : Utilisez une couleur d'arrière-plan distincte ou un badge proéminent pour l'auteur original ou le personnel officiel.
  • Commentaires Nouveaux/Surlignés : Utilisez un fondu d'arrière-plan subtil ou un accent de bordure gauche pour signaler les commentaires non lus ou nouvellement publiés.
  • Visualisation des Votes : Utilisez la couleur (par exemple, Orange pour les votes positifs, Bleu pour les votes négatifs) uniquement lorsqu'elle est active.

5. Planifier les Adaptations Responsives

Les threads consomment rapidement de l'espace horizontal ; adaptez-vous aux fenêtres étroites :

  • Aplatissement Mobile : Réduisez les incréments d'indentation sur mobile (par exemple, de 24px à 8px) ou limitez l'imbrication à 2 niveaux avant de passer en mode plat.
  • Le Pivot « Plein écran » : Pour les threads profonds, permettez d'appuyer sur une réponse pour l'ouvrir ainsi que ses enfants dans un « mode focus » dédié et pleine largeur.

Règles de Décision

  • Indentation vs. Plat : Utilisez l'indentation pour la « Découverte » (où le contexte du parent est crucial). Utilisez des listes plates avec des références « @mention » pour les environnements de « Tâche » (où les dernières informations sont prioritaires).
  • Affichage des Votes : N'affichez les votes négatifs que si la communauté nécessite une « Auto-régulation ». Pour la plupart des environnements de croissance positive, n'affichez que les votes positifs.
  • Tri par Défaut : Par défaut, triez par « Meilleurs » (score pondéré) pour les communautés, mais par « Plus récents » pour les outils de collaboration sensibles au temps.
  • Règle de Troncature : Tronquez les commentaires extrêmement longs (>500 mots) avec un bouton « Lire la suite » pour préserver le rythme vertical du fil.

Contraintes

  • Accessibilité : Les commentaires doivent être navigables au clavier (Tab pour les actions). Utilisez du HTML sémantique (<article> pour les commentaires, <ul>/<li> pour l'imbrication). Chaque action doit avoir une étiquette claire. Les « Lignes de fil » doivent être purement décoratives (cachées des ARIA) ou utiliser aria-hidden="true".
  • Réactivité : L'indentation ne doit pas pousser le contenu hors des bords de l'écran. Utilisez padding-left ou margin-left sur les conteneurs, jamais de largeurs fixes pour les blocs imbriqués.
  • Performance : Pour les threads à fort volume (>100 commentaires), utilisez le « Chargement Paresseux » ou la pagination « Charger plus » pour éviter les longs temps de rendu initiaux.

Schémas d'Échec Courants

  • La Mort par Indentation : Permettre une imbrication infinie jusqu'à ce que le texte fasse 1 caractère de large sur le côté droit de l'écran.
  • Surcharge d'Actions : Afficher 10+ boutons sous chaque commentaire, créant une « mer d'icônes ».
  • Hiérarchie Invisible : Ne pas faire la distinction entre l'« Auteur » et un commentateur régulier, rendant difficile la recherche de réponses officielles.
  • Le « Parent Perdu » : Les threads profonds sans lignes de fil, ce qui rend difficile le suivi de la réponse appartenant à quel parent.
  • État Manquant : Ne pas afficher un état « En attente » ou « Envoi en cours » lorsqu'un utilisateur soumet un commentaire.

Critères de Validation

  • La profondeur d'imbrication est limitée et passe à une vue plate ou « focus ».
  • La hiérarchie visuelle distingue l'Auteur, le Personnel et les utilisateurs réguliers.
  • Les lignes de fil relient clairement les réponses à leurs commentaires parents.
  • Les actions principales (Répondre/Voter) sont visuellement plus importantes que les actions secondaires.
  • L'indentation s'adapte aux fenêtres mobiles pour éviter le débordement horizontal.
  • Les commentaires sont balisés sémantiquement comme une liste imbriquée ou des articles.
  • Les boutons d'action ont une zone de contact minimale de 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.

Skills associés