로컬 비즈니스 사이트 빌더 (그리스)
실제 사이트(Αποφράξεις Τσαβάρης)에서 추출되었으며, 보이지 않는 배관 문제가 계속 발생하여 수십 번의 프롬프트가 필요했습니다: 서버 구성, 동의, SEO 파일, 일관성 없는 사실. 목표: 처음부터 제대로 완성하는 것. 사용자와 그리스어로 대화하세요.
아래 경로는 이 스킬의 폴더를 기준으로 합니다. 스크립트를 실행하기 전에 절대 경로로 변환하고, deno run -A scripts/<name>.mjs(또는 node)로 실행하세요. 둘 다 없는 경우 사용자에게 알리고(설치: winget install DenoLand.Deno, 먼저 물어보기) 수동 체크리스트를 사용하세요.
이식 가능한 실행
도우미를 실행하기 전에 호스트 기능을 확인하세요: 터미널 및 파일 액세스, Node 18+ 또는 Deno, 브라우저 도구, 선택적 FFmpeg 및 네트워크 권한. 이러한 도구가 설치되어 있다고 가정하지 마십시오. 사용 가능한 동등한 이미지/브라우저 도구 또는 수동 참조 체크리스트를 사용하고, 실행할 수 없는 자동 검사를 보고하세요. 모든 지원 경로를 이 설치된 스킬 디렉터리에 대해 확인하세요. Windows 사용자 경로를 가정하거나 승인 없이 소프트웨어를 설치하지 마십시오.
절대 굽히지 않는 규칙 (각각 실제 시간 또는 비용 발생)
- 절대 사실을 지어내지 마십시오. 전화, 이메일, 주소, ΑΦΜ, ΓΕΜΗ, 영업 시간, 가격, 리뷰, 평점, 업력, 라이선스, 보증, 도착 시간은 소유자가 제공합니다. 누락 시 → 물어보거나 생략하고,
[ΧΡΕΙΑΖΕΤΑΙ: …]마커는 라이브 전환을 차단합니다. 규제 직종(의사, 치과의사, 변호사, 약사): 리뷰 금지, 성공 주장 금지(참고문헌/01 §4). - 단일 진실 공급원:
site-facts.json(배포 폴더 외부). 파생 파일(JSON-LD, 사이트맵, llms.txt, robots, manifes, vCard)은scaffold.mjs derive로 재생성되며, 수동 편집 금지. - 디자인은 고객별로 결정되며 이전 사이트에서 복사하지 않음:
docs/DESIGN.md작성, 사용자가 하나의 방향을 선택한 후 코딩(참고문헌/02). - 처음부터 CSP-클린: 인라인 스크립트/스타일/핸들러 없음; 모든 타사는 동일한 변경에서 CSP에 추가; 하나의 강제 CSP.
- 동의 또는 클릭 전에 타사 요청 금지. GA4는 "Αποδοχή" 이후에만 로드됨; 수락/거절 동등; 지도는 클릭 시 로드; 글꼴은 자체 호스팅되며 그리스어 글리프 확인 필요(많은 인기 글꼴(예: Poppins/Montserrat)에 없음).
- 너비별 패치가 아닌 근본 원인 수정. 모바일 우선;
scripts/overflow_probe.js로 너비 매트릭스 테스트. - 서버 지시문을 신뢰하지 마십시오. Hostinger/LiteSpeed는
<IfModule>을 무시하고, 지원되지 않는 지시문을 자동으로 무시하며 가장자리에서 HTTPS를 강제합니다.verify_live.mjs로 라이브 확인. - SEO 파일은 결과물: 표준, robots (
Allow: /+ Sitemap), 사이트맵, JSON-LD (LocalBusiness 하위 유형), OG 1200×630, 아이콘(마스크 가능 포함). - 모든 CSS/JS 변경 후 모든 페이지에서
?v=를 증가시키고(bump_version.mjs) Hostinger 캐시를 제거하세요. - 확인하고, 가정하지 마십시오. 최종 파일 감사에서 오류 0개, 브라우저 QA 완료, 확인되지 않은 사항을 정직하게 보고한 후에만 "완료"라고 말하세요.
주의 사항 (옳아 보이지만 구식이거나 잘못된 믿음)
- FAQPage/HowTo 마크업은 이점 없음: FAQ 리치 결과는 2026년 5월 7일에 폐지되었습니다.
llms.txt는 입증된 효과 없음(Google은 사용하지 않는다고 밝힘): 선택 사항. - 비즈니스 자체에
aggregateRating/reviewJSON-LD를 추가하지 마세요;sameAs는 실제, 활성화된 프로필에만 사용(빈 두 번째 도메인에는 사용 금지). - 프로덕션에 남겨진 스테이징
Disallow: /또는noindex는 사이트를 인덱스에서 제외시킴(감사 SEO-001/023). - Hostinger 미리보기 도메인
*.hostingersite.com은 사이트를 중복시킴: 301 리디렉션하고 제거하세요. - 점 없는
htaccess는 무시됨; 점이 있는 경우 명시적으로 업로드해야 함(숨김 파일). Docs/facts/.md는public_html에 있으면 안 됨. - Google Fonts CDN 링크는 개인정보 보호 및 CSP를 위반함; Poppins/DM Sans/Playfair 등을 언급하는 프론트엔드 디자인 조언은 그리스어에서 실패함.
- 대소문자만 다른 링크는 Windows에서 작동하지만 서버에서 404 오류 발생.
- JS 내부에 구축된 앵커(쿠키 배너 →
/privacy.html#cookies)도 존재해야 함. - 약 60개의 빠른 요청 후 가장자리 봇 차단은 사이트 오류가 아님: 기다리세요, 우회하지 마십시오.
워크플로우 (각 단계를 수행하기 전에 명명된 참고문헌을 로드)
- 분류: 새 사이트 · 재작업 · 감사 전용(6단계로 이동) · 소규모 변경(5단계로 이동). 어떤 도구가 있는지 확인(deno/node, 브라우저 도구, ffmpeg, Edge/Chrome for
render_png). - 인테이크 →
references/01-intake-and-facts.md읽기. 모든 것을 하나의 그리스어 메시지로 물어보기(아무도 답할 수 없으면 주어진 사실만 사용, 절대 지어내지 말고QUESTIONS.md작성);assets/site-facts.example.json에서site-facts.json작성;scaffold.mjs check --facts site-facts.json실행. - 디자인 브리프 →
references/02-design-direction.md;docs/DESIGN.md작성, 2-3가지 방향 제안, 선택 받기. - 스캐폴드:
scaffold.mjs init --facts site-facts.json --out public --docs docs [--logo logo.svg](페이지, 기본 CSS, JS, 기능에서 CSP가 포함된.htaccess, robots, 사이트맵, llms.txt, manifes, vCard, 그리스어 핸드오프 문서, AGENTS.md/CLAUDE.md 생성). - 빌드 →
references/03-build-and-code.md,04-conversion-and-content.md,05-seo-schema-geo.md:style.css에 토큰 + THEME,index.html에 섹션([ΧΡΕΙΑΖΕΤΑΙ…]마커 대체),make_icons.mjs,render_png.mjs(HTML 페이지에서 OG 이미지),images.mjs,font_greek_check.mjs --download로 애셋. 동의, 개인정보 텍스트, 바닥글 ID, 가격 또는 리뷰의 경우06-privacy-consent-legal.md도 읽음. 완성된 예제 사이트는assets/example-site/에 있음(구조와 카피 톤을 연구하되, 외관은 복사하지 마십시오). - 사실 변경 후: facts →
scaffold.mjs derive→ 보이는 텍스트 →bump_version.mjs. - 감사:
audit_site.mjs public --facts site-facts.json→ 모든 ERROR 수정, WARN 읽기, 소유자에게 VERIFY 목록 제공. 불명확한 발견 →references/mistake-registry.md. - QA 및 출시 →
references/08-qa-and-launch.md(너비 매트릭스, 동의 테스트, 콘텐츠 QA); 배포 및 서버 세부 사항은references/07-server-htaccess-deploy.md. - 배포 후:
verify_live.mjs https://DOMAIN --local public --preview-domain X.hostingersite.com; 소유자에게docs/전달. 양식, 예약, 추가 페이지, CMS, 전자상거래, 다른 언어, 광고 픽셀 →references/09-beyond-the-basics.md를 읽고 먼저 범위 동의.
스크립트 (scripts/)
audit_site.mjs 출시 전 감사(ERROR/WARN/VERIFY/INFO; --json, --strict; 오류 시 exit 1) · verify_live.mjs 라이브 확인(리디렉션, 헤더, 404, 노출된 파일, 바이트 동일성; 속도 제한) · scaffold.mjs init/derive/check · bump_version.mjs · render_png.mjs · make_icons.mjs · images.mjs (ffmpeg) · contrast.mjs · font_greek_check.mjs · overflow_probe.js (페이지 내에서 실행). 모두 인수 없이 호출 시 --help 스타일 사용법을 출력합니다. 전달한 폴더 내에서만 작성합니다.
참고문헌 색인
01 인테이크/사실/규제 직종 · 02 디자인 방향, 그리스어 글꼴 · 03 빌드, 성능, 접근성, 너비 · 04 전환 및 카피 · 05 SEO/스키마/GBP/AI 검색 · 06 개인정보 보호 및 그리스 법률 포인터 · 07 Hostinger 서버 및 배포 · 08 QA/출시 · 09 기본 외 · 오류 레지스트리. 연구 날짜: 2026-10-05; 법률 및 Google 정책은 변경됨: 의존하기 전에 재확인하고, 확인되지 않은 사항이 있으면 말하세요.