China Travel Kit — скилл
Скилл и база данных для первой поездки в Китай: подбор города, районы, маршрут, подготовка и экстренная помощь с источниками
- 179 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скилл запускает Python-код из клонированного репозитория, а команда `serve` поднимает локальный HTTP-сервер на порту 8765.
- Инструменты MCP читают встроенные данные и ничего не меняют.
Установка
- Работает в
В терминале, через 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-файл
Поиск туров, отелей, авиабилетов, поездов и экскурсий через Aviasales, Travelata, Level.Travel, Tutu.ru, Tripster и Sputnik8
travel-plan-viz — план поездки в HTML-странице
travel-plan-viz
Скилл собирает план поездки в один HTML-файл с картой, расписанием по дням и напоминаниями о сроках бронирования
Скилл строит маршрут по реальным местам, часам работы и броням и выдает путеводитель с картой, гидом по еде и справкой о городе
MCP-сервер для поиска билетов на поезда Китая через 12306: остатки, цены, станции, пересадки и остановки
Скилл собирает персональную туристическую книгу: после анкеты и согласованного плана выдает офлайн-страницу HTML под телефон.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| 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.