개인 사이트 만들기은(는) 무엇을 하나요?
목표
HTML, CSS 및 선택적 바닐라 JavaScript로 구성된 순수 정적 파일로 개인 웹사이트를 만들거나 재설계합니다.
이 스킬은 시각적 방향이 선택된 후의 구현 단계입니다. 테마 추천, 사용자 프로필, 메모, 샘플 게시물, 프로젝트 설명 또는 기존 정적 사이트 폴더를 실제 작동하는 개인 사이트로 전환합니다.
핵심 약속:
- 프레임워크 없음.
- 빌드 단계 없음.
- 패키지 설치 없음.
- 런타임 종속성 없음.
- 수동 미리보기를 위해
index.html을 직접 엽니다. - 페이지-상대적 링크와 자산을 사용하여 직접 파일 열기, 로컬 HTTP 및 정적 호스팅이 모두 작동합니다.
- 폴더를 정적 호스팅에 배포합니다.
자동화된 브라우저 QA를 위해 file:// URL을 여는 대신 로컬 HTTP를 통해 정적 폴더를 제공합니다.
계약
입력:
- 테마 방향, 사용자 프로필 자료, 페이지 요구 사항, 샘플 콘텐츠 또는 기존 정적 폴더.
- 고충실도 복제본을 요구하지 않고 스타일을 안내해야 하는 선택적 참조.
- 원하는 출력 폴더 및 정적 제약 조건.
출력:
- HTML, CSS, 선택적 바닐라 JavaScript, 로컬 자산 및 대표 페이지 유형이 포함된 순수 정적 사이트 폴더.
- 새 사이트 또는 주요 리디자인이 생성될 때 향후 편집을 위한
EDITING.md. - 로컬 미리보기 지침 및 검증 요약.
경계:
- 특정 대상 웹사이트를 밀접하게 재현하지 마십시오.
copy-website-style을 사용하십시오. - 대규모 글쓰기 아카이브를 가져오지 마십시오.
add-blog-posts를 사용하십시오. - 게시 또는 호스팅을 구성하지 마십시오.
publish-static-site를 사용하십시오. - 사용자가 명시적으로 요청하지 않는 한 프레임워크, 패키지 설치, 백엔드, CMS, 인증 또는 데이터베이스를 도입하지 마십시오.
성공 게이트:
- 필요한 페이지 유형이 존재하고 탐색이 실제 상대 경로를 가리킵니다.
- 사이트가 빌드 단계 없이 순수 정적 파일로 작동합니다.
- 소스가 UTF-8로 읽기 가능하고, 자리 표시자가 명확하며,
review-static-site가 통과하거나 허용된 제한 사항만 보고합니다.
게이트 실패 시:
- 이 스킬 내에서 누락된 페이지 유형, 경로, 자산, 인코딩, 자리 표시자 또는 브라우저 문제를 수정합니다.
- 실패 원인이 사용자 신원/콘텐츠 누락인 경우
personalize-site를 사용합니다. - 수정 후
review-static-site를 다시 사용합니다.
간단한 파이프라인
원본 개인 사이트 작업을 위해 다음 파이프라인을 따르십시오:
- 사이트 목적, 테마 방향, 사용 가능한 콘텐츠 및 페이지 범위를 명확히 합니다.
- 코딩 전에 정적 페이지 맵과 자리 표시자 전략을 결정합니다.
- 먼저 공유 셸(헤더, 탐색, 기본 레이아웃, 푸터, 전역 CSS 변수 및 공유 상호 작용)을 구축합니다.
- 홈 페이지와 요청되거나 암시된 모든 페이지 유형을 구현합니다.
- 사용자의 콘텐츠를 사용하거나 명확하게 교체 가능한 자리 표시자를 사용합니다. 상세한 개인 신원을 발명하지 마십시오.
- 향후 모델/사용자 편집을 위한 편집 가이드를 추가합니다.
- 상대 링크 및 자산과의 직접 열기 경로 호환성을 확인합니다.
- 실제 브라우저에서 HTTP를 통해 로컬로 검증합니다.
- 최종 전달 전에 링크, 자산, 페이지 유형 및 UTF-8 소스 가독성을 확인합니다.
사용 시기
사용자가 다음과 같은 경우 이 스킬을 사용하십시오:
- 일반 HTML/CSS/JS 개인 사이트, 블로그, 홈페이지, 포트폴리오, 연구 홈페이지 또는 정적 웹사이트를 원합니다.
search-blog-theme에서 생성된 테마 방향을 구현해 달라고 요청합니다.- 검사, 편집 및 배포가 쉬운 프레임워크 없는 간단한 사이트를 원합니다.
- 종속성 없이 기존 정적 사이트를 재설계하려고 합니다.
- 느슨한 시각적 참조를 제공하지만 고충실도 복제본을 요구하지 않습니다.
사용하지 말아야 할 때
다음과 같은 경우 이 스킬을 사용하지 마십시오:
- 사용자가 테마를 검색하거나 시각적 참조를 비교하기만 원하는 경우.
search-blog-theme을 사용하십시오. - 사용자가 특정 웹사이트의 모양, 레이아웃, 모션 또는 상호 작용 느낌을 밀접하게 재현하려는 경우.
copy-website-style을 사용하십시오. - 사용자가 많은 게시물을 마이그레이션하거나, Obsidian 노트를 변환하거나, 프론트매터를 수리하거나, 대규모 콘텐츠 아카이브를 이동하려는 경우.
add-blog-posts를 사용하십시오. - 사용자가 배포, DNS, GitHub Pages, Cloudflare Pages, Cloudflare Pages Direct Upload, Netlify 또는 Vercel 도움말만 원하는 경우.
publish-static-site를 사용하십시오. - 사용자가 Next.js, Astro, Hugo, Jekyll, Quartz 또는 React와 같은 프레임워크 프로젝트를 명시적으로 요청하는 경우.
- 사용자가 백엔드, 데이터베이스, 인증, CMS, 댓글 시스템 또는 동적 서버 동작을 요청하는 경우.
입력
사용자가 제공하는 모든 것을 사용하십시오. 일부 세부 정보가 누락되어도 차단하지 마십시오.
유용한 입력은 다음과 같습니다:
- 테마 방향: 개인 코드 아카이브, 연구 로그 대시보드, 디지털 가든, 벤토 포트폴리오, 필드 노트북, 개인 운영 체제 등.
- 사용자 프로필: 이름, 짧은 소개, 역할, 위치, 소셜 링크, 아바타, 이력서, 출판물, 프로젝트.
- 페이지 요구 사항: 홈, 소개, 블로그, 프로젝트, 노트, 출판물, 연락처.
- 샘플 콘텐츠: 1-3개의 게시물, 프로젝트 설명, Markdown 스니펫, 기존 HTML 페이지.
- 기존 사이트 폴더: 보존하거나 리팩터링할 현재 HTML/CSS/JS 파일.
- 느슨한 참조: v0, Figma, GitHub 테마, 프레임워크 템플릿, 스크린샷 또는 분위기 참조.
참조 규칙
참조는 모든 스택에서 올 수 있습니다. 사용자가 명시적으로 해당 프레임워크를 사용하도록 요청하지 않는 한, 이를 시각적 및 구조적 참조로 취급하고 구현 선택 사항으로 취급하지 마십시오.
순수 정적 사이트의 경우 참조를 다음과 같이 변환하십시오:
- React, Next 또는 Astro 컴포넌트 -> 재사용 가능한 CSS 클래스가 있는 반복 HTML 섹션.
- Tailwind 유틸리티 클래스 ->
assets/style.css의 일반 CSS 규칙. - 프레임워크 경로 -> 연결된
.html파일. - 콘텐츠 컬렉션 또는 CMS 데이터 -> 정적 HTML 목록 또는 작은 JSON 파일.
- 테마 구성 -> CSS 사용자 정의 속성.
- 간단한 상호 작용 -> 유용한 경우에만 바닐라 JavaScript.
사용자가 특정 웹사이트를 밀접하게 일치시키려는 경우 느슨한 참조로 취급하는 대신 copy-website-style으로 전환하십시오.
기본 사이트 구조
새 사이트의 경우 사용자가 달리 요청하지 않는 한 이 구조를 선호하십시오:
site/
index.html
EDITING.md
about.html
blog.html
projects.html
posts/
first-post.html
assets/
style.css
script.js
images/
data/
posts.json
profile.json
기존 사이트의 경우 실용적일 때 사용자의 현재 구조를 유지하십시오. 요청된 작업을 명확히 개선하지 않는 한 사이트의 큰 부분을 이름을 바꾸거나 재구성하지 마십시오.
페이지 기대 사항
사용자의 요청에 필요한 페이지만 생성하십시오. 완전한 개인 사이트 스타터에는 다음이 포함됩니다:
- 홈: 신원, 짧은 소개, 테마별 히어로 영역, 최근 게시물, 선택된 프로젝트.
- 소개: 약력, 관심사, 기술, 연락처, 소셜 링크, 선택적 이력서/출판물.
- 블로그 색인: 제목, 날짜, 태그 및 요약이 포함된 게시물 목록.
- 게시물 페이지: 제목, 날짜, 태그, 콘텐츠 및 블로그 색인으로 돌아가는 탐색이 포함된 읽기 쉬운 기사 레이아웃.
- 프로젝트: 설명, 스택, 링크 및 결과가 포함된 프로젝트 카드 또는 행.
첫 화면을 유용하게 만드십시오. 사용자가 개인 웹사이트나 블로그를 요청했을 때 마케팅 랜딩 페이지를 만들지 마십시오.
완전한 개인 사이트 또는 블로그 스타터의 경우 단일 홈페이지에서 멈추지 마십시오. 콘텐츠가 자리 표시자일지라도 작동하는 대표 페이지 유형을 만드십시오:
- 블로그용 게시물/세부 정보 페이지 하나 이상.
- 게시물, 노트, 프로젝트 또는 출판물이 사이트의 일부인 경우 목록 또는 아카이브 페이지.
- 홈 페이지가 신원 또는 배경 세부 정보에 연결되는 경우 프로필/소개 페이지.
- 선택한 개념에 의해 암시된 특수 페이지(예: 노트, 링크, 가든, now, uses, 출판물 또는 실험).
대규모 향후 콘텐츠 컬렉션의 경우 전체 아카이브를 발명하는 대신 구조와 몇 가지 대표 자리 표시자 항목을 만드십시오.
경로 호환성 규칙
생성된 순수 정적 사이트는 사용자가 index.html을 직접 열 때, 로컬 HTTP를 통해 제공될 때, 그리고 일반적인 정적 호스트에 배포될 때 작동해야 합니다.
기본 규칙:
- 모든 사이트 로컬 링크 및 자산에 페이지-상대적 경로를 사용하십시오.
- 루트 페이지에서 CSS/JS/이미지를
assets/style.css,assets/script.js,assets/images/avatar.png로, 페이지를about.html또는posts/example.html로 링크하십시오. posts/example.html과 같은 중첩 페이지에서 공유 자산을../assets/style.css로, 루트 페이지를../blog.html또는../index.html로 링크하십시오.- 사용자가 명시적으로 서버-루트 전용 동작을 수락하지 않는 한
/assets/style.css,/assets/script.js,/posts/example.html,/data/posts.json,/images/foo.png또는/와 같은 루트-절대 사이트 로컬 경로를 사용하지 마십시오. - CSS
url(...), 파비콘, Open Graph 이미지, 커버 이미지, 글꼴, KaTeX/수학 공급업체 자산, RSS/사이트맵 링크 및 JavaScript 생성 URL에 동일한 규칙을 적용하십시오. - 페이지를 이동하거나 추가할 때 루트 페이지에서 링크를 복사하는 대신 해당 페이지의 폴더 깊이를 기준으로 경로를 다시 계산하십시오.
서버 전용 가정을 피하십시오:
- 직접 열기 미리보기가 약속의 일부인 경우 핵심 탐색, 게시물 목록 또는 홈페이지 콘텐츠에 대해
fetch("data/posts.json")또는 기타 로컬 파일 가져오기에 의존하지 마십시오. - 반복 데이터가 유용한 경우 핵심 콘텐츠를 HTML에 직접 렌더링하거나 상대
<script src="assets/script.js">로 로드된 로컬 JavaScript 객체에 데이터를 저장하십시오. - 선택적 개선 사항은 해당 가져오기 없이도 페이지가 여전히 올바르게 읽히고 탐색될 때만 데이터 파일을 사용할 수 있습니다.
스타일 규칙
선택한 테마가 시각적 언어를 안내하도록 하되 사이트를 읽기 쉽고 유지 관리 가능하게 유지하십시오.
- 사이트 전체 스타일을
assets/style.css에 넣으십시오. - 색상, 간격, 테두리 및 타이포그래피 선택에 CSS 사용자 정의 속성을 사용하십시오.
- 가능한 경우
header,nav,main,article,section,footer와 같은 의미론적 HTML을 사용하십시오. - 모바일과 데스크톱에서 페이지가 작동하도록 반응형 레이아웃 규칙을 사용하십시오.
- 테마가 시각적으로 강렬한 경우 기사 페이지를 홈 페이지보다 차분하게 만드십시오.
- 사용자가 특정 글꼴을 요청하거나 테마가 글꼴을 강력히 필요로 하지 않는 한 시스템 글꼴을 선호하십시오.
- 사용자가 제공하거나 명백히 허용되지 않는 한 원격 자산에 의존하지 마십시오.
- 장식 효과가 읽기, 탐색 또는 접근성을 방해하지 않도록 하십시오.
상호 작용 규칙
명확한 가치를 더할 때만 바닐라 JavaScript를 사용하십시오.
좋은 용도:
- 모바일 탐색 전환.
- 테마 전환.
- 가벼운 태그 또는 게시물 필터링.
- 핵심 읽기에 영향을 주지 않는 작은 점진적 효과.
피해야 할 것:
- 무거운 애니메이션 프레임워크.
- 사용자가 명시적으로 요청하지 않는 한 캔버스 중심 장식.
- 개발 서버나 패키지 설치가 필요한 효과.
- 읽기를 해치는 지속적인 깜박임, 공격적인 글리칭 또는 스크롤 효과.
애니메이션 테마의 경우 prefers-reduced-motion을 존중하십시오.
정적 단순화 규칙
느슨한 참조에 복잡하거나 프레임워크 종속적인 기능이 있는 경우 이를 더 간단한 정적 등가물로 변환하십시오:
- 3D 지구본 -> 주제 맵, 상태 패널, 프로젝트 별자리 또는 정적 시각적 블록.
- 애니메이션 벤토 그리드 -> 미묘한 호버 상태가 있는 반응형 CSS 그리드.
- 터미널 시뮬레이터 -> 테마 탐색 및 로그 스타일 콘텐츠. 유용하지 않다면 가짜 명령줄 아님.
- 지식 그래프 -> 태그, 관련 게시물, 주제 색인 또는 수동으로 선별된 링크.
- 동적 검색 -> 간단한 필터 입력, 정적 태그 페이지 또는 첫 번째 버전에서는 검색 없음.
- CMS 기반 게시물 ->
posts/*.html및data/posts.json.
참조를 과도하게 구축한 복사본보다 사용자가 원하는 느낌을 포착하는 깔끔한 정적 버전을 선호하십시오.
기존 사이트 규칙
기존 사이트를 수정할 때:
- 편집하기 전에 현재 파일 구조를 검사하십시오.
- 사용자 콘텐츠 및 관련 없는 파일을 보존하십시오.
- 변경 사항을 요청된 페이지 및 자산으로 범위를 지정하십시오.
- 기존 시각적 규칙이 이미 작동하는 경우 이를 재사용하십시오.
- 사용자가 완전한 리디자인을 요청하지 않는 한 전체 사이트를 교체하지 마십시오.
- 사이트에 이미
style.css또는script.js가 있는 경우 충돌하는 중복을 만들지 말고 주의 깊게 확장하십시오.
콘텐츠 규칙
소량의 콘텐츠의 경우 정적 HTML을 직접 작성하십시오.
게시물이나 프로젝트와 같은 반복 콘텐츠의 경우 다음 중 하나를 사용하십시오:
- 목록이 짧은 경우 정적 반복 HTML.
- 유지 관리성을 향상시키는 경우 로컬 JavaScript 데이터 객체와 바닐라 JavaScript 렌더링.
- 해당 기능을 위해 사이트가 로컬 HTTP/정적 호스팅을 요구해도 되고 핵심 페이지가 여전히 작동하는 경우에만 작은 JSON 파일.
상세한 개인 사실을 발명하지 마십시오. 사용자 데이터가 없는 경우 자리 표시자를 명확하게 사용하십시오.
자리 표시자를 쉽게 찾고 교체할 수 있도록 유지하십시오. 반복 콘텐츠를 data/*.json, assets/script.js의 문서화된 데이터 블록 또는 안정적인 클래스 이름이 있는 반복 HTML 섹션과 같은 명확하게 명명된 장소에 저장하는 것을 선호하십시오.
사용자나 미래 모델이 게시 전에 교체할 수 있도록 파일 또는 EDITING.md에서 자리 표시자 전용 텍스트, 데모 게시물, 샘플 프로젝트 및 모의 링크를 명확하게 표시하십시오.
편집 가이드 규칙
새 사이트를 만들거나 기존 사이트를 실질적으로 재설계할 때 출력 폴더에 EDITING.md를 포함시키십시오.
EDITING.md는 주로 생성된 사이트를 나중에 수정할 미래 모델이나 에이전트를 위한 것입니다. 간결하지만 구체적으로 유지하십시오. 다음을 설명하십시오:
- 폴더 계층 구조와 각 파일/폴더의 용도.
- 사이트에서 사용하는 파일 형식: HTML, CSS, JS, JSON/데이터 블록 및 이미지.
- 페이지 맵: 생성된 파일 중 홈, 소개/프로필, 블로그/목록, 기사/세부 정보, 프로젝트, 노트, 링크 또는 기타 페이지 유형.
- 공유 레이아웃 영역: 헤더, 탐색, 모바일 탐색, 기본 콘텐츠, 푸터, 사이드바, 오버레이 또는 테마 컨트롤.
- 각 주요 홈페이지 영역이
index.html에 있는 위치, 근처 섹션/클래스 이름 사용. - 각 하위 페이지 템플릿이 있는 위치와 내부 링크가 연결되는 방식.
- 반복 콘텐츠가 저장되는 위치와 예상되는 객체/마크업 형식.
- 사이트 제목, 태그라인, 아바타/로고, 탐색, 추천 게시물, 프로젝트 목록, 링크 목록, 이미지, 색상 및 테마 변수를 변경하는 방법.
- 자리 표시자 전용 콘텐츠와 게시 전에 교체해야 하는 콘텐츠.
인코딩 무결성 규칙
생성된 소스 파일은 브라우저 스크린샷에서만 올바르게 보이는 것이 아니라 유효한 UTF-8이어야 하며 소스 형식에서 사람이 읽을 수 있어야 합니다.
중국어, 일본어, 한국어, 악센트가 있는 라틴 문자 또는 기타 비ASCII 콘텐츠가 포함된 페이지 또는 편집 가이드의 경우:
- HTML 파일에
<meta charset="utf-8">을 포함시키십시오. - 파일을 UTF-8로 작성하십시오.
- 최종 전달 전에 UTF-8 인식 리더로 소스 가독성을 확인하십시오.