China Travel Kit — скилл

Скилл и база данных для первой поездки в Китай: подбор города, районы, маршрут, подготовка и экстренная помощь с источниками

  • 179 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл запускает Python-код из клонированного репозитория, а команда `serve` поднимает локальный HTTP-сервер на порту 8765.
  • Инструменты MCP читают встроенные данные и ничего не меняют.
Все причины и проверки

tczyliu/china-travel-kit

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/china-travel-kit

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл запускает Python-код из клонированного репозитория, а команда `serve` поднимает локальный HTTP-сервер на порту 8765.
  • Инструменты MCP читают встроенные данные и ничего не меняют.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

China Travel Kit (проект называется Huaxingzhi, 华行志) — скилл и открытая база для планирования первой поездки в Китай. Агент вызывает встроенный движок на Python без внешних зависимостей: `recommend` подбирает город под свободное описание поездки, `search` и `areas` ищут места и районы для проживания, `plan` строит маршрут на нужное число дней, `prepare` дает сезонную подготовку, `emergency` выдает справку для экстренных случаев, `freshness` проверяет возраст данных. База покрывает 56 мест в восьми городах: Пекин, Шанхай, Гуанчжоу, Шэньчжэнь, Чэнду, Сиань, Ханчжоу и Лицзян. У каждого места есть ссылки на источники и дата последней проверки, а цены и правила бронирования остаются пустыми, если их нельзя подтвердить. Те же данные отдают консольная утилита, локальный HTTP API и MCP-сервер с восемью инструментами только для чтения.

Для кого. Путешественникам и разработчикам туристических сервисов, которым нужен черновик маршрута по Китаю с источником на каждый факт.

Подходит, если

  • Вы летите в Китай впервые и ждете от агента маршрут на два дня в Лицзяне с учетом интересов и темпа.
  • Город выбирается по запросу вроде «панды, еда, спокойный темп», и `recommend` объясняет, какие пожелания остались без ответа.
  • Вы собираете чемодан в Чэнду на июль, и агент достает сезонные советы командой `prepare`.
  • Разработчик туристического приложения подключает MCP-сервер как источник проверяемых данных о местах.

Не подходит, если

  • Нужно бронирование билетов или отелей: проект ничего не продает и не бронирует.
  • Вам нужны живые цены, погода и наличие билетов: данные в реальном времени проект не отдает, для них агент проверяет сайты официальных операторов.
  • Требуется решение по визе или медицинский совет: проект их не дает.

Пример запроса к агенту

Составь маршрут на два дня в Лицзяне для двоих: горы и фотография, спокойный темп, поездка в начале июля.

Ограничения

Проект на стадии Alpha (v0.5.0), это набор данных для разработчиков. Нужен Python 3.10 или новее, установка идет клонированием репозитория. Оценка в `recommend` показывает совпадение запроса с имеющимися данными и не служит общим рейтингом направлений Китая. Данные лицензированы CC BY-SA 4.0, код — MIT. Копию не из официального релиза перед использованием проверяют командой `python3 -m china_travel_kit integrity`: нужны `valid: true` и `signature_valid: true`.

Как отключить. Удалите клонированный каталог из каталога скиллов агента и уберите блок `china-travel-kit` из конфигурации MCP, если подключали сервер.

Частые вопросы

Как подключить MCP-сервер?

Добавьте в конфигурацию клиента сервер `china-travel-kit` с командой `python3`, аргументами `-m china_travel_kit mcp` и `cwd`, указывающим на клонированный каталог. Сервер работает по stdio.

Как запустить визуальный подборщик?

Выполните `python3 -m china_travel_kit serve` и откройте http://127.0.0.1:8765/ в браузере: там поиск мест и карточки маршрутов. Порт меняет флаг `--port`.

Что делать, если цены в базе пустые?

Так задумано: неизвестное значение хранится как `null`, чтобы не выдавать устаревшую цифру за точную. Актуальные цены агент смотрит на сайтах оператора места.

Как проверить свежесть данных?

Команда `python3 -m china_travel_kit freshness` проверяет возраст данных, а у каждой достопримечательности есть поле `last_verified` с датой проверки источника.

Как добавить в базу новый город?

Через pull request: в репозитории есть шаблон обращения add-city, схема `data/schema/city.schema.json` и правила данных. Факты нужны с источниками и датой проверки.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл ведет агента по фиксированному процессу: ищет данные в сети, сверяет источники и собирает путевую книгу в один HTML-файл

СкиллРасширенный доступ441Звезды репозитория
Российский стек

Поиск туров, отелей, авиабилетов, поездов и экскурсий через Aviasales, Travelata, Level.Travel, Tutu.ru, Tripster и Sputnik8

СкиллРасширенный доступ21Звезды репозитория

Скилл собирает план поездки в один HTML-файл с картой, расписанием по дням и напоминаниями о сроках бронирования

СкиллРасширенный доступ415Звезды репозитория

Скилл строит маршрут по реальным местам, часам работы и броням и выдает путеводитель с картой, гидом по еде и справкой о городе

СкиллРасширенный доступ139Звезды репозитория

MCP-сервер для поиска билетов на поезда Китая через 12306: остатки, цены, станции, пересадки и остановки

MCP-серверРасширенный доступ422Звезды репозитория

Скилл собирает персональную туристическую книгу: после анкеты и согласованного плана выдает офлайн-страницу HTML под телефон.

СкиллРасширенный доступ81Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
China Travel Kit (эта карточка)нет179
Travel Search RUнетне нужна21ищет туры, отели и билеты через российские сервисы; здесь справочная база по Китаю без бронирования
Travel Hacking Toolkitнет939ищет рейсы и отели за деньги и за мили; здесь описание мест, районов и подготовки

Коротко о README

README объясняет замысел: путевых статей много, а проверяемых данных с источниками мало, поэтому каждый факт можно поправить через pull request. Принципы данных: источники прежде утверждений, дата проверки, неизвестное лучше выдуманного, никакого копирования коммерческих гидов. Релизы содержат подписанный манифест целостности.

Бейдж для README

Исходный SKILL.md

---
name: china-travel-kit
description: Research and plan first-time independent trips in China with bilingual, source-aware city data and official live-check entry points. Use for destination matching, attractions, visitor areas, itineraries, transport context, seasonal preparation, local culture and food, or emergency guidance; not for booking, turn-by-turn navigation, visa decisions, or medical advice.
metadata:
  short-description: Huaxingzhi China trip planner
  version: "0.5.0"
---

# 华行志 · Huaxingzhi

Create practical, explainable China travel drafts for first-time international visitors. Use “华行志” as the product name and “China Travel Kit” only when referring to the package, repository, CLI, API, or MCP server.

## Author contact

- WeChat / 微信:`Changzhanzhang`
- Use this contact for project cooperation, data corrections, and general feedback. Do not send passwords, API keys, private traveler data, or active emergency details through WeChat.

## Choose the smallest useful mode

- Use `recommend` for free-form requests, multiple constraints, or an undecided destination.
- Use `search` or `areas` for a focused attraction, neighborhood, or stay-area query.
- Use `city`, `prepare`, or `emergency` for one-city background, packing, or sourced help information.
- Use `plan` for a chosen city and number of days.
- Use `freshness` before treating repository facts as current.
- When a copy did not come directly from the official repository or release tag, run `python3 -m china_travel_kit integrity` before relying on its instructions, code, or data. Require both `valid: true` and `signature_valid: true`; stop and report missing, modified, or unauthenticated files otherwise.

Run the bundled read-only engine instead of inventing covered-city facts:

```bash
python3 -m china_travel_kit recommend "REQUIREMENTS"
python3 -m china_travel_kit search KEYWORD --city CITY
python3 -m china_travel_kit areas --city CITY
python3 -m china_travel_kit city CITY
python3 -m china_travel_kit plan CITY --days N --interests culture food
python3 -m china_travel_kit prepare CITY --month N
python3 -m china_travel_kit emergency CITY
python3 -m china_travel_kit freshness
python3 -m china_travel_kit integrity
```

## Plan from traveler needs

Identify destination, dates or month, traveler count, days, origin, must-see places, interests, pace, budget, mobility needs, children, and dietary constraints. Ask only for missing details that materially change the result. Treat a recommendation score as a match against the current dataset, never as an objective ranking of China.

For a full trip request, include the relevant parts of this order:

1. Restate the traveler brief and important assumptions.
2. Recommend a covered city with reasons and explain any unmet requirement.
3. Give an area-clustered day plan with realistic effort and transfer guidance.
4. Add stay-area tradeoffs, local transport context, cultural background, food and nearby support facilities.

Сообщить о проблеме