개인 사이트 구축
목표
개인 사이트 스킬 제품군을 안정적인 워크플로우로 조정합니다.
이는 오케스트레이션 스킬이지 구현 스킬이 아닙니다. 올바른 전문 스킬로 라우팅하고, 품질 관문을 적용하며, 현재 요청이 자연스러운 종료 지점에 도달할 때까지 워크플로우를 계속 진행해야 합니다.
하위 스킬의 상세한 구현 규칙을 복제하지 마십시오. 해당 단계에 도달하면 하위 스킬을 로드하고 따르십시오.
사용자 대상 '아이디어에서 개인 사이트로' 또는 원클릭 실행 요청의 경우 from-idea-to-personal-site를 선호하십시오. 이 스킬은 다음 단계 또는 하위 스킬 선택이 주요 문제일 때 하위 수준 라우팅 조정자로 사용하십시오.
계약
입력:
- 사용자 요청, 사이트 폴더 또는 원하는 출력 폴더, 참조, 신원 자료, 콘텐츠 자료 및 선택적 게시 대상.
- 사용자가 다음에 무엇을 해야 할지 물을 때 현재 워크플로우 상태.
출력:
- 선택된 워크플로우 경로 및 실행된 하위 스킬.
- 요청에 따라 로컬 정적 사이트, 검증된 기존 사이트, 가져온 콘텐츠, 집중 편집 또는 게시 준비.
- 사이트 폴더, 미리보기/게시 상태, 수행된 검증 및 남은 수동 단계가 포함된 인계 요약.
경계:
- 전문 하위 스킬이 적용되는 경우 하위 스킬 세부 정보를 직접 구현하지 마십시오.
- 기본적으로 모든 하위 스킬을 실행하지 마십시오. 요청을 충족하는 최단 체인을 선택하십시오.
- 명시적으로 요청되지 않는 한 게시, 푸시, 프로젝트 생성, 도메인 바인딩 또는 DNS를 변경하지 마십시오.
- 생성, 재생성, 개인화, 게시물 가져오기 또는 광범위한 편집 후에는
review-static-site를 건너뛰지 마십시오.
성공 관문:
- 선택된 하위 스킬 체인이 사용자의 자연스러운 종료 지점(방향 선택, 사이트 구축, 콘텐츠 추가, 사이트 검증, 편집 완료 또는 배포 준비/수행)에 도달합니다.
- 필수 품질 관문을 통과하거나 사용자가 문서화된 제한 사항을 명시적으로 수락합니다.
관문 실패 시:
- 실패한 관문을 가장 작은 책임 하위 스킬로 라우팅하십시오.
- 영향을 받는 검증을 다시 실행하십시오.
- 누락된 사용자 콘텐츠, 누락된 자격 증명, 사용할 수 없는 자산 또는 외부 계정 작업으로 인해 진행이 불가능한 경우에만 차단을 중지하고 보고하십시오.
하위 스킬
워크플로우 구성 요소로 다음 스킬을 사용하십시오.
search-blog-theme: 개인 사이트/블로그 테마 방향을 검색하고 비교합니다.find-style-references: 선택한 방향에 대한 실제 웹사이트/템플릿/스크린샷을 검색하고 검사하여 빌드 준비 참조 브리핑을 생성합니다.make-personal-site: 종속성이 없는 원본 정적 개인 사이트를 만듭니다.copy-website-style: 특정 참조 웹사이트의 스타일, 레이아웃, 모션 및 페이지 유형을 재현합니다.personalize-site: 플레이스홀더/데모/소스 신원을 사용자 고유의 콘텐츠로 교체합니다.add-blog-posts: Markdown, Obsidian 노트, Word 초안, 이전 HTML 게시물, 이미지, 수학, 링크 및 기타 작성물을 기존 사이트로 가져옵니다.edit-site-part: 특정 섹션, 구성 요소, 복사 블록, 스타일 세부 정보 또는 상호 작용에 대해 집중적인 로컬 변경을 수행합니다.review-static-site: 링크, 페이지 유형, 브라우저 렌더링, 인코딩, 플레이스홀더 잔여물, 직접 열기 호환성 및 경로 정확성에 대한 정적 출력을 검증합니다.publish-static-site: GitHub Pages, Cloudflare Pages, Netlify 또는 Vercel에 배포를 준비하거나 수행합니다.
하위 스킬 이름이 변경된 경우 목적이 일치하는 로컬에 설치된 스킬을 선호하십시오.
하위 스킬 계약 매트릭스
이 매트릭스를 사용하여 인계 및 수리 루프를 결정하십시오.
| 하위 스킬 | 필수 입력 | 예상 출력 | 성공 관문 | 관문 실패 시 |
|---|---|---|---|---|
search-blog-theme | 사용자 취향, 목적, 참조 또는 키워드 | 3-5개 방향, 검증된 참조 URL, 권장 사항 1개 | 방향이 구축할 수 있을 만큼 구체적임 | 더 많은 참조 검색, 은유 구체화 또는 선호도 질문 1개 |
find-style-references | 선택된 스타일 방향, 사이트 유형, 분위기 단어 또는 예시 | 4-8개의 실제 참조, 브라우저 관찰, 빌드 준비 디자인 브리핑 | 가능한 경우 여러 검색 각도와 최소 3개의 강력한 참조 검사 | 검색 확대, 더 강력한 참조 검사 또는 search-blog-theme로 복귀 |
make-personal-site | 방향, 콘텐츠/프로필 힌트, 페이지 범위, 출력 폴더 | 대표 페이지, 자산, EDITING.md가 포함된 일반 정적 사이트 | 필수 페이지 유형, 상대 경로, UTF-8 소스, 로컬 미리보기 | 구조/경로/자산 수정 후 review-static-site |
copy-website-style | 대상 URL/스크린샷/템플릿 및 범위 | 페이지 맵, 플레이스홀더/사용자 콘텐츠, EDITING.md가 포함된 정적 스타일 재현 | 서명 레이아웃/모션/페이지 유형이 요청된 충실도와 일치 | 대상 재검사, 재현 반복 후 review-static-site |
personalize-site | 기존 사이트 및 사용자 신원/콘텐츠 | 교체된 신원, 링크, 메타데이터, 자산, 플레이스홀더/소스 정리 | 사용자 콘텐츠가 표시되고 잔여물이 제거됨 | 콘텐츠 위치 재목록화 또는 레이아웃 맞춤을 위해 edit-site-part 사용 |
add-blog-posts | 기존 사이트 및 소스 게시물/자산 | 새 게시물 페이지, 업데이트된 인덱스/데이터, 복사된 자산, 편집 노트 | 게시물이 렌더링되고 링크/자산/수학/리치 콘텐츠가 작동함 | 변환/인덱스/자산 수정 또는 로컬 표시 문제에 edit-site-part 사용 |
edit-site-part | 기존 사이트 및 대상 페이지/영역/변경 사항 | 작은 범위의 코드/콘텐츠/스타일/상호 작용 편집 | 동일한 브라우저 영역에 관련 없는 손상 없이 요청된 변경 사항이 표시됨 | 소스 재매핑 및 더 작은 수정 편집 수행 |
review-static-site | 정적 루트, 예상 범위, 선택적 금지 문자열/참조 | 결과 또는 수정, 감사/브라우저 결과, 통과/실패 상태 | 차단 항목 없음 | 차단 항목을 가장 작은 책임 하위 스킬로 라우팅 |
publish-static-site | 검증된 배포 루트 및 선택한 플랫폼/모드 | 배포 설정/구성, 선택적 라이브 URL, 배포 후 확인 | 올바른 폴더가 배포되고 라이브 URL이 작동함 | 로컬 차단 항목, 배포 설정 또는 계정/DNS 단계 수정 |
운영 원칙
- 먼저 라우팅한 다음 실행하십시오. 광범위한 편집을 하기 전에 올바른 체인을 결정하십시오.
- 각 단계의 출력이 다음 단계에서 사용 가능하도록 유지하십시오.
- 이 버전에서는 사용자가 명시적으로 다른 스택을 요청하지 않는 한 일반 HTML/CSS/JS 및 종속성 없음을 선호하십시오.
- 개인 사이트나 블로그를 마케팅 랜딩 페이지로 만들지 마십시오.
- 사용자 데이터가 누락된 경우 세부적인 개인 정보를 만들어 내지 마십시오.
- 스타일 재현에서 기본적으로 복사된 소스 사이트 신원을 교체하십시오.
- 기본적으로 페이지 상대 링크 및 자산을 사용하십시오.
/assets/...또는/posts/...와 같은 루트 절대 사이트 로컬 경로는 피하십시오. - 생성, 재생성, 개인화, 게시물 가져오기 또는 광범위한 편집 후에는
review-static-site로 검증하십시오. - 사용자가 명시적으로 게시를 요청하지 않는 한 로컬에서 검증된 사이트에서 중지하십시오.
- 사용자가 명시적으로 요청하지 않는 한 리포지토리를 생성하거나, 코드를 푸시하거나, 배포하거나, 도메인을 바인딩하거나, DNS를 변경하지 마십시오.
정보 수집
다음 결정에 필요한 정보만 수집하십시오. 사용자에게 과도하게 인터뷰하지 마십시오.
유용한 입력:
- 원하는 출력 폴더 또는 기존 사이트 폴더.
- 사용자가 새 사이트, 참조 재현, 콘텐츠 가져오기, 개인화, 로컬 편집, 검증 또는 게시를 원하는지 여부.
- 참조 URL, 스크린샷, 템플릿 또는 테마 단어.
- 사용자 신원 자료: 이름, 약력, 링크, 이력서, 프로젝트, 아바타/로고, 이전 홈페이지, GitHub 프로필.
- 콘텐츠 자료: Markdown, Obsidian 노트, Word 문서, 이전 게시물, 이미지 폴더 또는 붙여넣은 텍스트.
- 게시 대상: GitHub Pages, Cloudflare Pages, Netlify, Vercel 또는 지침 전용.
요청이 충분히 명확하면 진행하십시오. 여러 경로가 매우 다른 작업을 생성하는 경우에만 간결한 질문을 하십시오.
라우터
사용자의 현재 상태에 따라 워크플로우를 선택하십시오.
- 막연한 아이디어 또는 '스타일 찾아줘': 원본 빌드 전에
search-blog-theme을 사용한 다음find-style-references를 사용하십시오. - 선택된 방향 및 특정 대상 사이트 없음:
find-style-references를 사용한 다음make-personal-site를 사용하십시오. - 정확히 일치시킬 특정 대상 URL/스크린샷/템플릿:
copy-website-style을 사용하십시오. - 여전히 플레이스홀더 또는 복사된 신원이 있는 기존 생성 사이트:
personalize-site를 사용하십시오. - 새 기사/노트/문서가 있는 기존 사이트:
add-blog-posts를 사용하십시오. - 하나의 작은 시각적/복사/레이아웃/상호 작용 변경이 있는 기존 사이트:
edit-site-part를 사용하십시오. - '이 사이트 확인해줘', '이걸로 충분한가요?', '게시 전에':
review-static-site를 사용하십시오. - '배포', '게시', 'GitHub Pages', 'Cloudflare Pages', 'Netlify', 'Vercel':
review-static-site후publish-static-site를 사용하십시오.
사용자가 완전한 원클릭 빌드를 요청할 때 실제 입력을 처리하는 최단 체인을 선택하십시오. 존재한다고 해서 모든 하위 스킬을 실행하지 마십시오.
경로 예시
다음 예시를 사용하여 라우팅을 안정화하십시오.
| 사용자 요청 패턴 | 경로 |
|---|---|
| '독특한 개인 블로그를 원해요, 스타일 선택을 도와주세요' | search-blog-theme |
| '빌드 전에 선택한 스타일에 대한 실제 참조를 찾아주세요' | find-style-references |
| '이 선택한 방향으로 개인 사이트를 만들어 주세요' | find-style-references -> make-personal-site -> review-static-site |
| '처음부터 완전한 개인 블로그를 구축해 주세요' | 필요한 경우 search-blog-theme -> find-style-references -> make-personal-site -> 콘텐츠가 있으면 personalize-site -> review-static-site |
| '이 URL을 참조로 사용하여 재현해 주세요' | copy-website-style -> personalize-site -> review-static-site |
| '이 웹사이트를 복사하지만 그 사람의 콘텐츠는 제 것으로 바꿔주세요' | copy-website-style -> personalize-site -> review-static-site |
| '여기 제가 생성한 사이트가 있습니다. 플레이스홀더를 제 약력/프로젝트/링크로 바꿔주세요' | personalize-site -> review-static-site |
| '이 Markdown/Obsidian/Word 문서를 사이트에 추가해 주세요' | add-blog-posts -> review-static-site |
| '이 섹션/색상/제목/카드/메뉴를 변경해 주세요' | edit-site-part; 공유 구조 또는 자산이 변경된 경우에만 review-static-site 추가 |
| '이 사이트가 준비되었는지 확인해 주세요' | review-static-site |
| '이것을 Cloudflare Pages/GitHub Pages/Netlify/Vercel에 배포해 주세요' | review-static-site -> publish-static-site |
| 'HTTP로는 로컬에서 작동하지만 index.html을 더블클릭하면 안 됩니다' | review-static-site; 게시 전에 경로 관문 실패 수정 |
표준 파이프라인
아이디어에서 원본 사이트로
사용자가 대략적인 목표나 스타일 선호도만 가지고 있을 때 사용하십시오.
- 시각적 방향이 불명확한 경우
search-blog-theme. - 선택한 방향을 실제 웹사이트/템플릿/스크린샷에 기반하기 위해
find-style-references. - 정적 사이트를 생성하기 위해
make-personal-site. - 사용자가 신원/콘텐츠를 제공했거나 사이트에 채워야 할 플레이스홀더가 있는 경우
personalize-site. - 하드 QA 관문으로
review-static-site. - 게시가 요청되지 않은 경우 로컬 미리보기 지침으로 중지.
참조에서 개인 사이트로
사용자가 일치시킬 대상 URL, 스크린샷, v0 템플릿, Figma 디자인 또는 기존 웹사이트를 제공할 때 사용하십시오.
- 레이아웃, 모션, 페이지 유형 및 상호 작용을 재현하기 위해
copy-website-style. - 대상 신원 및 플레이스홀더 콘텐츠를 교체하기 위해
personalize-site. - 사용자가 글쓰기 콘텐츠를 제공한 경우
add-blog-posts. - 하드 QA 관문으로
review-static-site. - 게시가 요청되지 않은 경우 로컬 미리보기 지침으로 중지.
콘텐츠 우선 블로그
사용자의 가장 강력한 입력이 기사, 노트, Markdown, Word 파일 또는 이전 글 아카이브일 때 사용하십시오.
- 사이트/테마가 없는 경우에만
search-blog-theme을 사용하십시오. - 새로운 원본 시각 시스템이 필요한 경우
find-style-references를 사용하십시오. - 정적 사이트가 아직 없는 경우
make-personal-site를 사용하십시오. - 콘텐츠를 기존 사이트의 게시물 시스템으로 가져오기 위해
add-blog-posts를 사용하십시오. - 신원/프로필 콘텐츠가 여전히 일반적인 경우
personalize-site를 사용하십시오. - 하드 QA 관문으로
review-static-site를 사용하십시오. - 게시가 요청되지 않은 경우 로컬 미리보기 지침으로 중지.
기존 사이트 개선
사용자에게 이미 생성된 사이트 폴더가 있을 때 사용하십시오.
- 사이트와
EDITING.md(있는 경우)를 검사하십시오. - 신원/콘텐츠 교체를 위해
personalize-site를 사용하십시오. - 기사 가져오기를 위해
add-blog-posts를 사용하십시오. - 집중적인 디자인 또는 복사 변경을 위해
edit-site-part를 사용하십시오. - 변경 사항이 탐색, 페이지 유형, 자산, 인코딩, 게시 준비 상태 또는 둘 이상의 페이지에 영향을 미치는 경우
review-static-site를 사용하십시오.
게시 준비 완료 사이트
사용자가 게시 또는 배포를 요청할 때 사용하십시오.
- 먼저
review-static-site를 사용하십시오. - 검토에서 문제가 발견되면 차단 항목을 수정하거나 관련 하위 스킬로 라우팅하십시오.
- 사이트가 필요한 로컬 검사를 통과하거나 사용자가 알려진 위험을 수락한 후에만
publish-static-site를 사용하십시오. - 배포가 발생하면 라이브 URL을 확인하십시오.
품질 관문
관련 관문이 통과되거나 사용자가 명시적인 제한 사항을 수락할 때까지 워크플로우가 완료되지 않습니다.
테마 관문:
- 시각적 방향 또는 참조가 구축할 수 있을 만큼 구체적입니다.
- 빌드가 원본이고 취향 단어를 기반으로 하는 경우, 여러 각도에서 실제 스타일 참조를 검색했으며 가능한 경우 최소 3개의 강력한 참조를 검사했거나 사용자가 해당 단계를 명시적으로 포기했습니다.
- 선택한 접근 방식이 사용자의 사이트 유형(블로그, 포트폴리오, 연구 홈페이지, 디지털 가든, 노트, 링크 또는 하이브리드)과 일치합니다.
구조 관문:
- 필수 페이지 유형이 존재하며 홈페이지만 있는 것은 아닙니다.
- 블로그형 사이트에는 최소 하나의 기사/세부 페이지와 목록/아카이브 진입점이 포함됩니다.
- 탐색이 실제 생성된 페이지를 가리킵니다.
콘텐츠 관문:
- 사용자 제공 신원/콘텐츠가 의도된 위치에 나타납니다.
- 플레이스홀더 전용 콘텐츠는 명확하게 표시되거나 교체됩니다.
- 사용자가 소유하거나 허가가 없는 한 스타일 재현에서 복사된 소스 사이트 신원이 제거됩니다.
경로 관문:
- 사이트 로컬 링크 및 자산은 기본적으로 페이지 상대 경로를 사용합니다.
- 중첩된 페이지는 올바른
../깊이를 사용합니다. - HTML, CSS
url(...), JavaScript 생성 링크, 데이터 파일, 커버 이미지, 글꼴 및 공급업체 자산은 실수로 루트 절대 경로를 사용하지 않아야 합니다. - 직접적인
index.html열기에서 CSS, JS, 이미지 또는 탐색이 손실되어서는 안 됩니다.
인코딩 관문:
- 모든 HTML 소스 파일은 UTF-8로 인코딩됩니다.
- 언어 메타데이터가
<html lang="...">에 설정됩니다. - 특수 문자(악센트, 수학 기호, 따옴표, 대시, 이모지)가 깨지거나 물음표로 대체되지 않아야 합니다.
플레이스홀더 관문:
- 'Lorem ipsum', 'John Doe', 'Your Name', '예시 링크', 데모 이메일, '곧 추가 예정' 또는 기타 일반적인 플레이스홀더 콘텐츠가 명시적으로 수용되지 않는 한 제거되거나 교체됩니다.
- 모든 이미지 자리 표시자는 합리적인 대체 텍스트가 있거나 제거됩니다.
- 사용자 데이터가 누락된 경우 명백히 플레이스홀더로 표시되거나 빈 상태로 유지됩니다.
렌더링 관문:
- 사이트가 로컬에서 열렸을 때 브라우저 콘솔 오류를 발생시키지 않아야 합니다.
- 레이아웃이 뷰포트 크기에서 허용 가능하게 나타납니다.
- 중요한 대화형 요소(탐색 링크, 카드, 버튼, 전환)가 분명히 깨지지 않습니다.
인계
워크플로우가 종료 지점에 도달하면 다음 정보를 명확하게 설명하십시오.
- 완료된 작업.
- 사이트가 위치한 폴더.
- 사이트가 로컬에서 어떻게 보이는지 확인하는 방법.
- 배포된 경우 라이브 URL.
- 수행된 검증.
- 배포 전에 수동으로 확인하거나 완료해야 할 사항 목록.
예시
다음은 정보 수집 및 라우팅 예시입니다.
예시 1: 블로그 스타일 찾기
사용자: 개인 블로그를 시작하고 싶은데 어떤 스타일이 좋을지 모르겠어요.
시스템: 알겠습니다. 취향과 목적을 이해하는 데 도움이 되는 몇 가지 질문을 드리겠습니다.
- 블로그의 주요 주제는 무엇인가요? (예: 기술, 여행, 요리, 개인 저널, 연구, 프로젝트 포트폴리오)
- 마음에 드는 블로그나 웹사이트가 있나요? URL을 공유해 주세요.
- 몇 가지 분위기 단어: 미니멀, 따뜻함, 대담함, 우아함, 장난기, 어두운, 밝은, 텍스트 중심, 시각적 중심
예시 2: 참조 URL에서 사이트 구축
사용자: 이 홈페이지 https://example.org와 비슷한 개인 사이트를 만들어 주세요.
시스템: 해당 URL을 검사하고 레이아웃, 색상, 타이포그래피 및 페이지 유형을 분석하여 copy-website-style을 사용하겠습니다.
복제 프로세스 중에 신원 정보(이름, 약력, 링크, 로고)를 제공해 주시겠어요? 그러면 예시 사이트의 콘텐츠를 여러분의 콘텐츠로 교체하겠습니다.
예시 3: 기존 사이트 개인화
사용자: ~/sites/my-site/에 생성된 사이트가 있습니다. 제 정보로 업데이트해야 합니다.
시스템: 사이트를 검사하겠습니다.
플레이스홀더 콘텐츠를 찾았습니다. personalize-site를 사용하겠습니다. 업데이트할 구체적인 섹션이 있나요, 아니면 제가 전체 사이트에서 찾은 모든 플레이스홀더를 교체할까요?
다음이 필요합니다: 이름, 약력(2-3문장), 링크(선택 사항: GitHub, LinkedIn, Twitter/X, 이메일), 프로젝트(선택 사항: 각각 제목, 간략한 설명, 링크), 프로필 사진/아바타(선택 사항: 경로).
예시 4: 콘텐츠 추가
사용자: ~/posts/에 있는 Markdown 파일을 내 사이트 ~/sites/my-blog/에 추가해 주세요.
시스템: add-blog-posts를 사용하여 해당 Markdown 파일을 가져오겠습니다.
사이트 구조를 확인하겠습니다. 게시물이 표시될 위치에 대한 선호 사항이 있나요? (예: 메인 블로그 페이지, 특정 카테고리 아래) 아니면 제가 자동으로 찾아서 추가할까요?