awangwang123/jianhao-travel-planner

出行路书工作流 skill：联网实查 + 多源交叉验证，产出可核验、能执行的旅行攻略。覆盖吃住行游拍避全维度，附美食情报卡、基准骨架与校验工具，支持一键部署在线版。

见好 · 旅行规划器

What it is – “이번 주말에 X로 여행 가고 싶어”와 같은 간단한 요청을 오프라인에서 읽을 수 있는 완벽한 여행 가이드로 변환하는 Claude‑AI skill 입니다. 이 스킬은 사용자의 선호도를 수집하고, 공개 소스에서 최신 정보를 가져와 다음 두 가지 결과물을 생성하는 고정된 워크플로우를 따릅니다.

단일 파일 HTML 여행 가이드 (인터넷 없이 작동하는 전체 버전 및 직접 배포 가능한 경량 온라인 버전).
“음식 정보 카드” (도시별 식당 데이터를 시간에 따라 축적).

결과물은 개요, 교통, 일일 일정, 티켓, 팁, 숙박, 예산, 비상시 대처, 음식 목록, 지역 특산품 등 10개의 섹션으로 구성되며, 각 섹션에는 실제 사진, 손으로 그린 경로 지도, 검증된 가격 및 이용 가능 데이터가 포함되어 있습니다.

주요 기능

📄 단일 파일 HTML 여행 가이드 – 데스크톱, 모바일, 인쇄물로 보기에 좋으며 완전히 오프라인에서 열 수 있습니다.
🌐 선택적 원클릭 온라인 배포 – 자체 서버에 호스팅할 수 있는 슬림한 HTML 버전.
🔍 검증된 정보 – 가격, 영업시간, 교통편 등 핵심 사실은 실시간 소스(예: 대중점평, 고덕지도, 샤오홍슈)와 대조되며 출처가 명시됩니다.
🖼 실제 사진 + 손으로 그린 지도 – 일반적인 스톡 이미지가 아닌, 최근 Wikimedia 이미지나 필요에 따라 Pexels 또는 AI 생성 플레이스홀더를 사용합니다.
🍜 구조화된 음식 추천 – 필수 요리와 평균 비용이 포함된 일별/식사별 목록.
✅ 내장 체크리스트 – tools/checklist.py가 AI가 문서를 완성하기 전에 11가지 자동 일관성 검사를 수행하여 정보 누락을 방지합니다.
🔒 개인정보 유출 방지 – 이 스킬은 민감한 사용자 정보를 절대 저장하지 않습니다.

작동 방식 (상위 수준 흐름)

트리거 – Claude에게 트리거 문구를 말합니다 (예: “周末想去厦门玩”).
선호도 수집 – 스킬이 SKILL.md의 사용자 프로필 템플릿(출발 도시, 음식 선호도, 여행 스타일 등)을 읽습니다.
실시간 데이터 가져오기 – 날씨, 교통편, 티켓 가격, 식당 리뷰 등을 공개 API/웹 소스에서 쿼리합니다.
문서 생성 – Markdown 소스(md 파일)를 채우고 assets/에 있는 두 개의 HTML 템플릿을 렌더링합니다.
자체 검사 – tools/checklist.py(및 데이터 정제용 tools/desource.py)를 실행합니다. 11가지 검사 중 하나라도 실패하면 Claude가 문제를 수정하도록 유도됩니다.
전달 – 단일 파일 HTML 여행 가이드와 음식 정보 카드를 받게 됩니다.

빠른 설치 (약 2분)

저장소 다운로드 및 압축 해제. 최상위 폴더 이름은 반드시 jianhao‑travel‑planner여야 합니다.
폴더 배치 – Claude의 스킬 디렉토리에 넣습니다:
- 전역: ~/.claude/skills/ (Windows: C:\Users\<User>\.claude\skills\).
- 또는 프로젝트 로컬: <your‑project>/.claude/skills/.
경로 확인 – …/skills/jianhao-travel-planner/SKILL.md가 보여야 합니다.
(선택) Pexels API 키 설정 – Pexels 이미지를 사용하려면 저장소 루트의 .env 파일에 PEXELS_API_KEY=your_key를 추가하세요.
프로필 작성 – SKILL.md를 열고 “用户档案（填空模板）” 섹션으로 이동하여 플레이스홀더(거주 도시, 음식 선호도, 여행 속도 등)를 채우세요.
Claude와 대화 – “周末想去成都玩”와 같은 트리거 문구를 말하면 스킬이 워크플로우를 시작합니다.

현재 상태

활발히 유지보수 중 (최신 버전 v1.7, 2026‑10‑08).
MIT 라이선스로 오픈 소스화.
GitHub Discussions를 통한 커뮤니티 주도 기능 요청 (예: “도시 위시풀”).

TL;DR – 见好·旅行规划器는 단 한 번의 음성 요청으로 검증된 데이터, 실제 사진, 음식 추천 카드가 포함된 아름답게 포맷된 오프라인 여행 가이드를 생성하는 Claude‑AI 스킬입니다. 유료 API는 필요하지 않습니다.