사이트 개인화
목표
이미 생성된 정적 사이트를 템플릿, 데모, 또는 복사된 참조 사이트가 아닌 사용자 자신의 웹사이트처럼 느껴지도록 개인화합니다.
이 스킬은 콘텐츠와 메타데이터를 편집합니다. 테마 선택, 레이아웃 재설계, 참조 웹사이트 재생성, 대규모 글 아카이브 이전, 사이트 공개, 또는 프로젝트를 다른 프레임워크로 변환하는 작업은 수행하지 않습니다.
계약
입력:
- 기존 생성된 정적 사이트 폴더,
EDITING.md, 페이지 맵, 또는 핸드오프 노트. - 사용자가 제공한 신원/콘텐츠: 자기소개, 이력서, GitHub README, 예전 홈페이지, 소셜 링크, 프로젝트, 아바타/로고, 연락처 정보, 또는 특정 대체 내용.
- 기존 데이터 파일, JavaScript 데이터 블록, 메타데이터, 그리고 대체할 플레이스홀더/소스 사이트 콘텐츠.
출력:
- 개인화된 가시적 콘텐츠, 메타데이터, 링크, 이미지, 그리고 소스 수준의 신원 필드.
- 제거되거나 대체된 템플릿/데모/소스 사이트 잔재.
- 채워진 필드, 남은 플레이스홀더, 콘텐츠 위치를 설명하는 업데이트된
EDITING.md.
경계:
- 새 테마 선택, 레이아웃 재설계, 새 참조 사이트 재생성, 대규모 글 아카이브 가져오기, 사이트 공개, 또는 프레임워크 변환을 수행하지 마십시오.
- 구체적인 개인 사실, 고용주, 학교, 수상, 날짜, 위치, 또는 지표를 임의로 생성하지 마십시오.
- 최종 보고서에 사용자의 개인 데이터를 불필요하게 다시 붙여넣지 마십시오.
성공 조건:
- 사용자가 제공한 신원/콘텐츠가 브라우저에서 올바르게 보이는 위치에 나타납니다.
- 중요한 플레이스홀더와 소스 사이트 신원이 사라졌거나 의도적으로 문서화되었습니다.
- 변경된 내부 링크/에셋이 페이지 상대 경로와 유효성을 유지합니다.
review-static-site를 통과하거나 허용된 한계만 보고할 수 있습니다.
성공 조건 실패 시:
- HTML, 메타데이터, 데이터 파일, JavaScript 렌더링 콘텐츠를 재조사합니다.
- 놓친 플레이스홀더/소스 문자열을 대체합니다.
- 새 콘텐츠로 인한 작은 레이아웃 문제는
edit-site-part를 사용합니다. - 수정 후 다시
review-static-site를 사용합니다.
1. 입력
사용 가능한 모든 자료를 활용하세요:
- 정적 사이트 폴더, 일반적으로
site/,dist/,out/, 또는public/. - 다른 스킬의
EDITING.md, 페이지 맵, 또는 핸드오프 노트. - 사용자 제공 자기소개, 이력서, CV, GitHub README, 예전 홈페이지, 소셜 링크, 프로젝트 목록, 아바타, 로고, 또는 연락처 정보.
profile.json,posts.json,projects.json과 같은 기존 데이터 파일 또는assets/script.js의 데이터 블록.- 사용자의 특정 대체 지침.
중요한 정보가 누락된 경우, 구체적인 개인 사실을 임의로 생성하지 말고 명확한 플레이스홀더를 사용하세요.
2. 콘텐츠 인벤토리
편집 전에 개인 또는 플레이스홀더 콘텐츠가 있는 위치를 파악하세요.
확인할 항목:
- HTML 파일 및 하위 페이지.
<title>, 메타 설명, Open Graph/Twitter 메타데이터, 파비콘/로고 참조, 그리고 보이는 제목.- 헤더, 내비게이션, 히어로, 프로필/소개 섹션, 연락처 블록, 푸터, 사이드바, 카드, 오버레이.
- JSON 파일, JavaScript 데이터 블록, 또는 반복된 HTML 목록의 반복 콘텐츠.
- 글/상세 데모 페이지, 프로젝트 페이지, 노트 페이지, 링크 페이지, 특수 페이지.
EDITING.md지침 및 문서화된 콘텐츠 위치.
이름을 입력하세요, [email protected], example.com, lorem ipsum, 샘플 게시물, 샘플 프로젝트, TODO, 여기에 입력과 같은 일반적인 플레이스홀더 또는 데모 텍스트를 찾으세요.
3. 개인 신원 대체
가시적 및 소스 수준의 신원 필드를 일관되게 대체하세요.
일반적인 필드:
- 사이트 제목, 작성자 이름, 표시 이름, 역할, 태그라인, 짧은 자기소개, 위치, 가용성/상태, 관심 분야.
- 이메일, 소셜 링크, GitHub, X/Twitter, LinkedIn, Bluesky, RSS, 뉴스레터, 이력서/CV, 기타 사용자 제공 링크.
- 아바타, 로고, 파비콘, 대체 텍스트, 이미지 캡션, 프로필 레이블.
- 홈페이지 히어로 카피, 소개 페이지 카피, 연락처 카피, 푸터 텍스트, 메타데이터 설명.
구체적인 고용주, 학교, 수상, 출판물, 지표, 위치, 연도를 임의로 생성하지 마십시오. 사용자가 제공하지 않은 경우 중립적으로 유지하고 쉽게 대체할 수 있도록 하세요.
링크 또는 에셋을 대체할 때 정적 경로 호환성을 유지하세요:
- 사이트 로컬 링크와 에셋을 루트 절대 경로가 아닌 페이지 상대 경로로 유지하세요.
- 루트 페이지에서는
assets/avatar.png,about.html,posts/example.html과 같은 경로를 사용하세요. - 중첩된 페이지에서는 올바른 깊이를 사용하세요(예:
../assets/avatar.png,../index.html). - 사이트가 의도적으로 서버 루트 전용이고 사용자가 직접 파일 열기가 깨질 수 있음을 수락하지 않는 한, 내부 링크에
/assets/...,/posts/...,/images/...,/data/..., 또는/를 도입하지 마세요. - GitHub, LinkedIn, 이메일, 개인 도메인과 같은 외부 링크는 절대 URL로 유지될 수 있습니다.
4. 소스 사이트 및 템플릿 정리
스타일 재현을 개인화할 때 기본적으로 원본 사이트의 신원과 소스별 콘텐츠를 제거하세요.
대체 또는 제거할 항목:
- 원본 작성자 이름, 핸들, 도메인, 이메일, 소셜 링크, 분석 ID, 친구 링크, 개인 URL, 라이선스 텍스트, 사이트 통계, 커뮤니티 링크.
- 원본 글 카탈로그, 글 본문 텍스트, 프로젝트 이름, 개인 추천사, 개인 주장.
- 사용자가 소유하거나 권한이 없는 한 원본 사이트의 다운로드된 아바타, 표지, 스크린샷, 로고 또는 기타 에셋.
시각적 구조와 상호작용 패턴은 유지하되, 콘텐츠가 명확히 사용자에게 속하거나 중립적인 플레이스홀더 콘텐츠로 남도록 하세요.
5. 콘텐츠 적응
사용자의 자료를 사이트의 기존 스타일과 레이아웃에 맞게 조정하고, 모든 곳에 긴 원본 텍스트를 붙여넣지 마세요.
사이트의 개념을 사용하여 카피를 구성하세요:
- 미니멀 사이트: 간결하고, 차분하며, 직접적.
- 터미널/아카이브 스타일: 프로필, 로그, 상태, 디렉터리 또는 설정 스타일의 표현.
- 벤토 스타일: 짧은 모듈식 스니펫.
- 연구 홈페이지: 형식적이고 정확하며, 프로젝트/출판물 중심.
- 블로그 또는 디지털 가든: 작성 주제, 최근 노트, 태그, 읽기 경로.
- 포트폴리오: 선정된 작업, 역할, 결과, 스택, 링크.
텍스트 길이가 기존 컨테이너에 적합하도록 유지하세요. 사용자가 제공한 단락이 카드에 너무 길면 요약하고 더 완전한 버전을 소개 페이지에 배치하세요.
가능하면 중앙 집중식 데이터 소스를 편집하는 것을 선호하세요. 콘텐츠가 파일 간에 반복되는 경우 모든 가시적 및 메타데이터 복사본을 일관되게 업데이트하세요.
6. 검증
실제로 사용 가능한 대화형 브라우저 도구를 첫 번째 선택으로 사용하여 로컬 미리보기를 검사하고 개인화된 콘텐츠가 올바른 위치에 실제로 표시되는지 확인하세요. "사용 가능"이란 현재 턴의 호출 가능한 도구 목록에 노출되어 있음을 의미합니다. Codex에서는 @browser로 라우팅될 때 Browser/인앱 브라우저 플러그인이 될 수 있고, 다른 에이전트에서는 동등한 가시적 브라우저, 브라우저 사용 도구, 또는 devtools 기반 브라우저가 될 수 있습니다.
대화형 브라우저 도구를 호출할 수 없는 경우, 브라우저 배치 확인이 수행된 것처럼 가장하지 마십시오. 사용자에게 브라우저 도구를 활성화하거나 호출하도록 요청하세요. Codex의 경우 @browser를 명시적으로 언급하는 요청을 보내는 것을 의미할 수 있습니다. 사용자가 경로를 변경하지 않거나 클라이언트에 해당 도구가 없는 경우, Playwright, 스크린샷, 정적 감사, 또는 소스 검사로 대체하고 한계를 명시하세요.
대화형 브라우저 도구가 실제로 호출 가능할 때 Playwright 또는 스크린샷 전용 검증을 기본값으로 사용하지 마십시오. Playwright는 대화형 브라우저 도구를 호출할 수 없는 경우, 사용자가 명시적으로 요청한 경우, 또는 반복 가능한 스크립트 기반 회귀 테스트가 특별히 필요한 경우에만 대체 수단으로 사용하세요.
홈, 소개/프로필, 연락처, 프로젝트, 링크, 대표 글/상세 페이지 등 사용자의 정보가 표시되어야 하는 페이지를 확인하세요. 사용자가 제공한 이름, 태그라인, 자기소개, 아바타/로고, 연락처 정보, 소셜 링크, 프로젝트 이름, 주요 항목이 예상되는 위치에 나타나는지 확인하세요.
또한 중요한 플레이스홀더 콘텐츠나 소스 사이트 신원이 브라우저에 여전히 표시되지 않는지 확인하세요. 이는 전체 시각적 재설계 검토가 아닌 콘텐츠 배치 확인입니다.
개인화로 인해 아바타, 파비콘, 소셜 아이콘, 프로젝트 링크, 게시물 링크, 데이터 기반 카드가 변경된 경우, 변경된 경로가 해당 페이지 깊이에서 작동하고 실수로 루트 절대 경로의 사이트 로컬 경로가 도입되지 않았는지 확인하세요.
마지막으로 review-static-site를 호출하거나 제안하세요.
편집 가이드
EDITING.md가 존재하면 업데이트하고, 사이트를 재사용 가능하게 유지하려면 생성하세요.
기록할 내용:
- 어떤 개인 필드가 채워졌는지.
- 어떤 콘텐츠가 플레이스홀더로 남아 있는지.
- 프로필, 링크, 프로젝트, 주요 항목, 게시물, 이미지, 테마 텍스트가 현재 어디에 있는지.
- 사이트에 복사된 사용자 제공 에셋과 참조 위치.
- 의도적으로 제거되거나 대체된 소스 사이트 콘텐츠.
웹사이트 내부의 마케팅 카피가 아닌, 미래의 에이전트와 사용자를 위한 가이드를 유지하세요.
출력
완료되면 간략히 보고하세요:
- 업데이트된 개인 정보와 페이지.
- 변경된 파일.
- 남아 있는 플레이스홀더나 소스별 잔재(있는 경우).
review-static-site가 실행되었는지 또는 다음에 실행해야 하는지 여부.
사용자의 개인 데이터를 불필요하게 다시 붙여넣지 마세요.