PRO Portfolio DEV
GitHub 사용자 입력 → 라이브 포트폴리오 출력. 스크립트는 가져오기, 빌드, 검사, 게시를 처리하고;
사용자는 오직 하나, 즉 프로젝트를 선택하고 정직하고 간결한 카피를 작성하는 일만 하면 됩니다.
경로는 이 스킬 폴더 기준입니다. 작업은 임시 폴더(예: portfolio/)에서 진행합니다.
1 · 가져오기 (사실만)
python3 scripts/fetch.py USER --out portfolio/repos.json (공개 API 호출 2회, 토큰 불필요).
상위 저장소를 출력합니다. 이것이 사용할 수 있는 유일한 사실입니다. 스타, 사용자, 결과를 절대 임의로 만들지 마세요.
2 · 기획 (질문한 후 portfolio/plan.json 작성)
한 메시지로 질문하고, 기본값은 사용자가 "go"라고 말하면 수락할 수 있게 하세요:
- 누가, 누구를 대상으로: 이름, 역할, 대상 (채용 담당자, 고객, 동료). 기본값: GitHub 이름과 소개.
- 프로젝트: 가장 강력한 4~9개를 제안(스타, 최근 푸시, 홈페이지 여부, 명확한 설명 기준); 사용자가 선택.
- 스킬 및 경험 (선택사항, 검색 가능하게), 연락처 링크.
- 호스팅 위치:
USER.github.io(루트) 또는 저장소의docs/폴더. URL은 최종이어야 합니다.
그런 다음 plan.json을 작성합니다(스키마 및 카피 규칙: references/plan.md). 카피 규칙 요약: 헤드라인 ≤8단어, 태그라인은 무엇을 + 누구를 위한 것인지 설명, 각 프로젝트는 한 줄로 장점(기술 스택이 아닌 혜택)을 쓰고, 선택적으로 해당 README나 GitHub 데이터에서 발견한 숫자를 인용하는 proof 줄을 추가하세요. 절대 임의로 만든 숫자를 사용하지 마세요.
언어: 10개 언어의 UI 문자열이 scripts/ui.json에 포함되어 있습니다. 사용자의 카피를 번역하려면 plan.t.<lang>을 추가하고, 원어민 작가가 그 언어로 말할 법한 방식으로 의미를 번역하세요. 단어 그대로가 아닙니다 (references/plan.md, "번역" 참조). 그런 다음 각 언어를 원어민 독자로서 다시 읽고 직역처럼 들리는 부분을 수정하세요.
3 · 빌드 및 검사
python3 scripts/build.py portfolio/repos.json portfolio/plan.json --out portfolio/site
python3 scripts/check.py portfolio/site
check.py가 PASS를 출력해야 합니다. 게시하기 전에 브라우저에서 portfolio/site/index.html을 열고 확인하세요:
검색에 오타를 넣어보고, 아랍어(오른쪽에서 왼쪽) 및 어두운 테마로 전환해보세요.
4 · 게시 (외부: 먼저 물어보기)
페이지와 대상을 사용자에게 보여주고 승인을 받으세요. 그 다음:
bash scripts/publish.sh portfolio/site REPO_CLONE URL [--folder root|docs] --yes
커밋, 푸시, 필요한 경우 Pages 활성화, 새 빌드가 라이브가 될 때까지 폴링하여 LIVE … in N s를 출력합니다.
5 · 측정 및 보고
최대 4줄로 보고: 라이브 URL, LIVE 시간, check.py 점수, PageSpeed Insights(pagespeed.web.dev, 무료) 또는 설치된 경우 로컬 lighthouse의 Lighthouse SEO/접근성/성능.
완료 조건
check.py가 빌드된 사이트에 대해PASS출력.- 페이지의 모든 프로젝트는 사용자의 실제 저장소이며, 모든 숫자는 GitHub 데이터 또는 README에서 유래.
- 라이브 URL이 새 빌드를 반환(
publish.sh가LIVE출력), 또는 사용자가 게시를 선택하지 않음.
절대 하지 말 것
- 프로젝트, 메트릭, 고용주, 추천사를 임의로 만들지 말 것. 대신 물어볼 것.
- 사용자의 승인 없이 푸시, 게시 또는 Pages 활성화하지 말 것.
- 추적기, 분석, 쿠키, 외부 스크립트를 추가하지 말 것. 페이지는 타사 요청을 전혀 하지 않습니다.
- 변경 사항을 보여주지 않고 기존 사이트를 덮어쓰지 말 것(
--yes없이publish.sh실행은 드라이 런입니다).