개발자 포트폴리오 스킬

개발자 포트폴리오 스킬은(는) 무엇을 하나요?

핵심 정책

사용자가 업로드한 LinkedIn PDF/내보내기 파일 또는 붙여넣은 프로필 텍스트를 진실 공급원(source of truth)으로 사용합니다. LinkedIn을 스크래핑하거나 LinkedIn 인증을 우회하지 마십시오. 사용자가 LinkedIn URL만 제공한 경우, 프로필 PDF/내보내기 파일을 업로드하거나 프로필 텍스트를 붙여넣도록 요청하세요.

GitHub 쓰기 작업 전에 gh auth status를 확인하고, 필요한 경우 gh auth login이 필요함을 사용자에게 알리세요. 사용자가 명시적으로 자동 게시를 요청하지 않는 한, 푸시 전에 검토 가능한 초안을 제공하는 것을 선호합니다.

스크립트 및 참조 경로는 이 스킬 디렉토리를 기준으로 확인하세요. 생성된 README 파일, 포트폴리오 구성(config), 또는 GitHub 커밋에 로컬 절대 파일 시스템 경로를 복사하지 마십시오.

작업 흐름

1. 입력 수집

   • LinkedIn PDF/내보내기 파일 경로 또는 붙여넣은 LinkedIn 텍스트.
   • GitHub 사용자 이름, 또는 인증된 경우 gh api user --jq .login에서 추출.
   • 선택적 대상 리포지토리 이름. 기본값:
     • 포트폴리오: <github-username>.github.io
     • 프로필 README: <github-username>
   • 선택적 포트폴리오 템플릿 소스. 기본값: https://github.com/yashrajnayak/developer-portfolio.

2. 프로필 텍스트 추출

   • PDF의 경우 다음 실행:

     python scripts/extract_linkedin_pdf.py \
       --input <linkedin.pdf> \
       --out <workspace>/linkedin-profile.txt
     

   • 붙여넣은 텍스트의 경우, linkedin-profile.txt로 저장합니다.

3. 프로필 데이터 정규화

   • references/profile-schema.md를 읽습니다.
   • linkedin-profile.txt를 normalized-profile.json으로 변환합니다.
   • 원본에 충실하게 정보를 유지합니다. 고용주, 날짜, 학위, 자격증 또는 지표를 임의로 생성하지 마십시오.
   • GitHub 사용자 이름을 알고 있으면 github_username을 포함합니다.
   • 포트폴리오 기본 URL을 알고 있으면 portfolio_url을 포함합니다.

4. 포트폴리오 구성(config) 생성

   • 다음 실행:

     python scripts/write_portfolio_config.py \
       --profile normalized-profile.json \
       --out config.json \
       --github-username <github-username> \
       --portfolio-url https://<github-username>.github.io
     

   • 생성된 config.json을 클론/포크된 developer-portfolio 템플릿 리포지토리에 복사합니다.
   • 템플릿 리포지토리의 유효성 검사/빌드 명령어를 사용할 수 있으면 실행:

     npm run validate
     npm run build
     

5. 프로필 README 생성

   • 다음 실행:

     python scripts/write_profile_readme.py \
       --profile normalized-profile.json \
       --out README.md
     

   • 이 출력은 GitHub 프로필 리포지토리 <github-username>/<github-username>용입니다.

6. GitHub CLI로 게시

   • references/github-publish.md를 읽습니다.
   • 인증 확인:

     gh auth status
     gh api user --jq .login
     

   • 푸시 전에 생성된 포트폴리오 파일에서 로컬 경로를 검사합니다. 템플릿 리포지토리에 npm run validate가 있으면 사용합니다.
   • 의도적으로 커밋합니다. 강제 푸시(force-push)하지 마십시오. 기존 사용자 리포지토리를 현재 내용을 확인하지 않고 덮어쓰지 마십시오.

출력 예상 항목

반환:

• 사용된 소스 PDF/텍스트.
• 생성된 경로: normalized-profile.json, 포트폴리오 config.json, 및 프로필 README.md.
• 대상 GitHub 리포지토리.
• 실행된 유효성 검사 명령어.
• GitHub 푸시가 완료되었는지, 아니면 인증/검토 누락으로 차단되었는지 여부.

참조

• references/profile-schema.md: 정규화된 프로필 JSON 계약 및 매핑 규칙.
• references/github-publish.md: 안전한 GitHub CLI 게시 흐름.