generate-tech-stack은(는) 무엇을 하나요?
현재 프로젝트를 스캔하여 전체 기술 스택을 시각화한 페이지를 생성합니다.
단계
-
프로젝트 루트 찾기 — 사용자가 경로를 지정하지 않았다면 현재 작업 디렉터리를 사용합니다.
-
분석기 실행:
python3 ~/.claude/skills/generate-tech-stack/scripts/analyze.py <project_root> <project_root>/TECH_STACK.html -
출력 파일 열기:
xdg-open <project_root>/TECH_STACK.html 2>/dev/null || open <project_root>/TECH_STACK.html 2>/dev/null || true -
사용자에게 보고 — 다음을 포함합니다:
- 감지된 도구 수와 발견된 카테고리
- 출력 파일에 대한 클릭 가능한 링크
- 스크립트 표준 출력에서 가져온 카테고리별 한 줄 요약
출력 형식
생성된 HTML에는 다음 모든 섹션이 포함되어야 합니다 (스크립트가 자동으로 모두 생성합니다):
- 통계 행 — 큰 숫자 타일: 총 도구 · 카테고리 · AI 백엔드(있는 경우) · 데이터 저장소
- 아키텍처 다이어그램 — 계층형 흐름:
- 행 1: 당신의 애플리케이션 / LLM 애플리케이션 (보라색 상자)
- 행 2: 웹/API 프레임워크 (인증/미들웨어 부제목이 있는 녹색 상자)
- 행 3: AI SDK 상자 나란히 (파란색, 백엔드당 하나 — AI SDK가 감지된 경우에만)
- 행 4: 데이터베이스 상자 + 옵저버빌리티 + 프론트엔드 (어두운 행)
- 막대 차트 요약 — 가로 막대, 카테고리당 하나, 색상 일치
- 도구 카드 그리드 — 카테고리당 하나의 카드:
- 헤더: 색상 아이콘 상자 + 카테고리 제목 + 도구 개수
- 각 도구: 색상 점 · 이름 · 설명 · 배지 알약
- 푸터 — 프로젝트 이름 · 도구 개수 · 생성 날짜
디자인 토큰 (다크 모드)
| 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 프로젝트에서 작동합니다
- 아키텍처 다이어그램은 감지된 내용에 맞게 조정됩니다: 카테고리가 비어 있으면 해당 레이어가 생략됩니다