Communitygithub.com

generate-tech-stack

현재 프로젝트를 스캔하여 전체 기술 스택을 시각화한 HTML 페이지를 생성합니다.

generate-tech-stack란 무엇인가요?

이 스킬은 현재 프로젝트 디렉터리를 자동으로 분석하여 사용 중인 모든 기술(라이브러리, 프레임워크, 데이터베이스, AI SDK 등)을 파악하고, 이를 시각적으로 표현하는 TECH_STACK.html 파일을 생성합니다. 생성된 HTML 페이지는 도구 개수, 카테고리, AI 백엔드, 데이터 저장소를 나타내는 숫자 타일, 계층형 아키텍처 다이어그램, 카테고리별 막대 차트, 각 도구의 상세 정보를 담은 카드 그리드, 프로젝트명과 생성 날짜가 포함된 푸터로 구성됩니다. Python, Node.js, Go, Rust, Java, Ruby, PHP 프로젝트를 지원하며, 분석 스크립트가 없는 경우에도 requirements.txt, package.json 등 설정 파일을 통해 기술 스택을 추론합니다. 어두운 테마(다크 모드)의 디자인 토큰을 사용하여 전문적인 느낌의 보고서를 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add askuma/generate-tech-stack

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

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

문서

generate-tech-stack은(는) 무엇을 하나요?

현재 프로젝트를 스캔하여 전체 기술 스택을 시각화한 페이지를 생성합니다.

단계

  1. 프로젝트 루트 찾기 — 사용자가 경로를 지정하지 않았다면 현재 작업 디렉터리를 사용합니다.

  2. 분석기 실행:

    python3 ~/.claude/skills/generate-tech-stack/scripts/analyze.py <project_root> <project_root>/TECH_STACK.html
    
  3. 출력 파일 열기:

    xdg-open <project_root>/TECH_STACK.html 2>/dev/null || open <project_root>/TECH_STACK.html 2>/dev/null || true
    
  4. 사용자에게 보고 — 다음을 포함합니다:

    • 감지된 도구 수와 발견된 카테고리
    • 출력 파일에 대한 클릭 가능한 링크
    • 스크립트 표준 출력에서 가져온 카테고리별 한 줄 요약

출력 형식

생성된 HTML에는 다음 모든 섹션이 포함되어야 합니다 (스크립트가 자동으로 모두 생성합니다):

  1. 통계 행 — 큰 숫자 타일: 총 도구 · 카테고리 · AI 백엔드(있는 경우) · 데이터 저장소
  2. 아키텍처 다이어그램 — 계층형 흐름:
    • 행 1: 당신의 애플리케이션 / LLM 애플리케이션 (보라색 상자)
    • 행 2: 웹/API 프레임워크 (인증/미들웨어 부제목이 있는 녹색 상자)
    • 행 3: AI SDK 상자 나란히 (파란색, 백엔드당 하나 — AI SDK가 감지된 경우에만)
    • 행 4: 데이터베이스 상자 + 옵저버빌리티 + 프론트엔드 (어두운 행)
  3. 막대 차트 요약 — 가로 막대, 카테고리당 하나, 색상 일치
  4. 도구 카드 그리드 — 카테고리당 하나의 카드:
    • 헤더: 색상 아이콘 상자 + 카테고리 제목 + 도구 개수
    • 각 도구: 색상 점 · 이름 · 설명 · 배지 알약
  5. 푸터 — 프로젝트 이름 · 도구 개수 · 생성 날짜

디자인 토큰 (다크 모드)

CSS 변수값용도
--bg#0f172a페이지 배경
--bg2#111827보조 배경
--bg3#161e2e카드/차트 배경
--bg4#1a2535상승된 표면
--border#1e293b카드/섹션 테두리
--border2#263347호버 테두리
--text#f1f5f9주요 텍스트
--muted#64748b보조/레이블 텍스트
--dim#334155푸터/구분선 텍스트
--green#22c55e강조 (배지 점, 통계 강조)
--mono'JetBrains Mono', monospace코드/배지 글꼴
--sans'IBM Plex Sans', system-ui, sans-serif본문 글꼴

글꼴은 Google Fonts에서 로드됩니다:

IBM Plex Sans:wght@300;400;500;600;700
JetBrains Mono:wght@400;500;600

제목 h1: color:#f8fafc, 그라데이션 없음. 막대 차트 트랙: background:#0a0f1a.

대체 (스크립트를 찾을 수 없는 경우)

~/.claude/skills/generate-tech-stack/scripts/analyze.py를 찾을 수 없는 경우:

  • requirements.txt, package.json, go.mod, Cargo.toml, pyproject.toml 읽기
  • Dockerfile, docker-compose.yml, .github/workflows/, alembic.ini 확인
  • 각 도구의 카테고리와 목적 식별
  • 위의 디자인 토큰과 섹션 구조를 사용하여 TECH_STACK.html 작성

참고 사항

  • 항상 기존 TECH_STACK.html을 덮어씁니다 — 확인을 요청하지 마세요
  • Python, Node.js, Go, Rust, Java, Ruby, PHP 프로젝트에서 작동합니다
  • 아키텍처 다이어그램은 감지된 내용에 맞게 조정됩니다: 카테고리가 비어 있으면 해당 레이어가 생략됩니다

관련 스킬