RollingGo 酒店搜索与预订 Skill 是一个面向酒店住宿场景的助手工具，通过调用 RollingGo 酒店服务接口，实现从酒店搜索、房型查询、价格确认到下单、订单查询与取消的全流程操作。
一、用途 该 Skill 在用户涉及酒店住宿相关意图时触发，覆盖搜索与发现、查询与对比、预订与订单三大类场景。典型触发包括：按地点找酒店（如“北京三里屯附近酒店”“三亚有什么好酒店”）、按条件筛选（五星、带泳池、含早餐、亲子、宠物友好）、按预算筛选、按品牌筛选、查询房价与房型、比较住宿、了解设施，以及预订酒店、查询订单、取消与退订等。不适用于机票、火车票、租车、景点门票等非住宿类需求，也不适用于无明确住宿意图的闲聊或用户已明确表示“不用订”的情况。
二、主要能力
- 搜索与筛选：支持按城市、机场、景点、火车站、地铁站、酒店、区/县、详细地址等地点类型搜索，并可按星级、预算、标签（泳池、含早、亲子、宠物友好等）筛选。
- 房型与价格查询：可查询指定酒店的实时房型与价格。
- 酒店对比：支持同时展示多家酒店卡片，突出价格、距离、设施等差异点。
- 预订流程：展示房型与价格后，经用户明确选择方可锁价与下单，下单前需确认入住人姓名拼音与邮箱。
- 订单管理：支持查询历史订单、单条订单详情，以及取消订单。
三、使用方式 工具以 CLI 命令 rgh 形式提供。安装方式有三种： 方式一：通过 npm 安装（推荐），执行 npm install -g @rollinggo/hotel@latest； 方式二：通过 Python 自动脚本安装，在 Skill 目录下运行 python scripts/install.py； 方式三：手动下载独立可执行文件，从 Release 页面下载对应单文件程序（Windows: rgh-win.exe / rgh-windows.exe, Mac: rgh-macos, Linux: rgh-linux），重命名为 rgh（Windows 下为 rgh.exe），赋予执行权限并放入系统环境变量 PATH 或技能目录的 bin 文件夹中。
使用流程包括：Step 0 登录授权检查（执行 rgh status，未登录则执行 rgh login 并提取授权链接回复用户）；Step 1 信息收集（目的地、入住日期、晚数、人数）；Step 2 按需获取标签字典（rgh hotel-tags）；Step 3 搜索酒店（rgh search-hotels）；Step 4 查询房型与实时价格（rgh hotel-detail）；Step 5 价格确认与下单（rgh price-confirm、rgh book）；Step 6 查询订单与详情（rgh orders、rgh order-detail）；Step 7 取消订单（rgh pre-cancel、rgh confirm-cancel）。执行任何子命令前，建议先运行 rgh <子命令> --help 获取实时参数帮助。
四、适用场景 适用于需要查找、比较、预订或管理酒店住宿的用户，包括出差住宿、旅游住宿、亲子酒店、带泳池酒店、含早餐酒店、商务酒店、情侣酒店、温泉酒店、海景房、江景房等具体需求。
五、限制与安全门控
- 酒店预订与退订属于真实资金与消费操作，需两步确认：展示房型和价格后，须等用户明确选择方可锁价与下单；下单前须确认入住人姓名拼音与邮箱。
- 锁价时效：锁定的价格凭证（referenceNo）有效期约 15-30 分钟，超时须重新锁价。
- 取消订单为不可逆操作，必须严格执行两步确认：先执行 pre-cancel 查询取消手续费/违约金与凭证（confirmId 凭证 10 分钟有效），向用户明确汇报扣费金额与预计退款，取得用户明确肯定答复后，方可调用 confirm-cancel。
- 输出规范：严禁向用户展示技术细节（工具名、JSON 字段名、命令行内容、技术参数），只展示酒店名称、星级、价格、距离、核心设施、标签、预订链接等用户关心的信息；价格需注明“参考价”，实际下单价以价格确认为准。
- 自动升级拦截：CLI 工具内置版本检测，若输出中出现新版本可用提示，须先升级再重新执行中断的命令。
- 搜索结果不理想时，可按顺序静默放宽条件重试：移除星级范围限制、扩大搜索半径、将硬约束标签降级为软偏好标签、增大返回数量、仅保留目的地与入住日期。
详细参考文档见 references/cli-params.md（CLI 命令完整参数规范）。