포트폴리오 전시 생성기
기술 프로젝트를 채용 담당자, 인사 관리자, 아키텍트, 기술 리더 등 다양한 대상에 최적화된 전문 포트폴리오 작품으로 변환하는 종합 스킬입니다.
핵심 기능
- 코드 분석 - GitHub 저장소 구조, 기술 스택, 아키텍처 패턴 분석
- 대상 맞춤형 콘텐츠 - 경영진, 아키텍트, 기술 팀을 위한 콘텐츠 생성
- 아키텍처 시각화 - 시스템, 데이터 흐름, 배포 다이어그램 생성
- 영향 정량화 - 비즈니스 지표와 기술 성과 추출 및 제시
- 다중 형식 출력 - 경영진 요약, 기술 심층 분석, 인터뷰 스토리, 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단계: 입력 수집
-
프로젝트 소스 요청:
- GitHub 저장소 URL/경로
- 기존 문서
- 프로젝트 노트
-
컨텍스트 이해:
- 이 프로젝트가 해결한 문제는 무엇인가요?
- 누구를 위한 것이었나요?
- 당신의 역할은 무엇이었나요?
- 무엇이 도전적이었나요?
- 결과는 어땠나요?
-
출력물 명확히 하기:
- 어떤 결과물이 필요한가요?
- 특별한 요구 사항이 있나요 (길이, 집중 분야)?
- 대상 청중은 누구인가요?
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 문서 스캐너 프로젝트를 전시하고 싶어. 컴퓨터 비전을 사용하여 화이트보드에서 데이터를 추출하고 여러 시스템과 통합해. 포트폴리오 사이트를 위한 자료를 만드는 데 도와줄 수 있어?"
사용자 팁
최상의 결과를 얻으려면:
- 가능하면 GitHub 액세스 제공 (가장 풍부한 정보 소스)
- 프로젝트의 "이유" 공유 (비즈니스 컨텍스트 중요)
- 추적한 지표 포함 (비공식적인 것이라도)
- 극복한 과제 언급 (훌륭한 스토리가 됨)
- 대상 청중 명시 (기술 깊이가 크게 다름)
- 자랑스러웠던 점이나 배운 점 언급 (진정성 있는 세부 사항 공감)
피해야 할 일반적인 실수:
- 너무 겸손해지는 것 (포트폴리오는 겸손할 자리가 아님)
- 성과 대신 작업 나열 ("API 구축" vs "지연 시간을 40% 줄인 API 설계")
- 비기술 청중을 위해 맥락 없이 전문 용어 사용
- 영향 정량화를 잊음
- 팀 보고서처럼 들리게 하지 말고 자신의 기여 강조