Use when a predefined GEO query bundle must be run through the ChatGPT website and converted into a reusable deep analysis report with portable batch artifacts.
정해진 query bundle을 받아 ChatGPT 웹 실측, citation 정규화, signal hypothesis, reverse-engineering probe, 탭형 HTML 보고서까지 이어지는 배치형 GEO 분석 워크플로우다.
Core principle: 이 스킬은 특정 로컬 경로에 묶이지 않는다. 프로젝트별 실행 파일은 pipeline-map으로 연결하고, 보고서 계약은 이 스킬 패키지 안의 문서로 고정한다.
정해진 쿼리뭉치, query bundle, 질의 세트를 파라미터로 주고 GEO 보고서를 원할 때웹 기준으로 실제 인용 패턴을 측정해야 할 때batch_dir와 HTML 보고서로 남겨야 할 때원문, 노출 식당, 인용 URL, probe까지 함께 분석해야 할 때Do not use this skill for:
이 스킬 디렉터리 안에는 아래 파일이 포함돼 있어야 한다.
SKILL.mdcontracts/deep-report-contract.mdtemplates/pipeline-map.example.yamltemplates/query-bundle.example.json상세 계약은 contracts/deep-report-contract.md를 기준으로 따른다.
query_bundle_pathreport_rootbatch_labelpipeline_map_pathpipeline_map_path는 이 스킬이 실행 환경에 종속되지 않게 만드는 핵심 입력이다.
프로젝트별 실제 스크립트 경로는 스킬 안에 하드코딩하지 않는다.
대신 templates/pipeline-map.example.yaml 형식으로 매핑한다.
필수 stage 키:
queue_maincollect_mainextract_citationsnormalize_citationsbuild_query_summarybuild_signal_hypothesesdecide_expansion_roundgenerate_probesrender_report선택 stage 키:
queue_probescollect_probesqueue_probes, collect_probes가 비어 있으면 queue_main, collect_main을 재사용한다.
query bundle은 JSON 배열이어야 하며, 각 항목은 최소 아래 필드를 권장한다.
{
"query_id": "vertical-001",
"query_text": "판교 직장인 점심 맛집 추천해줘",
"intent": "recommendation",
"market": "KR",
"region": "pangyo"
}
예시는 templates/query-bundle.example.json에 둔다.
pipeline_map_path를 읽어 프로젝트별 실행 파일을 해석한다.query_bundle_path를 기준으로 main batch를 queue한다.conversation-results.json과 raw-dumps/를 만든다.query-summary, signal-hypotheses, expansion-decision을 만든다.restaurant-exposure-index, citation-url-index를 만든다.report.html과 final-analysis-report.html을 만든다.상세 필수 산출물과 HTML 요구사항은 contracts/deep-report-contract.md를 따른다.
deep report에서는 probe 실행이 선택사항이 아니다.final-analysis-report.html이다.분석본배치 질의·원문Probe 질의·원문노출 식당 집계인용 URL 목록| Input | Meaning |
|---|---|
query_bundle_path | 실행할 쿼리 묶음 |
report_root | batch 산출물 루트 |
batch_label | 배치 식별자 |
pipeline_map_path | 프로젝트별 stage 실행 파일 매핑 |
| Output | Meaning |
|---|---|
query-manifest.json | 제출된 질의와 session URL |
conversation-results.json | 회수된 응답 원문 |
normalized-citation-facts.json | 정규화된 인용 사실 |
signal-hypotheses.json | 1차 신호 가설 |
restaurant-exposure-index.json | 식당 노출 집계 |
citation-url-index.json | 인용 URL 집계 |
final-analysis-report.html | 최종 탭형 보고서 |
| Mistake | Fix |
|---|---|
| 스킬 안에 프로젝트 절대경로를 박아 둠 | 항상 pipeline_map_path로 연결한다 |
| query bundle만 받고 probe 실행을 생략 | deep report는 probe queue/collect까지 포함한다 |
report.html만 만들고 끝냄 | 최종 결과물은 final-analysis-report.html이다 |
| URL 목록이나 노출 식당 집계를 JSON으로만 남김 | 최종 HTML 탭에도 같이 수록한다 |
이 프로젝트에서는 경로를 그냥 SKILL.md에 박자pipeline map 없이도 대충 찾으면 된다probe는 옵션으로 두자HTML은 요약본 하나만 만들자이 말이 나오면 스킬 패키징 목표에서 벗어난 것이다. 절대경로를 제거하고, 프로젝트 적응점은 모두 pipeline-map으로 되돌린다.