isjiamu/gzh-design-skill

해결하는 문제

Markdown을 사용하여 위챗 공식 계정용으로 시각적으로 매력적이고 전문적인 레이아웃을 만드는 어려움을 해결합니다. 특히 HTML을 위챗 에디터에 붙여넣을 때 서식이 깨지는 '스타일 손실' 문제를 해결하며, 모든 스타일을 엄격하게 인라인화하여 플랫폼의 제한적인 필터링 규칙을 준수하도록 합니다.

작동 원리

이 프로젝트는 AI 에이전트(Claude Code, Cursor, Codex 등)를 위한 '스킬'로 작동합니다. 에이전트는 Markdown 파일과 선택된 테마를 받아 콘텐츠를 파싱하고, 미리 정의된 컴포넌트 라이브러리를 사용하여 HTML 문서를 조립합니다. 품질을 보장하기 위해 이중 검증 시스템을 사용합니다. component_lint.py는 소스 컴포넌트 라이브러리의 안티 패턴을 확인하고, validate_gzh_html.py는 최종 HTML 출력물에 금지된 태그나 서식 오류가 없는지 배포 전에 검증합니다.

대상 사용자

Markdown으로 글을 쓰고, 긴 글, 튜토리얼, 보고서 등을 수동 서식 지정 없이 세련된 위챗 공식 계정 게시물로 변환하고 싶은 콘텐츠 크리에이터, 블로거, 분석가.

주요 특징

• 6가지 사전 구축 테마: 튜토리얼을 위한 'Moyu Green', 기술 리뷰를 위한 'Graphite Minimalist' 등 다양한 스타일 포함.
• 테마 생성기: 간단한 텍스트 설명이나 참조 이미지를 사용하여 완전히 새로운 사용자 지정 테마를 생성할 수 있습니다.
• 플랫폼 준수: 텍스트를 <span leaf="">로 감싸고 <style>이나 <div> 태그를 금지하는 등 위챗 특유의 제약 사항을 자동으로 처리합니다.
• 스마트 서식: 장 번호 추가, 키워드 밑줄 처리, 도입부 카드 및 목차 생성을 자동으로 수행합니다.
• 에이전트 독립적: 레이아웃 로직이 모델의 직관이 아닌 컴포넌트 라이브러리와 스크립트에 내장되어 있어 다양한 LLM(Claude, GPT, Gemini, DeepSeek 등)에서 작동합니다.