keyvox-reservationlisted

# keyvox-reservation KEYVOX予約管理5業務を1スキルで対応する。 ## ⚠️ 環境前提・再認証・典型エラー このスキルは **Claude.ai のカスタムコネクタ** 経由でのみ動作します。 401 / E2003 / DCR エラー時の対処、再認証の定型応答、Claude 向けガイドラインは以下に集約しています: 👉 **必読**: [`references/keyvox-mcp-setup.md`](../references/keyvox-mcp-setup.md) エラー発生時は同ファイル内の「**401 / E2003 エラー時にユーザーへ返す定型応答**」を **そのまま** ユーザーに出力すること（要約・言い換え禁止）。 ## 共通リファレンス スキル本文を読み始める前に、以下の参照ドキュメントを把握しておく: - `references/keyvox-entities.md` — リソース定義（place / unit / reservation 等） - `references/keyvox-tool-map.md` — 業務→ツール対応 - `references/keyvox-id-resolution.md` — 部屋名/日付/顧客名 → ID 解決 - `references/keyvox-enums.md` — orderStateCode 等のenum ## ⚠️ 不可逆操作の原則 以下のツールは **必ずユーザーの最終確認を取ってから呼ぶ**: - `createReservation` — 予約作成 - `updateReservation` — 予約変更・延長 - `cancelReservation` — 予約キャンセル 確認の形式は「対象予約の概要 + 変更内容 + "実行してよいですか？"」を提示し、ユーザーが「はい」「OK」等を返した時のみ実行する。 ## シナリオ判別 ユーザー発話から以下のシナリオを判別: | 発話パターン例 | シナリオ | |---|---| | 「明日14時から3時間予約して」「新規予約」 | A. 新規予約作成 | | 「今日の予約」「明日の予約一覧」 | B. 予約確認 | | 「101号室の予約を3時間延長」「終了時刻を遅らせて」 | C. 延長 | | 「予約時間を変更」「部屋を変更」 | D. 変更 | | 「予約キャンセル」「予約を取り消し」 | E. キャンセル | --- ## A. 新規予約作成 ### 🔑 鍵情報の出力ルール（唯一の正典・これ以外は扱わない） ゲストに提示・配布してよいのは、意味としては **2 つだけ**: | 出力してよいもの | 用途 | |---|---| | 暗証番号 | パネル直接入力 | | ウォレット取込用URL | スマホウォレットに取り込める短縮鍵URL | **API ごとにフィールド名が違う** ので、発行経路に応じて正しいフィールドを使うこと: | 取得元 (API) | 暗証番号 | ウォレット取込用URL | 想定ケース | |---|---|---|---| | `getReservation.unitPinList[]` | `pin` (= `panelPin`) | `qrShortUrl` | 予約紐付きの鍵 (本スキルのデフォルト) | | `createLockPin` (レスポンス) | `pinCode` | `shortQr