여러 AI 에이전트 도구에서 똑같이 쓰는 SEO 조사 스킬 묶음을 만든다

## 모든 도구가 읽을 수 있는 방식으로 각 스킬을 한 번만 쓴다 모든 조사 스킬을 플랫폼에 종속되지 않는 정본 소스로 작성하세요. 핵심 계약은 모든 대상 에이전트 환경이 해석할 수 있는 기능으로 제한하세요. 각 스킬 정의에는 다음 항목이 반드시 포함되어야 합니다. - 안정적인 이름과 명확한 설명. - 호스트가 지원하는 경우에만 사용하는 선택적 모델 및 도구 선언. - 본문의 완전한 운영 지침. - 명시적인 입력, 결과, 제약, 실패 조건. 플랫폼별 제어 기능은 선택적 확장으로 취급하세요. 호스트가 확장을 무시할 수 있지만 그 외에는 이식 가능한 스킬을 거부할 필요가 없다면, 호환성 검사기가 경고해야 합니다. 생성된 플랫폼 사본이 아니라 정본 소스를 편집하세요. 메타데이터 누락과 지원되지 않는 구문을 조기에 실패 처리할 수 있도록 패키징이나 배포 전에 모든 스킬 정의를 검증하세요. ## AI 에이전트 도구마다 지침과 스킬을 어디서 읽는지 확인한다 각 대상 환경이 프로젝트 지침과 재사용 가능한 스킬을 검색하는 방식을 정리하세요. 일반적인 방식에는 루트 지침 파일, 전용 규칙 디렉터리, 네이티브 스킬 폴더, 생성된 디스패처, 문서 대체 경로가 있습니다. 각 호스트에 대해 다음을 기록하세요. - 세션 시작 시 자동으로 읽는 파일. - 재사용 가능한 스킬을 복사, 연결 또는 설치해야 하는 위치. - 활성화가 자동인지, 명시적 명령이 필요한지 여부. - 지원되지 않는 위임이 현재 문맥 내 실행으로 전환되는 방식. - 최종 대체 수단으로 사용되는 프로젝트 문서. 하나의 설치 배치가 모든 환경에서 작동한다고 가정하지 마세요. 의미상 소스는 하나로 유지하면서 검색, 활성화, 패키징을 호스트에서 검증된 동작에 맞추세요. ## 단계를 쉬운 동작으로 적고 도구마다의 이름으로 바꾼다 읽기, 쓰기, 편집, 명령 실행, 파일 목록 조회, 텍스트 검색, 웹 콘텐츠 가져오기와 같은 중립적인 작업으로 절차를 작성하세요. 이러한 작업과 각 호스트의 도구 이름을 연결하는 검증된 호환성 표를 유지하세요. 호스트가 자동 매핑을 지원하면 어댑터가 별칭을 변환하도록 하세요. 기능을 사용할 수 없을 때는 단계를 조용히 생략하지 말고 문서화된 대체 수단을 정의하세요. 도구 변환을 조사 로직과 분리하세요. 페이지 분석 절차에서는 특정 공급자의 도구 레이블에 의존하지 말고, 보호된 가져오기와 HTML 파서가 필요하다고 명시해야 합니다. 호스트가 도구 인터페이스를 변경할 때마다 매핑을 검토하세요. 이름이 비슷하다는 이유만으로 호환성을 주장하지 말고, 매핑된 작업을 실행해 확인하세요. ## 작은 입구 스킬이 불러올 조사 스킬만 고른다 작은 오케스트레이터를 사용해 요청을 분류하고 관련 기능만 불러오세요. 세부 분석 로직은 하나의 지나치게 큰 지침 파일이 아니라 목적이 명확한 모듈에 보관하세요. 시스템을 다음 요소로 분리하세요. - 워크플로를 선택하는 라우팅 스킬. - 완전한 분석 기준을 갖춘 목적별 조사 스킬. - 독립 작업이나 병렬 작업을 위한 선택적 전문가 에이전트. - 결정론적 실행을 위한 로컬 스크립트. - 구조화된 검색 메타데이터용 스키마 템플릿. - 호스트별 패키징을 위한 어댑터. - 선택적 공급자와 비용이 큰 기능을 위한 확장. 확장은 핵심 종속성 경로 밖에 두세요. 확장이 없을 때는 선택적 조사 범위만 줄어야 하며, 기본 조사가 중단되어서는 안 됩니다. ## 질문마다 가장 좁은 SEO 점검을 고른다 조사 질문에 답할 수 있는 가장 좁은 범위의 기능을 선택하세요. - 광범위한 문제 발견과 우선순위 지정에는 전체 사이트 감사를 사용합니다. - 하나의 URL을 심층 조사하려면 단일 페이지 분석을 사용합니다. - 크롤링 가능성, 색인 생성, 성능, 관련 인프라에는 기술 분석을 사용합니다. - 품질, 신뢰, 전문성, 경험 신호에는 콘텐츠 분석을 사용합니다. - 탐지, 검증, 생성에는 구조화 데이터 분석을 사용합니다. - XML 범위와 생성에는 사이트맵 분석을 사용합니다. - 페이지 내 메타데이터, 검색 결과 가시성, 파일 최적화에는 이미지 분석을 사용합니다. - 생성형 검색 가시성과 답변 엔진 최적화에는 AI 검색 분석을 사용합니다. 발견 사항이 여러 기능 경계를 넘을 때만 더 광범위한 감사로 확대하세요. 모든 외부 주장에 대해 원래 URL, 근거 출처, 관찰 시각, 불확실성을 보존하세요. ## SEO 계획은 따로 다루고, 변화는 처음 기록과 비교해 추적한다 전략 계획, 의미 기반 키워드 군집화, 검색 경험 분석, 콘텐츠 아키텍처에 각각 별도의 워크플로를 제공하세요. 이러한 계획 작업을 기술 진단과 합치지 마세요. 모니터링 상태를 명시적으로 유지하세요. 1. 안정적인 기준선을 수집합니다. 2. 이후 관찰 결과를 해당 기준선과 비교합니다. 3. 반복되는 변화와 일회성 잡음을 구분할 수 있도록 이력을 보존합니다. 상거래, 프로그래매틱 랜딩 페이지, 경쟁사 비교 페이지, 로컬 검색, 지도 가시성, 국제 언어 타기팅, 자체 검색 데이터, 페이지 경험, 백링크 분석에는 전문 모듈을 사용하세요. 외부 데이터 공급자, 대규모 크롤링, 자산 생성은 선택적 확장으로 취급하세요. 호출하기 전에 공급자 요구 사항, 자격 증명, 비용, 조사 범위 제한을 표시하세요. ## 가져오기 전에 URL을 확인하고 API 키를 스킬에 넣지 않는다 보호된 페이지 가져오기, HTML 분석, 성능 검사, 기준선 수집, 구조화 내보내기와 같은 결정론적 작업에는 로컬 스크립트를 사용하세요. 네트워크에 접근하는 모든 보조 프로그램은 서버 측 요청 위조 위험을 줄이기 위해 요청 전에 대상 URL을 검증해야 합니다. 인증서 검증을 유지하고, 전송 보안을 비활성화하는 대신 인증서 오류를 조사하세요. API 자격 증명은 사용자 수준 설정 위치 또는 주입된 환경에 보관하고, 정본 스킬, 예시 결과, 생성된 패키지에는 절대 넣지 마세요. 값을 지어내지 말고, 자격 증명이 없다는 명확한 결과와 함께 중단하세요. 설정된 언어 환경과 종속성 관리자를 통해 보조 프로그램을 실행하세요. 클라우드 호스트가 해당 환경을 `PATH`에 노출하지 않는 경우 검증된 실행 파일 절대 경로를 사용하세요. 다른 모듈이 결과를 사용하는 경우 기계 판독 가능한 결과를 반환하세요. 임시 디렉터리에 기록된 스크린샷이나 기타 파일의 절대 경로를 보존하세요. ## 나눠 주기 전에 지원하는 AI 에이전트 도구마다 시험한다 패키징 전에 모든 정본 스킬에 이식성 검사를 실행하세요. 필수 메타데이터, 유효한 구조, 알려진 호스트별 기능을 확인하세요. 지원되는 각 환경에서 다음을 테스트하세요. - 루트 지침 검색. - 스킬 설치 또는 연결. - 명시적 활성화 경로와 자동 활성화 경로. - 도구 이름 변환. - 위임된 에이전트를 사용할 수 없을 때의 현재 문맥 내 대체 실행. - 로컬 보조 프로그램 실행. - 생성된 라우팅과 문서 대체 경로. 경고에는 기능, 영향을 받는 호스트, 예상되는 기능 저하가 명시되어야 합니다. 무시되는 선택적 필드는 호환성을 유지할 수 있지만, 필수 지침이 없거나 핵심 작업을 사용할 수 없다면 호환된다고 볼 수 없습니다. ## 도구별 오류는 안전 확인을 끄지 않고 원인을 찾는다 호스트별 실패는 보호 조치를 약화할 수 있는 허가가 아니라 환경을 보여 주는 근거로 취급하세요. - 코드를 변경하기 전에 인증서 체인 또는 이름 확인 실패를 조사합니다. - 기본 명령 경로에 종속성이 없으면 검증된 가상 환경 실행 파일을 사용합니다. - 스크린샷이나 보고서가 작업 디렉터리에 없으면 문서화된 임시 디렉터리를 확인합니다. - 산출물이 프로세스나 컨테이너 경계를 넘을 때는 절대 경로를 사용합니다. - 사용할 수 없는 원격 통합은 문서화된 로컬 보조 프로그램이 동등한 근거를 제공할 때만 대체합니다. 제한이 검색, 실행, 위임, 네트워크, 산출물 위치 중 어디에 영향을 주는지 기록하세요. 우회 방법은 어댑터 또는 운영 참고 사항에 두고 정본 조사 로직에 섞지 마세요. ## 실제 도구에서 시험하고 설명서를 고친 뒤 변경을 마친다 여러 플랫폼에 걸친 조사 변경을 완료로 선언하기 전에 다음을 수행하세요. - 정본 스킬과 영향을 받는 모든 어댑터를 검토합니다. - 생성된 라우팅과 패키지를 다시 빌드합니다. - 이식성 검사와 관련 보조 프로그램 테스트를 실행합니다. - 구문 검사에만 의존하지 말고 대표적인 호스트에서 실제로 실행합니다. - 기능 카탈로그, 설치 지침, 아키텍처 참고 사항을 업데이트합니다. - 선택적 확장이 계속 분리되어 있는지 확인합니다. - 결과에 자격 증명, 근거 없는 주장, 누락된 증거가 있는지 검토합니다. 변경된 기능, 검증된 호스트, 통과한 검사, 확인된 경고, 사용한 대체 수단, 실행할 수 없었던 검증을 보고하세요. 호스트가 필수 동작을 무시하거나 하나의 환경만 테스트한 경우 완전한 동등성을 주장하지 마세요.