▶️25

[영상] GitHub 포트폴리오 작성법

Day 2: 데모 준비 - 3분 안에 9주를 증명하라

학습 목표

GitHub 프로필 README와 프로젝트 README의 차이를 설명할 수 있다 채용 담당자가 30초 안에 파악하는 포트폴리오 구조를 설계할 수 있다 Pinned Repository 6개 선정 기준을 적용할 수 있다 제조 AI 프로젝트를 GitHub에서 효과적으로 어필하는 방법을 실행할 수 있다

영상 핵심 정리 — GitHub 포트폴리오 작성법

채용 담당자가 보는 순서

1. GitHub 프로필 페이지 진입 (3초)
   → 프로필 README 상단 문구, 대표 기술 배지
2. Pinned Repository 6개 훑기 (15초)
   → 프로젝트명, 설명 한 줄, Stars/Language
3. 관심 Repo 클릭 → README 스크롤 (30초~2분)
   → Demo, 기술 스택, 핵심 기능, 실행 방법

Pinned Repo 선정 매트릭스

슬롯추천 유형제조 AI 예시
1대표 프로젝트 (복잡도 최고)YOLOv8 불량 검사 시스템
2AI·ML 핵심PaDiM 이상 탐지 파이프라인
3백엔드·APIFastAPI + PostgreSQL
4데이터 분석Pandas 불량률 대시보드
5협업·팀 프로젝트4인 스마트팩토리 해커톤
6학습·문서화알고리즘 스터디

README Above the Fold

# 🔍 스마트팩토리 불량 검사 시스템

![데모 GIF](demo.gif)  ← 반드시 포함

[![Python](https://img.shields.io/badge/Python-3.11-blue)]
[![YOLOv8](https://img.shields.io/badge/YOLOv8-8.0-green)]
[![License](https://img.shields.io/badge/License-MIT-yellow)]

> 컨베이어 벨트 실시간 불량 탐지 시스템. 99.3% 정확도, 5ms 추론.

## 빠른 시작
pip install -r requirements.txt && python detect.py

함정 주의: '열심히 개발했습니다', '부족하지만' 같은 자기 비하 문구를 넣으면 역효과. README는 채용 공고처럼 써라. 숫자로 증명하고 명사형으로 기술.

다음 task와의 연결

다음 reading에서 3분 데모 시나리오 구성법을 다룬다.

AI로 학습하기 — 꿀팁
🤖GitHub 프로필 README 초안 생성AI 학습 팁

AI 에이전트에게 제조 AI 도메인 개발자의 GitHub 프로필 README를 '내가 해결한 문제' 목록 중심으로 작성하게 하고, Pinned Repo 6개의 선정 기준을 검토하세요.

스마트팩토리 AI 개발자의 GitHub 프로필 README를 작성해줘. 자기소개가 아닌 '내가 해결한 문제' 목록(예지보전·GraphRAG·QLoRA 파인튜닝·비전검사 등) 중심으로 구성하고, Pinned Repo 6개를 도메인 다양성과 기술 스택 깊이 기준으로 선정하는 이유를 설명해줘. README 첫 화면(Above the fold)에 넣을 Demo GIF 대신 사용할 배지 조합도 제안해줘.
이 팁이 도움이 됐나요?
핵심 포인트
  • 프로필 README는 자기소개가 아니라 '내가 해결한 문제' 목록이다
  • Pinned Repo 6개는 도메인 다양성 + 기술 스택 깊이로 선정
  • README 첫 화면(Above the fold)에 Demo GIF 또는 배지를 넣어 이탈을 막는다
  • 회고·느낀점은 README 본문이 아닌 별도 블로그 링크로 분리