keyvox-onsite-supportlisted

# keyvox-onsite-support ゲスト滞在中のトラブル対応スキル。**実物理デバイスに影響する操作（リモート解錠・PIN発行）を含むため、安全フローを最優先で設計**。 ## ⚠️ 安全原則 このスキルが扱う操作は **直接物理ドアに影響する**: - `unlock` → 実際にロックが開く - `createLockPin` → 新しい鍵が物理ロックに配信される - `disableLockPin` → 配信済みPINが即座に無効になる **Claude は絶対に独断で実行しない**。すべての操作について以下のゲートを通る: ``` [1] 状況確認の質問 ↓ [2] 対象ユニット/予約/ゲストの特定 ↓ [3] 現在のロック状態を確認 (getLockStatus) ↓ [4] 何をするかオペレーターに最終確認 ★人間判断ゲート ↓ [5] 操作実行 ↓ [6] 結果報告 (成功/失敗、次のアクション提案) ``` **ゲート [4] の確認文には以下を必ず含める**: - 対象ロック・ユニット・ゲスト名 - 実行するアクション（解錠 / PIN発行 / 等） - 物理的影響の明示（「実際にロックが開きます」等） - 元に戻す手段の有無 ## ⚠️ 環境前提・再認証・典型エラー このスキルは **Claude.ai のカスタムコネクタ** 経由でのみ動作します。 401 / E2003 / DCR エラー時の対処、再認証の定型応答、Claude 向けガイドラインは以下に集約しています: 👉 **必読**: [`references/keyvox-mcp-setup.md`](../references/keyvox-mcp-setup.md) エラー発生時は同ファイル内の「**401 / E2003 エラー時にユーザーへ返す定型応答**」を **そのまま** ユーザーに出力すること（要約・言い換え禁止）。 ## 共通リファレンス - `references/keyvox-entities.md` - `references/keyvox-tool-map.md` - `references/keyvox-id-resolution.md` - `references/keyvox-enums.md` - `skills/keyvox-reservation-SKILL.md` (予約特定で連携) - `skills/keyvox-checkin-status-SKILL.md` (滞在中判定で連携) ## シナリオ判別 | 発話パターン | シナリオ | |---|---| | 「ゲストが鍵忘れた」「QR紛失」「PIN分からない」 | A. 鍵忘れ対応 | | 「中で開かない」「閉じ込められた」「緊急で開けて」 | B. 閉じ込め・緊急解錠 | | 「101号室のロック状態」「最近の解錠履歴」 | C. 状況確認のみ | --- ## A. 鍵忘れ対応 **典型ケース**: ゲストが外出後にQR/PINを紛失。再送 or 一時PIN発行で対応。 ### 🔑 鍵情報の出力ルール（唯一の正典・これ以外は扱わない） ゲストに提示・配布してよいのは、意味としては **2 つだけ**: | 出力してよいもの | 用途 | |---|---| | 暗証番号 | パネル直接入力 | | ウォレット取込用URL | スマホウォレットに取り込める短縮鍵URL |