Communitygithub.com

tangshengming/personal_website

이력서 또는 프로필 소스에서 구조화된 콘텐츠를 추출하고, 검토 가능한 Markdown 소스 파일을 작성하며, 개인정보/대상 독자/디자인 결정을 확인한 후, 사이트 구조를 초안 작성하고 Astro 웹사이트를 스캐폴딩한 다음 로컬에서 확인하여 첫 번째 개인 웹사이트를 생성합니다. 사용자가 웹사이트 생성, 이력서로 개인 웹사이트 구축, PDF/LaTeX 이력서를 포트폴리오 사이트로 변환, 또는 이력서-웹사이트 워크플로 재현을 요청할 때 사용하세요.

personal_website란 무엇인가요?

이 스킬은 이력서(CV)에서 개인 웹사이트를 생성하는 전체 워크플로를 자동화합니다. 핵심 원칙은 페이지를 생성하기 전에 검토 가능한 소스 자료를 먼저 만드는 것입니다. PDF, LaTeX, DOCX 등 다양한 형식의 이력서/프로필 소스에서 구조화된 콘텐츠를 추출하여 Markdown 파일로 저장한 후, 사용자와 공개/비공개 정보, 대상 독자, 디자인 선호도를 확인합니다. 사이트 구조 초안을 작성한 후 기본적으로 Astro 프레임워크를 사용하여 현대적이고 확장 가능한 웹사이트를 스캐폴딩합니다. 마지막으로 로컬에서 빌드하고 실행하여 모든 것이 정상 작동하는지 확인합니다. 이 스킬은 Cursor, Claude Code, Codex 등 다양한 AI 어시스턴트에서 사용할 수 있으며, 개인 웹사이트를 체계적이고 안전하게 구축하려는 모든 사용자에게 유용합니다. 워크플로는 콘텐츠와 코드를 명확히 분리하여 유지보수와 확장이 용이합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangshengming/personal_website/tree/HEAD/.codex/skills/generate-website

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

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

문서

웹사이트 생성

개요

이 스킬을 사용하여 신중한 이력서-웹사이트 워크플로를 재현하세요. 핵심 원칙은 페이지를 생성하기 전에 검토 가능한 소스 자료를 만드는 것입니다. 먼저 이력서를 Markdown으로 추출한 다음, 무엇을 공개할지 결정하고, 구조화된 콘텐츠를 기반으로 웹사이트를 구축합니다.

워크플로

1. 작업 공간 확인

편집하기 전에 현재 프로젝트 파일을 확인하세요:

  • WEBSITE_WORKFLOW.md, PROJECT_STATUS.md 등과 같은 워크플로/상태 파일을 찾습니다.
  • 이력서/프로필 소스 파일을 찾습니다. 일반적으로 .pdf, .tex, .docx 또는 텍스트/Markdown 이력서입니다.
  • 웹사이트가 이미 존재하는지 확인합니다: package.json, astro.config.*, src/, public/, dist/.
  • 필요시 git status --short로 Git 상태를 간단히 확인합니다.

빈 프로젝트라고 가정하지 마십시오.

2. 이력서 읽고 검사하기

소스가 PDF인 경우:

  • PDF 스킬을 사용합니다.
  • pdfplumber 또는 다른 신뢰할 수 있는 PDF 텍스트 도구로 텍스트를 추출합니다.
  • 가능하면 페이지를 이미지로 렌더링하고 시각적으로 검사하여 레이아웃과 섹션 경계를 잘못 읽지 않도록 합니다.
  • PDF 텍스트 추출에는 간격/아이콘 아티팩트가 있을 수 있으므로 구조화된 출력에서 수동으로 정리합니다.

소스가 LaTeX인 경우:

  • .tex 소스를 직접 읽습니다.
  • 섹션 명령, 매크로, 목록을 구조로 처리합니다.
  • 사용자가 PDF 재생성을 요청하지 않는 한 로컬 LaTeX 컴파일이 필요하지 않습니다.

소스가 .docx인 경우:

  • 문서 스킬을 사용하여 구조와 콘텐츠를 추출합니다.

3. 검토 가능한 Markdown으로 추출

웹사이트 페이지를 구축하기 전에 Markdown 소스 파일을 만듭니다. 다음 위치를 선호합니다:

content/cv_extracted.md

다음과 같은 구조화된 섹션을 포함합니다:

  • 신원
  • 공개 연락처
  • 비공개 또는 숨겨진 연락처/세부 정보
  • 프로필
  • 언어
  • 기술 전문성
  • 전문 기술
  • 업무 경험
  • 학력
  • 출판물
  • 프로젝트
  • 각 프로젝트의 웹사이트 프레젠테이션 가능성

이 파일은 사실적으로 유지합니다. 최종 마케팅 카피가 아닌 소스 자료입니다.

4. 공개/비공개 결정 질문 또는 확인

개인 정보를 공개 웹사이트에 올리기 전에 다음을 확인합니다:

  • 공개 이메일
  • 전화번호 표시 여부
  • 생년월일 표시 여부
  • 전체 주소 표시 여부
  • 거주지/비자/운전면허증 세부 정보 표시 여부
  • 공개 또는 비공개 링크: GitHub, LinkedIn, Google Scholar, ORCID, ResearchGate 등
  • 선호하는 대상 독자: 산업계, 학계, 혼합, 고객, 채용 담당자, 협력자
  • 시각적 선호도: 미니멀, 학술적, 표현적인 기술 포트폴리오 등

기본 개인정보 보호 자세:

  • 사용자가 명시적으로 공개를 원하지 않는 한 생년월일, 전화번호, 전체 주소, 거주 허가, 운전면허증 및 유사한 민감한 세부 정보를 숨깁니다.
  • 공개 이메일, 도시/국가, 선택된 전문 링크를 선호합니다.

5. 웹사이트 구조 초안 작성

스캐폴딩하거나 페이지를 많이 편집하기 전에 구조 초안을 만듭니다. 다음 위치를 선호합니다:

WEBSITE_STRUCTURE_DRAFT.md

다음을 포함합니다:

  • 디자인 방향
  • 대상 독자
  • 탐색
  • 페이지 목록
  • 페이지 목적
  • 페이지별 제안 콘텐츠
  • 열린 질문 또는 결정 사항
  • 기술 권장 사항

좋은 첫 번째 구조:

  • 홈
  • 소개
  • 이력서
  • 프로젝트
  • 연락처

연구 중심 프로필의 경우 나중에 학술 웹 프레젠테이션 페이지를 위한 공간을 남겨둡니다.

6. 웹사이트 스캐폴딩

사용자가 다른 스택을 요청하지 않는 한 콘텐츠 중심 개인 웹사이트에는 기본적으로 Astro를 사용합니다.

제안된 구조:

src/
  pages/
    index.astro
    about.astro
    cv.astro
    projects.astro
    contact.astro
  content/
    profile.ts
    projects.ts
  layouts/
    BaseLayout.astro
  styles/
    global.css
public/

이력서 텍스트를 여기저기 하드코딩하지 말고 구조화된 소스 파일에서 웹사이트 콘텐츠를 구축합니다.

권장 콘텐츠 파일:

  • src/content/profile.ts: 신원, 프로필, 전문성, 경험, 학력, 출판물용.
  • src/content/projects.ts: 프로젝트 항목 및 나중 프레젠테이션 노트용.

공개 자산을 public/에 복사합니다:

  • 사용자가 다운로드 가능한 이력서를 원하는 경우 이력서 PDF.
  • 가능하고 승인된 경우 초상화 이미지.
  • 나중에 프로젝트 이미지 또는 그림.

7. 첫 번째 버전 디자인

첫 번째 개인 사이트의 경우:

  • 첫 화면은 마케팅 랜딩 페이지가 아닌 실제 신원/프로필로 만듭니다.
  • 가능한 경우 실제 시각 자산을 사용합니다.
  • 연락처 정보는 개인정보 보호에 신경 씁니다.
  • 빠르게 스캔할 수 있지만 나중에 확장할 수 있는 페이지를 구축합니다.
  • 산업계 대상의 경우 엔지니어링 유용성, R&D 워크플로, 기술적 깊이, 전이 가능한 역량을 강조합니다.
  • 학계 대상의 경우 연구 질문, 방법, 출판물, 프레젠테이션 흐름을 강조합니다.

첫 번째 버전을 과도하게 맞추지 마십시오. 향후 프로젝트 프레젠테이션 페이지를 위한 명확한 공간을 남겨둡니다.

8. 로컬에서 확인

다음을 실행합니다:

npm.cmd install
npm.cmd run build
npm.cmd run dev

Windows/PowerShell에서는 npm이 스크립트 실행 정책에 의해 차단된 경우 npm.cmd를 선호합니다.

Astro 텔레메트리가 작업 공간 외부에 쓰려고 하면 package.json에 스크립트를 다음과 같이 설정합니다:

"dev": "set ASTRO_TELEMETRY_DISABLED=1&& astro dev",
"build": "set ASTRO_TELEMETRY_DISABLED=1&& astro build",
"preview": "set ASTRO_TELEMETRY_DISABLED=1&& astro preview"

확인할 사항:

  • 빌드가 성공합니다.
  • 로컬 라우트가 200을 반환합니다.
  • 공개 자산이 로드됩니다.
  • 민감한 세부 정보가 실수로 표시되지 않습니다.
  • 가능한 경우 브라우저 시각적 QA를 수행하거나 사용자가 수동으로 검토합니다.

9. 상태 및 Readme 파일 업데이트

프로젝트에서 사용하는 경우 상태/대시보드 파일을 업데이트합니다. 예:

PROJECT_STATUS.md

유용한 지원 파일:

  • readme_website.txt: 웹사이트 편집, 미리보기, 빌드 및 커밋 방법.
  • readme_git.txt: Git 설정 및 일반 명령어.
  • WEBSITE_WORKFLOW.md: 장기 워크플로.

상태를 간결하게 유지합니다. 사용자가 요청하지 않는 한 Git 세부 정보로 복잡하게 만들지 마십시오.

출력 기대치

첫 번째 패스가 끝나면 프로젝트에 다음이 있어야 합니다:

  • 추출된 이력서 소스 Markdown.
  • 웹사이트 구조 초안.
  • 작동하는 Astro 사이트.
  • 페이지/레이아웃 코드와 분리된 콘텐츠.
  • 성공적인 빌드.
  • 로컬 미리보기 URL.
  • 보류 중인 사항에 대한 명확한 노트.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬