Communitygithub.com

infinyte/portfolio-showcase-generator

기술 프로젝트를 채용 담당자, 아키텍트, 기술 리더 등 다양한 대상에 맞춘 포트폴리오 자료(경영진 요약, 기술 심층 분석, 아키텍처 다이어그램, 영향 지표, GitHub Pages)로 변환합니다.

portfolio-showcase-generator란 무엇인가요?

이 스킬은 GitHub 저장소와 프로젝트 설명을 분석하여 채용 담당자, 기술 리더 등 다양한 청중에게 최적화된 포트폴리오 자료를 생성합니다. 코드 분석, 아키텍처 시각화, 영향 지표 추출, STAR 형식의 인터뷰 스토리 생성, GitHub Pages 사이트 구축 등 6가지 핵심 기능을 제공합니다. Claude Code, Cursor, Codex와 같은 AI 에이전트에서 사용 가능하며, Mermaid 다이어그램, 마크다운, HTML 등 여러 형식의 결과물을 출력합니다. 프로젝트의 기술적 깊이와 비즈니스 영향을 모두 강조하여 개발자가 자신의 업무를 효과적으로 홍보할 수 있도록 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add infinyte/portfolio-showcase-generator

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

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

문서

포트폴리오 전시 생성기

기술 프로젝트를 채용 담당자, 인사 관리자, 아키텍트, 기술 리더 등 다양한 대상에 최적화된 전문 포트폴리오 작품으로 변환하는 종합 스킬입니다.

핵심 기능

  1. 코드 분석 - GitHub 저장소 구조, 기술 스택, 아키텍처 패턴 분석
  2. 대상 맞춤형 콘텐츠 - 경영진, 아키텍트, 기술 팀을 위한 콘텐츠 생성
  3. 아키텍처 시각화 - 시스템, 데이터 흐름, 배포 다이어그램 생성
  4. 영향 정량화 - 비즈니스 지표와 기술 성과 추출 및 제시
  5. 다중 형식 출력 - 경영진 요약, 기술 심층 분석, 인터뷰 스토리, GitHub Pages

이 스킬을 사용해야 할 때

사용자가 다음과 같은 작업을 원할 때 이 스킬을 사용하세요:

  • 기술 프로젝트를 포트폴리오 자료로 변환
  • 자신의 작업에서 설득력 있는 사례 연구 생성
  • 인터뷰 준비 자료(STAR 형식 스토리) 생성
  • 전문적인 GitHub Pages 전시 사이트 구축
  • 기술 성과에서 비즈니스 영향 추출
  • 대상별 프로젝트 요약 생성

입력 형식

이 스킬은 여러 입력 형식을 지원합니다:

1. GitHub 저장소

  • 저장소 URL 또는 로컬 경로
  • 분석 항목: 파일 구조, 코드 패턴, 기술 스택, 의존성, 문서
  • 추출 항목: 아키텍처 패턴(DDD, 마이크로서비스 등), 프레임워크, 클라우드 서비스

2. 프로젝트 컨텍스트 (모든 조합 가능)

  • 원시 노트/글머리 기호 - 성과와 세부 사항 빠른 캡처
  • 기술 명세 - 아키텍처 문서, 설계 문서
  • 대화형 - 사용자가 자연스럽게 프로젝트 설명
  • 기존 문서 - README 파일, 위키, ADR

3. 비즈니스 컨텍스트

  • 프로젝트 목표 및 마일스톤
  • 해결한 문제
  • 이해관계자 및 사용자
  • 일정 및 팀 규모
  • 제약 사항 및 과제

출력 생성

1. 경영진 요약 (인사 관리자/채용 담당자용)

목적: 비즈니스 가치와 결과에 초점을 맞춘 간결하고 강력한 개요.

구조:

  • 프로젝트 개요 (2-3문장): 무엇인지, 왜 중요한지
  • 주요 성과 (3-5개 글머리 기호): 정량화된 비즈니스 영향
  • 기술 하이라이트 (간략): 주목할 만한 기술/방법론
  • 일정 및 범위: 기간, 팀 규모, 역할
  • 영향 지표: 성능 향상, 비용 절감, 사용자 지표

어조: 전문적, 자신감, 결과 중심. 전문 용어 최소화. 결과를 앞세우기.

길이: 150-250단어 (30-60초 읽기)

2. 기술 심층 분석 (아키텍트/기술 리더용)

목적: 아키텍처 사고, 기술 깊이, 공학적 판단 입증.

구조:

  • 컨텍스트 및 제약 사항: 요구사항, 제약 사항, 기존 시스템
  • 아키텍처 결정: 근거가 포함된 주요 설계 선택
  • 기술 구현:
    • 시스템 아키텍처
    • 기술 스택 및 선택 이유
    • 적용된 패턴 (DDD, CQRS, 이벤트 소싱 등)
    • 통합 지점
  • 과제 및 해결 방안: 기술적 문제와 해결 방법
  • 규모 및 성능: 지표, 최적화 전략
  • 보안 및 품질: 테스트, 관찰 가능성, 보안 조치
  • 트레이드오프: 최적화한 부분, 희생한 부분, 이유

어조: 기술적이지만 접근 가능. 선택 자체보다 이유 설명. 판단력 보여주기.

길이: 800-1500단어 (4-6분 읽기)

3. 아키텍처 다이어그램 (Mermaid)

프로젝트 유형에 따라 적절한 다이어그램 생성:

시스템 아키텍처 다이어그램:

graph TB
    Client[클라이언트 애플리케이션]
    API[API 게이트웨이]
    Service1[서비스 이름]
    Service2[서비스 이름]
    DB[(데이터베이스)]
    Cache[(캐시)]
    
    Client --> API
    API --> Service1
    API --> Service2
    Service1 --> DB
    Service1 --> Cache

데이터 흐름 다이어그램:

flowchart LR
    Source[데이터 소스] --> Ingestion[수집 레이어]
    Ingestion --> Processing[처리]
    Processing --> Storage[(저장소)]
    Storage --> API[API 레이어]
    API --> Consumer[소비자]

배포 다이어그램:

graph TB
    subgraph Azure
        subgraph VNet
            AppService[앱 서비스]
            Function[Azure Functions]
        end
        DB[(SQL Database)]
        Storage[(Blob Storage)]
    end
    
    AppService --> DB
    Function --> Storage

지침:

  • 콘텐츠에 적합한 다이어그램 유형 사용
  • 다이어그램 집중 유지 (최대 5-12개 노드)
  • 명확하고 설명적인 레이블 사용
  • 필요한 경우 색상/모양에 대한 범례 포함
  • 프로젝트가 복잡한 경우 여러 다이어그램 생성

4. 지표 및 영향 분석

정량화 가능한 성과 추출 및 제시:

기술 지표:

  • 성능 개선 (응답 시간, 처리량 등)
  • 확장성 성과 (지원 사용자 수, 트랜잭션/초)
  • 코드 품질 (테스트 커버리지, 결함 감소)
  • 신뢰성 (가동 시간, MTTR, 오류율)
  • 보안 개선 (해결된 취약점, 준수 달성)

비즈니스 지표:

  • 비용 절감 (인프라, 개발 시간)
  • 수익 영향 (새로운 기능, 시장 확대)
  • 효율성 향상 (자동화, 수동 작업 감소)
  • 사용자 만족도 (NPS, 채택율)
  • 시장 출시 시간 (배송 속도, 릴리스 빈도)

형식: 맥락과 함께 구체적인 숫자로 제시:

  • "API 응답 시간 60% 감소 (450ms → 180ms)"
  • "리소스 최적화를 통해 클라우드 비용 연간 $24,000 절감"
  • "동시 사용자 1K → 10K로 10배 확장 가능"

5. 인터뷰 준비 (STAR 형식)

STAR 형식의 설득력 있는 스토리 2-4개 생성:

구조:

  • 상황(Situation): 컨텍스트, 문제, 제약 사항 (2-3문장)
  • 과제(Task): 자신의 특정 책임 (1-2문장)
  • 행동(Action): 수행한 작업, 기술적 결정, 구현 (3-5문장)
  • 결과(Result): 결과물, 지표, 영향 (2-3문장)

길이: 각 스토리는 말할 때 90-120초

초점: 각 스토리는 다음 중 다른 측면을 강조:

  • 기술적 문제 해결
  • 아키텍처 의사 결정
  • 리더십/영향력
  • 제약 사항/트레이드오프 처리

6. GitHub Pages 사이트

완전한 정적 사이트 구조 생성:

홈페이지 (index.html):

  • 프로젝트 이름과 태그라인이 있는 히어로 섹션
  • 빠른 통계 (기술 스택, 일정, 영향 지표)
  • 섹션 탐색
  • 가능한 경우 스크린샷/데모

아키텍처 페이지 (architecture.html):

  • 시스템 개요
  • 아키텍처 다이어그램 (Mermaid 포함)
  • 기술 스택 세부 사항
  • 설계 결정

영향 페이지 (impact.html):

  • 비즈니스 결과
  • 기술 성과
  • 지표 시각화
  • 이전/이후 비교

데모 페이지 (demo.html - 해당되는 경우):

  • 대화형 데모 또는 워크스루
  • 주석이 포함된 스크린샷
  • 사용 시나리오
  • 가능한 경우 비디오 포함

스타일링:

  • 깔끔하고 전문적인 디자인
  • 모바일 반응형
  • 빠른 로딩 (최소 의존성)
  • 접근성 (WCAG 준수)
  • 옵션: GitHub의 Primer CSS 또는 Tailwind CDN 사용

워크플로우

1단계: 입력 수집

  1. 프로젝트 소스 요청:

    • GitHub 저장소 URL/경로
    • 기존 문서
    • 프로젝트 노트
  2. 컨텍스트 이해:

    • 이 프로젝트가 해결한 문제는 무엇인가요?
    • 누구를 위한 것이었나요?
    • 당신의 역할은 무엇이었나요?
    • 무엇이 도전적이었나요?
    • 결과는 어땠나요?
  3. 출력물 명확히 하기:

    • 어떤 결과물이 필요한가요?
    • 특별한 요구 사항이 있나요 (길이, 집중 분야)?
    • 대상 청중은 누구인가요?

2단계: 분석 (GitHub 저장소가 제공된 경우)

bash/view 도구를 사용하여 저장소 분석:

# 저장소 구조 분석
find /path/to/repo -type f -name "*.cs" -o -name "*.csproj" | head -20
find /path/to/repo -type f -name "*.yml" -o -name "*.yaml"

# 아키텍처 문서 확인
find /path/to/repo -type f -name "*.md" | grep -i "architecture\|design\|adr"

# 의존성 분석
cat /path/to/repo/*.csproj
cat /path/to/repo/package.json
cat /path/to/repo/requirements.txt

# 구성 파일 확인
find /path/to/repo -name "appsettings*.json" -o -name "*.config"

추출 항목:

  • 기술 스택: 언어, 프레임워크, 데이터베이스, 클라우드 서비스
  • 패턴: DDD, 마이크로서비스, 이벤트 기반, CQRS 등
  • 아키텍처: 모놀리스, 마이크로서비스, 서버리스 등
  • 인프라: 클라우드 제공업체, 배포 전략
  • 품질 관행: 테스트, CI/CD, 모니터링

3단계: 콘텐츠 생성

위 구조에 따라 각 요청된 출력 유형 생성.

핵심 원칙:

  • 청중 우선: 깊이와 전문 용어를 청중에 맞춤
  • 증거 기반: 가능한 경우 코드/문서에 근거
  • 정량화: 항상 숫자와 지표 포함 시도
  • 스토리 중심: 과제 → 해결책 → 영향 강조
  • 정직: 제약 사항과 트레이드오프 인정

4단계: 아티팩트 생성

문서(요약, 심층 분석)의 경우:

  • 마크다운 형식 사용
  • 헤더가 있는 명확한 섹션 포함
  • 관련 코드 스니펫 추가
  • 다이어그램 포함

GitHub Pages의 경우:

  • 완전한 HTML 파일 생성
  • 인라인 CSS 포함 또는 CDN 참조
  • 모바일 반응형 보장
  • SEO용 메타 태그 추가

다이어그램의 경우:

  • Mermaid 차트 도구를 사용하여 렌더링
  • Mermaid 소스와 렌더링된 이미지 모두 제공
  • 다이어그램이 자명하도록 보장

5단계: 결과물 패키징

사용자 요구에 따라 출력물 구성:

채용 지원용:

  • 경영진 요약 (복사/붙여넣기 준비 완료)
  • 2-3개의 STAR 스토리
  • 주요 지표 목록

포트폴리오 사이트용:

  • 완전한 GitHub Pages 구조
  • 모든 자산 정리
  • 배포 지침

인터뷰용:

  • STAR 스토리 (인쇄/PDF)
  • 아키텍처 다이어그램 (화이트보딩 참고용)
  • 지표 치트 시트

특별 고려 사항

.NET/Azure 프로젝트

  • 강조: DDD 패턴, SOLID 원칙, async/await 패턴
  • 중점: 제로 트러스트, 정보 보안 준수, 엔터프라이즈 패턴
  • 기술 스택: .NET 버전, 사용된 Azure 서비스, 설계 패턴

머신러닝/컴퓨터 비전 프로젝트

  • 초점: 문제 프레이밍, 모델 선택 근거, 성능 지표
  • 강조: 훈련 접근 방식, 데이터 파이프라인, 추론 최적화
  • 지표: 정확도, 정밀도, 재현율, F1, 추론 지연 시간

통합 프로젝트

  • 강조: API 설계, 오류 처리, 데이터 일관성
  • 중점: 타사 통합, 속도 제한, 복원력 패턴
  • 지표: 신뢰성(가동 시간), 데이터 정확성, 처리량

엔터프라이즈/대규모 프로젝트

  • 컨텍스트: 규모, 규정 준수 요구 사항, 레거시 제약
  • 강조: 마이그레이션 전략, 이전 버전과의 호환성, 위험 완화
  • 지표: 확장 숫자, 부하 시 성능, 비용 최적화

출력 형식

여러 출력물을 생성할 때는 다음과 같이 구성:

# 포트폴리오 전시: [프로젝트 이름]

## 빠른 참조
- **기술 스택**: [목록]
- **기간**: [일정]
- **역할**: [역할]
- **영향**: [상위 1-2개 지표]

## 생성된 출력물

### 1. 경영진 요약
[내용]

### 2. 기술 심층 분석
[내용]

### 3. STAR 스토리
#### 스토리 1: [제목]
[내용]

#### 스토리 2: [제목]
[내용]

### 4. 아키텍처 다이어그램
[설명과 함께 다이어그램]

### 5. 지표 대시보드
[형식화된 지표]

### 6. GitHub Pages 파일
[파일 구조 및 내용]

품질 체크리스트

전달하기 전에 다음을 확인:

  • 모든 지표가 구체적이고 정량화되었는가
  • 기술 용어가 청중에 맞게 설명되거나 정당화되었는가
  • 다이어그램이 명확하고 적절하게 레이블링되었는가
  • STAR 스토리가 완전한가 (모든 4가지 요소)
  • 경영진 요약이 "엘리베이터 피치" 테스트를 통과하는가
  • 기술 심층 분석이 아키텍처 사고를 입증하는가
  • GitHub Pages가 모바일 반응형이고 접근 가능한가
  • 문법 오류나 오타가 없는가
  • 전체적으로 일관된 용어 사용
  • 성과가 단순한 작업이 아닌 영향으로 제시되었는가

예시 프롬프트

간단: "GitHub에 있는 내 DocFlow 프로젝트에 대한 포트폴리오 전시를 생성해줘"

상세: ".NET 8, DDD, Azure를 사용하여 비행 상태 대시보드를 구축했어. 제로 트러스트 환경에 배포된 최초의 앱이었어. 채용 담당자를 위한 경영진 요약과 인터뷰를 위한 기술 심층 분석, 그리고 아키텍처 다이어그램이 필요해."

대화형: "AI 문서 스캐너 프로젝트를 전시하고 싶어. 컴퓨터 비전을 사용하여 화이트보드에서 데이터를 추출하고 여러 시스템과 통합해. 포트폴리오 사이트를 위한 자료를 만드는 데 도와줄 수 있어?"

사용자 팁

최상의 결과를 얻으려면:

  1. 가능하면 GitHub 액세스 제공 (가장 풍부한 정보 소스)
  2. 프로젝트의 "이유" 공유 (비즈니스 컨텍스트 중요)
  3. 추적한 지표 포함 (비공식적인 것이라도)
  4. 극복한 과제 언급 (훌륭한 스토리가 됨)
  5. 대상 청중 명시 (기술 깊이가 크게 다름)
  6. 자랑스러웠던 점이나 배운 점 언급 (진정성 있는 세부 사항 공감)

피해야 할 일반적인 실수:

  • 너무 겸손해지는 것 (포트폴리오는 겸손할 자리가 아님)
  • 성과 대신 작업 나열 ("API 구축" vs "지연 시간을 40% 줄인 API 설계")
  • 비기술 청중을 위해 맥락 없이 전문 용어 사용
  • 영향 정량화를 잊음
  • 팀 보고서처럼 들리게 하지 말고 자신의 기여 강조

관련 스킬