사이트 일부 편집
목표
기존 정적 사이트의 한 부분을 개선하면서 사이트의 나머지 부분은 유지합니다.
이 스킬은 사이트가 이미 존재한 후 반복적인 다듬기를 위한 것입니다. 새로운 생성 패스가 아닌 신중한 로컬 편집처럼 느껴져야 합니다.
계약
입력:
- 기존 정적 사이트 폴더, 대상 페이지, 스크린샷/로컬 URL, 또는 대상 영역에 대한 자연어 설명.
EDITING.md및 관련 HTML/CSS/JS 파일.- 원하는 변경 전/후 텍스트, 스타일, 반응형 동작 또는 작은 상호작용 변경.
출력:
- 영향을 받는 페이지 섹션, 컴포넌트, 복사 블록, 스타일 규칙 또는 가벼운 상호작용에 대한 집중된 편집.
- 향후 편집 지침을 변경해야 할 때만 업데이트된
EDITING.md. - 변경이 이루어진 위치, 변경된 파일 및 수행된 검증에 대한 간략한 보고서.
경계:
- 전체 사이트를 재구축하거나, 테마 방향을 변경하거나, 게시물을 가져오거나, 여러 필드를 개인화하거나, 게시하지 마십시오.
- 관련 없는 페이지/자산을 건드리지 마십시오.
- 종속성, 빌드 단계 또는 루트 절대 사이트 로컬 경로를 도입하지 마십시오.
성공 게이트:
- 요청된 로컬 변경 사항이 편집 전에 확인된 동일한 브라우저 영역에서 표시됩니다.
- 데스크톱/모바일 또는 상호작용 검사가 영향을 받는 표면에 대해 통과합니다.
- 관련 없는 레이아웃 또는 탐색 변경이 도입되지 않았습니다.
게이트 실패 시:
- 브라우저 영역을 소스에 다시 매핑하고 가장 작은 수정 편집을 수행합니다.
- 문제가 공유 네비게이션, 여러 페이지, 자산, 인코딩 또는 게시 준비 상태에 영향을 미칠 때
review-static-site를 실행하거나 제안합니다.
사용 시기
사용자가 다음을 요청할 때 이 스킬을 사용하십시오:
- 한 섹션, 카드, 블록, 컴포넌트 또는 페이지 영역을 변경합니다.
- 시각적 세부 사항을 더 작고, 차분하며, 조밀하고, 깔끔하며, 더 장난스럽고, 더 기술적이거나, 덜 산만하게 만듭니다.
- 모바일 레이아웃 문제, 텍스트 오버플로, 간격 문제 또는 어색한 정렬을 수정합니다.
- 호버, 테마 전환, 메뉴 동작, 복사 버튼, 필터, 탭 또는 애니메이션과 같은 작은 상호작용을 조정합니다.
- 특정 가시 텍스트 조각을 다시 작성하거나 단축합니다.
- 특정 영역에 대한 스크린샷 또는 사용자 의견과 일치시킵니다.
전체 사이트 생성, 테마 검색, 새 참조 사이트의 근접 재현, 대규모 개인 콘텐츠 교체, 기사 마이그레이션, 배포 또는 프레임워크 변환에는 이 스킬을 사용하지 마십시오.
입력
사용자가 제공하는 모든 것을 사용하십시오:
- 사이트 루트 폴더 및 대상 페이지.
- 문제의 스크린샷, 브라우저 보기, 로컬 URL 또는 자연어 설명.
- 변경할 정확한 텍스트, 섹션 이름, 클래스 이름 또는 시각적 영역.
EDITING.md(있는 경우).- 기존 HTML/CSS/JS 파일.
- 원하는 변경 전/후 문구 또는 스타일 방향.
대상 영역이 모호한 경우 사이트를 검사하고 가장 작은 합리적인 해석을 하십시오. 여러 그럴듯한 편집이 매우 다른 결과를 생성할 경우에만 짧은 확인을 요청하십시오.
워크플로우
- 편집 전에 브라우저를 사용하여 대상 페이지 및 대상 영역을 확인하십시오.
EDITING.md가 있으면 읽은 다음 관련 HTML/CSS/JS를 검사하십시오.- 검색을 사용하여 일치하는 가시 텍스트, ID, 클래스, 데이터 블록 또는 컴포넌트 같은 마크업을 찾으십시오.
- 확인된 브라우저 영역을 관련 소스 파일, 선택기, 데이터 블록 또는 이벤트 핸들러에 매핑하십시오.
- 요청을 충족하는 가장 작은 일관된 편집을 수행하십시오.
- 사용자가 명시적으로 변경을 요청하지 않는 한 기존 디자인 언어를 유지하십시오.
- 편집 후 동일한 페이지 및 영역으로 브라우저로 돌아가 변경 사항을 확인하십시오.
- 변경된 사항을 보고하고 필요한 후속 검증을 언급하십시오.
범위 제어
편집을 로컬로 유지하십시오.
- 병렬 복제본을 만드는 대신 기존 섹션, 클래스 또는 데이터 객체를 편집하는 것을 선호하십시오.
- 섹션 수준 변경으로 충분할 때 전체 페이지를 다시 작성하지 마십시오.
- 사용자가 사이트 전체 스타일 변경을 원하지 않는 한 공유 CSS 변수를 변경하지 마십시오.
- 관련 없는 페이지, 자산 또는 콘텐츠를 건드리지 마십시오.
- 네비게이션, 페이지 맵, 플레이스홀더 전략 및
EDITING.md규칙을 유지하십시오. - 사이트의 경로 전략을 유지하십시오. 로컬 편집 중에
/assets/...,/posts/...,/images/...또는/data/...와 같은 루트 절대 사이트 로컬 경로를 도입하지 마십시오. - 작은 요청이 더 큰 구조적 문제를 드러내면 광범위한 변경을 하기 전에 트레이드오프를 설명하십시오.
사용자가 여러 페이지에서 광범위한 시각적 변화를 요청하는 경우 이 스킬을 확장하는 대신 더 큰 생성 또는 재설계 스킬을 제안하십시오.
올바른 위치 찾기
계층적 조회를 사용하십시오:
- 가시 텍스트 또는 근처 레이블을 검색하십시오.
EDITING.md에서 섹션/페이지 맵을 검색하십시오.- 네비게이션 링크 및 페이지 파일 이름을 검사하십시오.
header,main,section,article,aside및footer와 같은 시맨틱 태그를 검사하십시오.- CSS 선택기 및 JavaScript 이벤트 훅을 검사하십시오.
- 소스 위치가 명확하지 않은 경우 브라우저 개발자 도구 또는 스크린샷을 사용하십시오.
반복 콘텐츠가 데이터에서 렌더링되는 경우 생성된 것처럼 보이는 마크업만 편집하지 말고 소스 데이터를 편집하십시오.
디자인 보존
편집을 현재 사이트에 맞추십시오.
- 기존 간격, 타이포그래피, 색상, 테두리, 그림자, 아이콘 및 모션 패턴을 재사용하십시오.
- 데스크톱과 모바일 모두에서 텍스트를 컨테이너 내에 유지하십시오.
- 장식 효과가 읽기를 방해하지 않도록 하십시오.
- 애니메이션을 변경할 때
prefers-reduced-motion을 존중하십시오. - 사용자가 달리 요청하지 않는 한 기사/세부 페이지는 스타일이 많이 적용된 홈 페이지보다 차분하게 유지하십시오.
- 개인 웹사이트나 블로그에 마케팅 스타일의 히어로 또는 관련 없는 장식 섹션을 추가하지 마십시오.
텍스트를 변경할 때 기존 음성과 사용자의 언어를 일치시키십시오.
상호작용 편집
JavaScript 또는 상호작용 변경의 경우:
- 새 이벤트 리스너를 추가하기 전에 기존 이벤트 리스너와 상태 규칙을 찾으십시오.
- 사이트가 일반 정적인 경우 바닐라 JavaScript를 유지하십시오.
- 종속성 또는 빌드 단계를 도입하지 마십시오.
- JavaScript에서 링크, 검색 결과, 이미지 URL 또는 네비게이션 항목을 생성할 때 영향을 받는 페이지 깊이에서 작동하는 페이지-상대 경로를 사용하십시오.
- 관련된 경우 클릭, 키보드, 모바일 및 반복 사용 상태를 테스트하십시오.
- 포커스, 레이블 및 축소된 모션 동작과 같은 접근성 기본 사항을 보존하십시오.
반응형 수정
레이아웃 또는 모바일 문제의 경우:
- 데스크톱 및 모바일 너비를 모두 확인하십시오.
- 좁은 화면을 수정하면서 데스크톱 레이아웃을 보존하는 CSS 변경을 선호하십시오.
- 안정적인 치수, 래핑, 최소/최대 너비, 그리드/플렉스 조정 및 오버플로 제어를 사용하십시오.
- 레이아웃을 맞추기 위해 모바일에서 중요한 콘텐츠를 숨기지 마십시오.
편집 가이드
변경이 향후 편집이 수행되어야 하는 방식에 영향을 미치는 경우 EDITING.md를 업데이트하십시오.
다음 경우에 업데이트하십시오:
- 새 섹션, 클래스, 데이터 필드 또는 상호작용 패턴이 도입되었습니다.
- 콘텐츠 저장소가 새 파일 또는 데이터 객체로 이동합니다.
- 사용자가 향후 에이전트가 보존해야 할 변경을 요청했습니다.
가이드가 오해의 소지가 있지 않는 한 작은 텍스트 또는 간격 변경에는 EDITING.md를 업데이트하지 마십시오.
검증
전체 사이트가 아닌 영향을 받는 표면을 검증하십시오.
편집 전에 실제 사용 가능한 대화형 브라우저 도구를 사용하여 대상 페이지와 영역을 확인하십시오. "사용 가능"은 현재 턴의 호출 가능한 도구 목록에 노출되어 있음을 의미합니다. Codex에서는 턴으로 라우팅될 때 Browser/인앱 브라우저 플러그인일 수 있습니다. 다른 에이전트에서는 동등한 가시 브라우저, browser-use 도구 또는 devtools 지원 브라우저일 수 있습니다. 편집 후 대화형 브라우저의 동일한 페이지와 영역으로 돌아가 결과를 확인하십시오.
호출 가능한 대화형 브라우저 도구가 없는 경우 변경 전/후 브라우저 확인이 발생했다고 가정하지 마십시오. 편집이 시각적 영역 매핑에 의존하는 경우 사용자에게 브라우저 도구를 활성화하거나 호출하도록 요청하십시오. Codex의 경우 @browser를 명시적으로 언급하는 요청을 보내는 것을 의미할 수 있습니다. 사용자가 경로를 변경하지 않거나 클라이언트에 해당 도구가 없는 경우 Playwright, 스크린샷 또는 소스 검사로 대체하고 제한 사항을 명시하십시오.
대화형 브라우저 도구가 실제로 호출 가능할 때 Playwright, 스크린샷 전용 검증 또는 소스 검사 단독을 기본값으로 사용하지 마십시오. 대화형 브라우저 도구를 호출할 수 없거나, 사용자가 명시적으로 요청하거나, 반복 가능한 스크립트화된 회귀 테스트가 구체적으로 필요한 경우에만 Playwright를 대체 수단으로 사용하십시오.
시각적, 반응형 또는 상호작용 편집의 경우 관련 데스크톱/모바일 뷰포트에서 변경된 영역을 확인하고 변경된 상호작용을 실행하십시오.
편집이 공유 네비게이션, 전역 레이아웃, 여러 페이지, 자산 경로, 소스 인코딩 또는 게시 준비 상태에 영향을 미치는 경우에만 review-static-site를 실행하거나 제안하십시오.
편집이 href, src, CSS url(...), 이미지, 글꼴, 파비콘, 데이터 파일 또는 JavaScript 생성 URL을 건드리는 경우 영향을 받는 페이지가 페이지-상대 경로로 여전히 작동하고 정적 파일을 직접 열 때 CSS, JS 또는 이미지가 손실되지 않는지 확인하십시오.
출력
로컬 편집의 경우 다음만 보고하십시오:
- 변경이 이루어진 위치.
- 변경된 파일.
- 수행된 검증.
실제로 권장되는 경우에만 더 넓은 review-static-site 검증을 언급하십시오. 보고서를 반복하거나 전체 코드베이스를 과도하게 설명하지 마십시오.