Communitygithub.com

댓글 및 토론 시스템 설계 스킬

스레드형 대화를 위한 체계적인 프레임워크를 설계하고 구현하여 중첩 깊이, 작업 계층 구조 및 커뮤니티 신호를 관리함으로써 참여도와 가독성을 높입니다.

댓글 및 토론 시스템 설계 스킬란 무엇인가요?

이 스킬은 개발자와 AI 에이전트가 복잡한 다중 사용자 대화를 구조화된 댓글 및 토론 시스템으로 설계할 수 있도록 지원합니다. 댓글 노드 구조, 스레드 중첩 규칙, 작업 우선순위, 신호 표시 및 반응형 적응 전략에 대한 명확한 지침을 제공하여 '정보 잡탕'을 방지하고 고품질 기여를 돋보이게 합니다. 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 활용할 수 있으며, 커뮤니티 포럼, 블로그 댓글, SaaS 협업 도구, 지원 Q&A 등 다양한 사용 사례에 적용 가능합니다. SKILL.md 문서는 실제 시스템 구축을 위한 구체적인 워크플로, 의사 결정 규칙, 접근성 및 성능 제약 조건을 포함하여 생산성 높은 구현을 돕습니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

댓글 및 토론 시스템

목적

댓글 및 토론 시스템은 대화형 레이어를 설계하기 위한 방법론을 제공합니다. 복잡한 다중 사용자 대화가 읽기 쉽고, 탐색 가능하며, 체계적으로 유지되도록 보장합니다. 스레딩, 중첩 제한, 작업 우선순위, 기여자 신호에 대한 규칙을 정의함으로써 이 시스템은 '정보 잡탕'을 방지하고 사용자가 트래픽이 많은 환경에서 가장 가치 있는 기여를 찾을 수 있도록 돕습니다.

사용 사례

  • 커뮤니티 포럼: 틈새 커뮤니티를 위한 스레드형 토론 설계.
  • 기사/블로그 댓글: 장문 콘텐츠에 대한 독자 피드백 활성화.
  • SaaS 협업: 프로젝트 작업, 문서 또는 풀 리퀘스트 내에서 내부 토론 구조화.
  • 지원 Q&A: 고객 질문과 직원 응답 구성.
  • 소셜 피드: 공유 게시물이나 미디어에 대한 상호 작용 관리.

사용하지 말아야 할 경우

  • 직접 메시징(채팅): 실시간 1:1 또는 소규모 그룹 메시징의 경우 '메시지 버블'과 즉시 전송에 최적화된 레이아웃을 사용합니다.
  • 공지 전용 피드: 사용자가 답글을 달거나 상호 작용할 수 없는 경우, 간단한 알림 목록으로 충분합니다.
  • 상호 작용이 적은 페이지: 페이지에 총 3개 미만의 댓글이 예상되는 경우 스레딩 없는 플랫 목록이 더 효율적입니다.
  • 트랜잭션 로그: 자동화된 시스템 감사 로그의 경우 timeline-activity-system을 사용하세요.

입력

  1. 계층 모델: 스레드의 깊이는 얼마나 될까요? (플랫, 중첩 또는 하이브리드).
  2. 사용자 신원 데이터: 아바타, 표시 이름 및 역할 (예: 중재자, 작성자, 직원).
  3. 참여 지표: 투표 수 (찬성/반대), 답글 수 및 타임스탬프.
  4. 컨텍스트 메타데이터: '구매 확인', '최고 기여자' 또는 '작성자' 배지.

출력

  1. 댓글 구성 사양: 단일 댓글 '노드'의 시각적 정의 (아바타, 메타, 본문, 작업).
  2. 스레딩 청사진: 들여쓰기 증가분 및 수직 '스레드 라인'을 포함한 중첩 공간 규칙.
  3. 작업 계층 맵: '답글', '투표', '수정' 및 '신고'에 대한 우선순위 순위.
  4. 반응형 적응 전략: 모바일에서 스레드 축소 또는 레이아웃 평면화 규칙.

워크플로

1. 댓글 구조 정의

일관된 '노드' 구조 설정:

  • 헤더: 사용자 아바타 (중첩 수준에 따라 크기 조정), 표시 이름, 역할 배지 및 상대적 타임스탬프 (예: '2시간 전').
  • 본문: 텍스트 콘텐츠, 필요에 따라 마크다운 또는 리치 텍스트 지원.
  • 작업 표시줄: 기본 (답글, 투표) 및 보조 (공유, 신고, 수정) 작업.

2. 스레딩 및 중첩 규칙 수립

답글 간의 공간 관계 관리:

  • 들여쓰기: 중첩된 답글에 일관된 증가분 사용 (예: 24px 또는 1.5rem).
  • 스레드 라인: 미세한 수직선(1px 너비)을 사용하여 답글을 상위 댓글과 시각적으로 연결.
  • 중첩 제한: 스레드를 평면화하거나 새 보기로 연결하는 '이 스레드 계속하기' 링크가 필요해지기 전에 최대 깊이 설정 (보통 3-5 수준).

3. 작업 우선순위 지정

모든 작업이 동일하지는 않습니다. 시각적 가중치를 사용하여 사용자 안내:

  • 기본: '답글' 및 '투표'는 즉시 보여야 함.
  • 보조: '공유' 또는 '링크'는 텍스트 전용 또는 아이콘 전용일 수 있음.
  • 오버플로: '수정', '삭제' 및 '신고'는 '더보기'(생략 부호) 메뉴 안에 배치하여 복잡성 감소.

4. 신호 및 신뢰 구현

시각적 단서를 사용하여 컨텍스트 제공:

  • 작성자/직원 강조: 원저작자 또는 공식 직원에게 고유한 배경색 또는 눈에 띄는 배지 사용.
  • 새 댓글/강조 댓글: 미묘한 배경 페이드 또는 왼쪽 테두리 악센트를 사용하여 읽지 않거나 새로 게시된 댓글 신호.
  • 투표 시각화: 활성 상태일 때만 색상 사용 (예: 찬성은 주황색, 반대는 파란색).

5. 반응형 적응 계획

스레드는 가로 공간을 빠르게 소비합니다. 좁은 뷰포트에 맞게 조정:

  • 모바일 평면화: 모바일에서 들여쓰기 증가분 감소 (예: 24px에서 8px로) 또는 평면화 전에 중첩을 2단계로 제한.
  • '전체 화면' 피벗: 깊은 스레드의 경우 답글을 탭하면 해당 답글과 하위 답글이 전용 전체 너비 '포커스 모드'로 열리도록 허용.

의사 결정 규칙

  • 들여쓰기 vs. 평면: '발견'(상위 컨텍스트가 중요한 경우)에는 들여쓰기를 사용합니다. '작업' 환경(최신 정보가 우선인 경우)에서는 '@멘션' 참조가 있는 평면 목록을 사용합니다.
  • 투표 표시: 커뮤니티에 '자율 규제'가 필요한 경우에만 반대 투표를 표시합니다. 대부분의 긍정적 성장 환경에서는 찬성 투표만 표시합니다.
  • 기본 정렬: 커뮤니티의 경우 기본적으로 '최고'(가중 점수)로 정렬하지만, 시간에 민감한 협업 도구의 경우 '최신'으로 정렬합니다.
  • 자르기 규칙: 매우 긴 댓글(500단어 초과)은 '더 읽기' 버튼으로 잘라내어 스레드의 수직 리듬을 유지합니다.

제약 조건

  • 접근성: 댓글은 키보드로 탐색 가능해야 합니다 (Tab으로 작업 이동). 시맨틱 HTML 사용 (<article> for 댓글, <ul>/<li> for 중첩). 모든 작업에는 명확한 레이블이 있어야 합니다. '스레드 라인'은 순전히 장식용이어야 하며 (ARIA에서 숨김) aria-hidden="true"를 사용합니다.
  • 반응성: 들여쓰기로 인해 콘텐츠가 화면 가장자리 밖으로 밀려나서는 안 됩니다. 중첩 블록에 고정 너비 대신 컨테이너에 padding-left 또는 margin-left를 사용합니다.
  • 성능: 트래픽이 많은 스레드(>100개 댓글)의 경우 '지연 로딩' 또는 '더 보기' 페이지네이션을 사용하여 초기 렌더링 시간이 길어지는 것을 방지합니다.

일반적인 실패 패턴

  • 들여쓰기 죽음: 텍스트가 화면 오른쪽에서 1문자 너비가 될 때까지 무한 중첩 허용.
  • 작업 과부하: 모든 댓글 아래에 10개 이상의 버튼을 표시하여 '아이콘 바다' 생성.
  • 보이지 않는 계층: '작성자'와 일반 댓글 작성자를 구분하지 못하여 공식 답변을 찾기 어렵게 만듦.
  • '상위 분실': 스레드 라인이 없는 깊은 스레드는 어떤 답글이 어떤 상위 댓글에 속하는지 추적하기 어렵게 만듦.
  • 상태 누락: 사용자가 댓글을 제출할 때 '보류 중' 또는 '전송 중' 상태를 표시하지 않음.

검증 기준

  • 중첩 깊이가 제한되고 평면 또는 '포커스' 보기로 전환됩니다.
  • 시각적 계층이 작성자, 직원 및 일반 사용자를 구분합니다.
  • 스레드 라인이 답글을 상위 댓글에 명확하게 연결합니다.
  • 기본 작업 (답글/투표)이 보조 작업보다 시각적으로 두드러집니다.
  • 들여쓰기가 모바일 뷰포트에 맞게 조정되어 가로 오버플로를 방지합니다.
  • 댓글이 중첩 목록 또는 기사로 시맨틱하게 마크업됩니다.
  • 작업 버튼에는 최소 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.

관련 스킬