KIWAMI AI 配布版 — 使い方ガイド

1. これは何か

6部門の AI 部長 + AI 店長の体制で、売上・人事・運営・施設・品質・営業を分析・レポート化するシステムです。Claude Code (CC) 上でスキルとして動作します。

AI店長（/sauna-tencho）
├── 財務AI部長（/sauna-bucho-finance）
├── 営業AI部長（/sauna-bucho-sales）
├── 人事AI部長（/sauna-bucho-hr）
├── 運営AI部長（/sauna-bucho-ops）
├── 施設AI部長（/sauna-bucho-facility）
└── 品質AI部長（/sauna-bucho-compliance）

スキルを実行すると、CSV データを読み取って健康診断レポートを 06_レポート/daily/ に生成します。

2. 前提環境

項目	要件
Claude Code デスクトップアプリ	macOS / Windows 版をインストール済み
Google Drive	共有ドライブ「株式会社REVIVE」がマウントされていること

Claude Code のダウンロード: claude.com/claude-code

3. 起動手順

Claude Code アプリを起動

アプリケーションフォルダ（またはスタートメニュー）から Claude Code を起動します。

プロジェクトフォルダを開く

画面の「プロジェクトを開く」から、以下のフォルダを選択:

共有ドライブ/株式会社REVIVE/kiwami ai (未完)

フルパス:

/Users/〈あなたのユーザー名〉/Library/CloudStorage/GoogleDrive-〈あなたのメール〉/共有ドライブ/株式会社REVIVE/kiwami ai (未完)

ローカル kiwami ai (未完)

タスクを説明するか、質問を入力してください

↑ プロジェクト選択エリアに kiwami ai (未完) が表示され、オレンジ枠で強調されていれば選択完了

このフォルダを「プロジェクトルート」として認識し、配下の .claude/skills/sauna-* が利用可能になります。

動作確認

プロンプト入力欄で / を入力すると、使えるスキル一覧が表示されます。sauna- で始まるスキルが16個並んでいればOKです。

4. スキル一覧

4-1. 統括・部長系（レポート生成）

スキル	役割	出力先
`/sauna-tencho`	AI店長：6部長を順次実行し、統合経営レポートを作成	`06_レポート/daily/`
`/sauna-bucho-finance`	財務：売上・光熱費・経費・人件費の健康診断	`06_レポート/daily/`
`/sauna-bucho-sales`	営業:会員動向・口コミ・キャンペーンROI	`06_レポート/daily/`
`/sauna-bucho-hr`	人事：勤怠・シフト・採用・保険の統合分析	`06_レポート/daily/`
`/sauna-bucho-ops`	運営：日報・在庫・インシデントを統合	`06_レポート/daily/`
`/sauna-bucho-facility`	施設：設備点検・水質管理	`06_レポート/daily/`
`/sauna-bucho-compliance`	品質・コンプライアンス：許認可・衛生・ヒヤリハット	`06_レポート/daily/`

4-2. 個別業務スキル

/sauna-daily-report

日次売上レポート（単独実行）

/sauna-utility

光熱費分析・省エネ提案

/sauna-review

口コミ監視・返信ドラフト生成

/sauna-campaign

キャンペーン効果測定（ROIベース）

/sauna-inventory

在庫確認・発注提案

/sauna-inspection

設備点検・水質アラート

/sauna-nippo

日報の自動生成

/sauna-permit

許認可・届出の期限管理

/sauna-emergency

緊急事態対応手順の案内

5. よくある使い方

パターン A: 毎日の経営確認（推奨）

/sauna-tencho

AI店長が配下の6部長を順次呼び出し、各部門の健康診断 → 統合レポートを生成します。結果は 06_レポート/daily/YYYY-MM-DD_{レポート名}.md に保存されます。

パターン B: 財務だけ深掘り

/sauna-bucho-finance           # 日次レポート
/sauna-bucho-finance 月次      # 月次トレンド分析

売上実績・光熱費率・人件費率・営業利益率を分析し、閾値超え項目を警告します。

パターン C: 特定の操作

/sauna-review          # 未返信口コミに返信ドラフトを作る
/sauna-inventory       # 発注リストを作る
/sauna-utility 月次    # 光熱費の月次トレンド

6. データ構造

スキルは以下のフォルダ構造を参照します:

kiwami ai (未完)/
├── 01_データ/                      # AIが読み取る実データ
│   ├── master/                    # マスターデータ（備品・グッズ・ドリンク等）
│   ├── daily/                     # 日次データ（売上・勤怠・点検・報告）
│   ├── monthly/                   # 月次データ（KPI・光熱費・経費・人件費）
│   └── yearly/                    # 年次データ（保険・許認可）
├── 02_業務マニュアル/              # 会議議事録・面談記録（配布版では最小構成）
├── 06_レポート/                   # スキルのレポート出力先
│   └── daily/                    # 日次レポート保存ディレクトリ
├── 07_設定/                       # KPI閾値・店舗情報（kiwami-config.json）
├── 08_変換スクリプト/              # データ変換用Python/Bashスクリプト
├── .claude/skills/sauna-*/        # 16スキルのSKILL.md定義
├── AGENTS.md                      # 体制・データ参照先の定義
├── CLAUDE.md                      # CC起動時にロードされる指示書
└── README.md / README.html        # このガイド

7. 配布版の制約

本配布版は、外部共有可能な最小セットとして切り出したものです。以下は含まれません:

除外対象	理由
会員マスター原本 / 取引ログ原本	PII（氏名・電話・住所）→ マスキング版のみ収録
従業員マスター / スタッフ面談記録	PII → `/sauna-bucho-hr` は集計処理のみ動作
店舗固有マニュアル（共通/本店/大須）	運営機密
システム開発コード（staff-line-api 等）	社内開発リソース
外部API認証情報（freee / Notion / Google Cloud）	接続不可

挙動の差分

/sauna-bucho-hr: PII原本なしのため集計値のみ表示
/sauna-bucho-sales: 会員データはマスキング済み仮名キーのみ
データ取込系コマンド（sync-*）: API認証なしで動作しない

8. トラブルシューティング

スキルが一覧に出てこない

開いているプロジェクトが kiwami ai (未完)/ になっているか確認
画面上部のプロジェクト名表示を確認。別フォルダを開いている場合は「プロジェクトを開く」からやり直し
それでも表示されない場合は、Claude Code アプリを一度終了して再起動

「データがない」と言われる

01_データ/ 配下に CSV が存在するか確認（Drive 同期が未完了の可能性）
Google Drive アプリのステータスで「最新の状態」になっているか確認

パスエラーが出る

SKILL.md 内の ROOT は dirname $0/../../.. で自動解決する作りなので、プロジェクトを別の場所にコピーしても基本動きます
それでもエラーが出る場合は、.claude/skills/sauna-*/SKILL.md の冒頭にある ROOT 定義を確認

レポート出力先が見つからない

06_レポート/daily/ にファイルが生成されます
Drive 同期が反映されるまで数秒〜数分かかることがあります

9. さらに詳しく

AGENTS.md — 各 AI 部長の役割・データ参照先・エスカレーション基準
CLAUDE.md — プロジェクト全体の設計思想・PII 参照ルール
各スキルの .claude/skills/sauna-*/SKILL.md — スキルごとの詳細仕様

10. お問い合わせ

不具合や改善要望は配布元までご連絡ください。