keyvox-housekeepinglisted
Install: claude install-skill Unlock-the-World/keyvox-mcp
# keyvox-housekeeping
清掃スタッフ向けの計画支援スキル。
## ⚠️ 環境前提・再認証・典型エラー
このスキルは **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` — ID解決パターン
- `references/keyvox-enums.md` — orderStateCode 等
- `skills/keyvox-checkin-status-SKILL.md` — チェックインステータス (`orderStateCode`) 判定。本スキルは「解錠したか / ノーショウか」を判定する点で役割が分離している
## このスキルの中核ロジック
> 📌 **役割分担**: 予約ステータス (`orderStateCode`) でチェックイン済か否かは [`keyvox-checkin-status`](./keyvox-checkin-status-SKILL.md) の領域。本スキルは **「解錠履歴 (`getLockHistory`) を見て実利用 / ノーショウを判定する」** ところを担当する。
**「予約があった = 清掃必要」ではない**。ノーショウ(予約はあったが解錠ゼロ=ゲスト来てない)の場合、清掃不要。判定:
```
Step 1. listReservations で本日範囲の予約取得
Step 2. 各予約について getLockHistory(該当lockId) で
checkin..checkout 間に etype=9 (解錠)イベントがあるか確認
Step 3. 「実利用あり」のみを清掃対象とする
Step 4. 次のチェックイン時刻と現在時刻から「清掃可能時間枠」を算出
```
## シナリオ判別
| 発話パターン | シナリオ |
|---|---|
| 「今日の清掃対象」「清掃計画」 | A. 本日の清掃対象一覧 |
| 「今すぐ清掃に入れる部屋」「空いてる部屋」 | B. 今すぐ入れる部屋 |
| 「今日何件使われた?」「利用件数」 | C. 利用統計 |
---
## A. 本日の清掃対象一覧
### 手順
1. **placeIdを取得** (`place_list` で確認)
2. **本日チェックアウト予定の予約取得**:
```
listReservations(placeId, fromDate=今日0:00 JST, toDate=今日23:59 JST,
page=1, count=100, total=1)
```
`t