rollinggo-hotel-booking — скилл для Claude Code: обзор и установка
Скилл rollinggo-hotel-booking для Claude Code ищет отели, сравнивает цены на номера, оформляет бронирование и отменяет заказы через API RollingGo.
MIT 6 установок ★ 6 обновлён 2026-10-14
npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a claude-codeЧто делает rollinggo-hotel-booking
Скилл подключает агента к API бронирования отелей RollingGo через CLI-утилиту rgg. Агент может находить гостиницы по городам, достопримечательностям или станциям метро, фильтровать варианты по бюджету, звёздам и удобствам вроде бассейна или завтрака, а также проверять доступные номера и сопровождать процесс заказа.
Для работы скилла в окружении необходима команда rgg. Инструмент устанавливают через npm пакетом @rollinggo/hotel-global@latest, запускают готовый скрипт python scripts/install.py либо вручную размещают бинарный файл в PATH. Без установленной утилиты rgg запросы к каталогу гостиниц завершатся ошибкой.
Какие задачи решает
- найти отели рядом с нужной локацией или станцией метро
- отфильтровать гостиницы по бюджету, звёздам и наличию бассейна
- сравнить цены и категории свободных номеров в реальном времени
- оформить бронирование или узнать штраф перед отменой заказа
Примеры запросов агенту
- Найди отели рядом с Санлитуном в Пекине с бассейном и завтраком
- Сравни цены на двухместные номера в этих двух гостиницах
- Проверь статус заказа и рассчитай штраф при отмене брони
Как установить rollinggo-hotel-booking
1Через Skills CLI (Vercel)
npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a claude-code2Вручную: положить файлы
~/.claude/skills/rollinggo-hotel-booking/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rollinggo-hotel-booking/
1Через Skills CLI (Vercel)
npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a codex2Вручную: положить файлы
.agents/skills/rollinggo-hotel-booking/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a cursor2Вручную: положить файлы
.cursor/skills/rollinggo-hotel-booking/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install RollingGo-AI/rollinggo-hotel-skill-global skills/rollinggo-hotel-booking2Вручную: положить файлы
.github/skills/rollinggo-hotel-booking/SKILL.md1Через Skills CLI (Vercel)
npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a gemini-cli2Командой платформы
gemini skills install https://github.com/RollingGo-AI/rollinggo-hotel-skill-global --path skills/rollinggo-hotel-bookingВручную: положить файлы
.devin/skills/rollinggo-hotel-booking/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о rollinggo-hotel-booking
Как установить rollinggo-hotel-booking в Claude Code?
Выполните команду npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a claude-code в терминале.
Что делает rollinggo-hotel-booking?
Скилл ищет гостиницы через API RollingGo, сравнивает тарифы, помогает забронировать номер и рассчитывает штрафы при отмене заказа.
Какая зависимость нужна для работы скилла?
В системе должна быть установлена утилита rgg. Её можно поставить через npm install -g @rollinggo/hotel-global@latest или запуском python scripts/install.py.
Исходный текст
SKILL.md · MIT
---
name: rollinggo-hotel-booking
version: "1.1.5"
repository: "https://github.com/RollingGo-AI/hotel-skill-global"
description: 'RollingGo Hotel Search & Booking Assistant. Implements the full hotel booking and order management workflow by calling RollingGo hotel APIs. Supported scenarios: ① Search hotels by city, attraction, metro, airport, etc. ② Filter by star rating, budget, tags (pool, breakfast, family, pet-friendly) ③ Query real-time room types and prices for specific hotels ④ Compare multiple hotels ⑤ Guide users to complete booking ⑥ Cancel Order (pre-cancel penalty inquiry & confirm-cancel). Triggers: Find a hotel, book a hotel, search hotels, hotel recommendation, hotel queries, nearby hotels, five-star hotels, homestays, resorts, check prices, check room types, check-in, where to stay, accommodation, rollinggo, travel accommodation, business trip accommodation, family hotels, hotels with a pool, hotels with breakfast, cancel order, cancel booking, refund hotel, cancel hotel reservation.'
metadata:
{
"openclaw": {
"emoji": "🏨",
"skillKey": "rollinggo-hotel-booking",
"requires": {
"anyBins": ["rgg", "npx", "node", "python", "python3", "curl", "wget"]
},
"install": [
{
"id": "node",
"kind": "node",
"package": "@rollinggo/hotel-global@latest",
"bins": ["rgg"],
"label": "Install @rollinggo/hotel-global (npm)"
},
{
"id": "python",
"kind": "exec",
"command": "python scripts/install.py",
"label": "Install rgg standalone binary (python)"
}
]
}
}
---
# RollingGo Hotel Search & Booking Skill
## Installation
If the `rgg` command is not installed locally, you can install it using one of the following three methods:
**Method 1: Via npm (Recommended)**
If Node.js and npm are available, run:
```bash
npm install -g @rollinggo/hotel-global@latest
```
**Method 2: Via Python auto-script (No Node.js needed)**
If Python is available in the environment, you can directly run our automated installation script from the Skill directory. It will automatically detect your OS and download the latest standalone `rgg` binary to your local `bin` folder:
```bash
python scripts/install.py
```
**Method 3: Manual download standalone executable (No Node/Python needed)**
If neither npm nor Python is available, please download the corresponding standalone executable from the following Release page (Windows: `rgg-win.exe` / `rgg-windows.exe`, Mac: `rgg-macos`, Linux: `rgg-linux`):
`https://github.com/RollingGo-AI/oauth-hotel-cli-overseas/releases/latest`
After downloading, rename it to `rgg` (or `rgg.exe` on Windows), grant execution permissions, and place it in the system PATH or the skill directory's `bin` folder.
**⚠️ Auto-Update Interception Principle:**
The CLI tool has built-in version detection. When you execute any `rgg` command, if the console output prompts `📦 New version available!` or `Run the following command to update`, **you must immediately pause the current operation, use one of the above three methods to upgrade the tool to the latest version, and then re-execute the interrupted command.** This prevents booking failures due to expired server endpoints.
---
> ⚠️ **Output Specifications**:
> 1. **DO NOT show any technical details to users**, including but not limited to: tool names (like `search-hotels`, `hotel-detail`), JSON field names (like `hotelId`, `ratePlanId`, `referenceNo`), command line contents, or technical parameters.
> 2. **ONLY show information users care about**: Hotel name, star rating, price, distance, core facilities, tags, and booking link.
> 3. **Results MUST be formatted properly**, with each hotel occupying a separate card. Key information should be separated by line breaks, and stacking them in a single line is prohibited.
> 4. **Price Description**: Prices in search results are reference prices for display purposes. The actual order price is subject to price confirmation, and it must be labeled as "Reference Price" when displayed.
> 5. **Login Authorization**: The user cannot see terminal outputs when conversing via the Agent. After executing `rgg login`, you must extract the authorization link from the output and reply to the user with it. Do not display QR code text.
## When to Use
This Skill should be triggered whenever the user expresses any intent related to hotel accommodations, including but not limited to the following scenarios:
**Search and Discover**:
- Find hotels by location: "Help me find a hotel near Sanlitun, Beijing", "What good hotels are in Sanya", "Accommodation recommendations near West Lake"
- Filter by conditions: "Five-star hotels", "Hotels with a pool", "Accommodations with breakfast", "Family hotels", "Pet-friendly hotels"
- Filter by budget: "Hotels under 500 yuan", "Affordable accommodations", "Luxury hotel recommendations"
- Filter by brand: "Hilton", "Marriott", "Atour", "Ji Hotel"
**Query and Compare**:
- Check prices: "How much is a hotel in Hangzhou per night", "What's the price of this hotel"
- Check room types: "What room types are available", "Are there double rooms", "Family room recommendations"
- Compare accommodations: "Help me compare these two hotels", "Which one is a better deal"
- Check facilities: "Is there a pool", "How far is the metro station", "Is parking convenient"
**Booking and Orders**:
- Book a hotel: "Help me book this hotel", "I want to place an order", "Book a room"
- Query Orders: "My orders", "Previously booked hotels", "Order status"
- Cancellation & Refunds: "Cancel this order", "Refund hotel booking", "Check cancellation penalty fee"
**Trigger Coverage**:
Find a hotel, book a hotel, search hotels, hotel recommendations, hotel queries, nearby hotels, five-star hotels, homestays, resorts, check prices, check room types, check-in, where to stay, accommodation, business trip accommodation, travel accommodation, family hotels, hotels with a pool, hotels with breakfast, business hotels, couple hotels, hot spring hotels, sea view rooms, river view rooms, cancel order, cancel booking, refund hotel, cancel hotel reservation.
## When NOT to Use
- When the user asks about flights, train tickets, car rentals, attraction tickets, or other non-accommodation travel needs.
- When the user is just chatting about travel destinations without clear accommodation intent.
- When the user explicitly states "No need to book" or "Just asking".
---
## Security Gates
> ⚠️ Hotel booking and cancellation involve **actual financial and consumption operations**:
> 1. **Two-Step Confirmation**: First display room types and prices, wait for user confirmation before locking price and booking.
> 2. **Information Completeness**: Must confirm guest's English/Pinyin name and email before booking.
> 3. **Price Confirmation Validity**: Locked price certificate (`referenceNo`) is valid for ~15-30 minutes; re-confirm if expired.
> 4. **Cancellation High-Risk Security Gate (Two-Step Confirmation)**: Order cancellation is **strictly irreversible**. Never submit cancellation without explicit user consent. Must execute `pre-cancel` first to check penalty fees and retrieve voucher (`confirmId`, valid 10 minutes), present the penalty and estimated refund to the user, and only execute `confirm-cancel` upon explicit affirmative user confirmation.
---
## Workflow & Dynamic CLI Discovery
> 💡 **Dynamic Command & Parameter Self-Discovery Rule**:
> 1. **Native Invocation**: Directly call native CLI commands: `rgg <subcommand>` (e.g. `rgg status`, `rgg search-hotels`).
> 2. **Partner Customization (CLIENT_ID)**: Supports zero-code partner customization. If a customized client ID is needed, place a `client_id.txt` file in the skill directory, or pass `rgg login --client-id <id>` on login (e.g. `rgg login --client-id my_partner_id`). The CLI remembers and persists this setting automatically. The default is `rollinggoglobal`.
> 3. **Dynamic Parameter Self-Discovery**: Before executing any subcommand, **ALWAYS run `rgg <subcommand> --help` first to fetch real-time CLI parameter help**, and dynamically construct options based on the latest `--help`!
---
### Business Step Guide
#### Step 0: Login Auth Check
- Run `rgg status` (or `whoami`) to check login status.
- If not logged in, run `rgg login` (add `--client-id <id>` if partner custom ID is needed, ⚠️ **MUST run asynchronously in background**, e.g. `WaitMsBeforeAsync=2000`). Extract authorization link (`https://api.rollinggo.store/s/xxx`) from output and send to user.
#### Step 1: Information Collection
- Confirm Destination (Mandatory), Check-in Date (Default: Tomorrow), Stay Nights (Default: 1 night), Adult Count (Default: 2).
#### Step 2: Get Tag Dictionary (As needed)
- When user mentions specific features (pool, breakfast, family, pet), run `rgg hotel-tags` to find exact tag names.
#### Step 3: Search Hotels
- Run `rgg search-hotels --help` first to inspect current filter parameters, then construct command.
- **placeType Selection Rules** (Must match exactly): `city`, `airport`, `point_of_interest`, `train_station`, `subway_station`, `hotel`, `district/county`, `detailed address`.
**Search Result Card Template** (one card per hotel):
*(CRITICAL: You MUST render the `imageUrl` using standard Markdown image syntax `` and place the image at the end of the template. If `imageUrl` contains unencoded spaces, you must manually replace spaces with `%20`, or wrap the entire URL in angle brackets like `` to ensure proper markdown rendering. Do NOT use HTML `<img>` tags and Do NOT output raw URL strings.)*
```markdown
🏨 {Hotel Name}
⭐ {Star Rating} Stars *(Show if distanceInMeters exists: 📍 {distanceInMeters}m from {Search Location})*
💰 Reference Price {Currency} {Lowest Price}/night
🏷️ {Tag 1} · {Tag 2} · {Tag 3}

```
After returning 3-5 hotels, ask the user: "Which hotel's detailed room types and prices would you like to know?"
#### Step 4: Query Room Types & Real-time Prices
- Run `rgg hotel-detail --help` first, pass selected `hotelId` to fetch room rates.
**Room Type Display Template** (one entry per room type):
```
🛏️ {Room Type Name} ({Bed Type Description})
💰 Total Price {Currency} {totalPrice} ({Currency} {Average Price}/night)
📋 Cancellation Policy: {Cancellation Policy Description}
```
After displaying 3-5 recommended room types, guide the user via conversation: "Please tell me which room type you choose, and I will lock the price and process the order for you."
#### Step 5: Price Confirmation & Booking (Security Gate)
1. Run `rgg price-confirm --help` first, lock price and retrieve `referenceNo`.
2. Confirm guest name & email, run `rgg book --help` to submit order and retrieve payment link.
**Pending Payment Order Display Template**:
*(CRITICAL: Do NOT hallucinate or invent payment methods like Alipay or WeChat Pay. Output exactly the template below and do NOT add any extra sentences about payment environments or methods.)*
```
📝 Order generated, awaiting payment!
Confirmation No: **{orderNo}**
Hotel: {Hotel Name}
Room Type: {Room Type Name}
Check-in: {Check-in Date} | Check-out: {Check-out Date}
Total Price: {Currency} {Price}
📋 Cancellation Policy: {Cancellation Policy Description}
💳 Please complete payment within 30 minutes: {Payment Link}
```
#### Step 6: Query Orders & Details
- Run `rgg orders --help` or `rgg order-detail --help` to query order list or specific order status.
#### Step 7: Cancel Order (High-Risk Two-Step Confirmation)
> ⚠️ **Critical Security Gate**: Cancelling an order is **strictly irreversible**! You must follow the two-step confirmation process:
> 1. Always call `pre-cancel` first to query cancellation penalty fees and the authorization voucher (`confirmId`, valid for 10 minutes).
> 2. Truthfully inform the user about the penalty amount and expected refund. **Only after receiving the user's explicit affirmative confirmation** can you run `confirm-cancel` to submit the cancellation.
1. **Pre-cancel & Query Penalty Fees**:
- Run `rgg pre-cancel --help` to check parameters.
- If user hasn't provided an order number, run `rgg orders` first to identify the order number.
- Run `rgg pre-cancel --order-no <orderNo>`.
- Extract `canCancel`, `penaltyAmount`, `confirmId`, and `bookingId`. If `canCancel` is false, inform the user with customer support guidance: `{message}`.
2. **Verify with User & Obtain Explicit Consent**:
```
⚠️ Order Cancellation Confirmation:
Order No: **{orderNo}**
Hotel: {Hotel Name}
Cancellation Penalty Fee: {Currency} {penaltyAmount}
Estimated Refund: {Currency} {Estimated Refund Amount}
⚠️ Cancellation is irreversible once confirmed. Please confirm if you wish to proceed with the cancellation?
```
3. **Confirm Cancellation (After User's Explicit Consent)**:
- Run `rgg confirm-cancel --help` to check parameters.
- Run `rgg confirm-cancel --order-no <orderNo> --booking-id <bookingId> --confirm-id <confirmId>`.
- Display the result clearly to the user.
**Cancellation Success Display Template**:
```
✅ Order successfully cancelled!
Confirmation No: **{orderNo}**
Refund is being processed and will be returned to the original payment method within 1-3 business days.
```
---
## Semantic Fallback Strategy When Results Are Not Ideal
If search yields 0 results, silently loosen constraints in this order to retry:
1. Remove star rating limits
2. Expand search radius / distance parameters
3. Downgrade hard required tags to preferred tags
4. Increase return quantity (`size`)
5. Retain location and check-in date only
---
## Key Interaction Rules
- **Hide Technical Details**: Never expose `hotelId`, `ratePlanId`, `referenceNo`, raw JSON, or CLI commands to the user.
- **Reference Prices**: Search prices are labeled as "Reference Price"; actual price is locked via price confirmation.
- **Valid Payment Links**: Generated order payment links must be directly clickable for users to complete payment.
- **Multiple Hotel Comparison**: Display multiple hotel cards simultaneously to highlight differences (price/distance/amenities).
---
## Detailed Reference Documents
- [references/cli-params.md](references/cli-params.md) — Complete CLI command parameters specification
© RollingGo-AI · MIT · RollingGo-AI/rollinggo-hotel-skill-global