Treasure AI Studio: Project機能セットアップガイド

/home/agent/projects/<your-project-name>/
│
├── CLAUDE.md                     # プロジェクト設定ファイル（@importで他ファイルを参照）
│
├── skills/
│   ├── data-schema.md            # テーブル・カラム定義
│   └── business-rules.md         # KPI定義・命名規則・業務ルール
│
└── memory/
    ├── MEMORY.md                 # インデックスファイル
    └── decisions.md              # 設計判断の記録

mkdir -p /home/agent/projects/<your-project-name>/skills
mkdir -p /home/agent/projects/<your-project-name>/memory

# Data Schema

## テーブル一覧

### members（会員テーブル）
| カラム | 型 | 説明 |
|--------|-----|------|
| member_id | STRING | 会員ID（PK） |
| age_group | STRING | 年代（'20s', '30s', '40s', '50s+') |
| member_stage | STRING | 会員ステージ（'bronze', 'silver', 'gold', 'platinum') |
| registered_at | TIMESTAMP | 登録日時 |

### card_transactions（カード利用履歴）
| カラム | 型 | 説明 |
|--------|-----|------|
| transaction_id | STRING | 取引ID（PK） |
| member_id | STRING | 会員ID（FK: members） |
| amount | DECIMAL | 利用金額 |
| transaction_date | DATE | 利用日 |
| category | STRING | カテゴリ |

## 許可されたテーブル

AIが参照できるのは以下のテーブルのみ：
- members
- card_transactions

**それ以外のテーブルへのアクセスは禁止**

# Business Rules

## 許可された軸（ディメンション）

| 軸名 | 対応カラム | 許可値 |
|------|-----------|--------|
| 年代 | age_group | '20s', '30s', '40s', '50s+' |
| 会員ステージ | member_stage | 'bronze', 'silver', 'gold', 'platinum' |

## 許可された指標（メトリクス）

| 指標名 | 計算式 | 説明 |
|--------|--------|------|
| カード利用金額 | SUM(amount) | 期間内の合計利用金額 |
| 利用回数 | COUNT(transaction_id) | 期間内の取引回数 |
| 平均利用金額 | AVG(amount) | 1回あたり平均利用額 |

## 期間指定ルール

- 「直近3ヶ月」→ `WHERE transaction_date >= DATE_SUB(CURRENT_DATE, INTERVAL 3 MONTH)`
- 「2024年」→ `WHERE YEAR(transaction_date) = 2024`

**ユーザーが未定義の指標や期間を指定した場合は、SQLを生成せずエラーメッセージを返す**

# Project: Customer Journey Analysis

このプロジェクトでは、顧客行動データからジャーニー分析を行います。

## Data Schema
@import skills/data-schema.md

## Business Rules  
@import skills/business-rules.md

## Guidelines

- **AIの役割**: ユーザーの自然言語リクエストから条件（年代、期間、指標）を抽出
- **システムの役割**: 事前定義されたSQLテンプレートに条件を差し込んで実行
- SQLの構造（JOIN、GROUP BY、集計ロジック）は固定化されており、AIが自由に変更してはいけない

## クロス集計SQLテンプレート

```sql
SELECT
  {縦軸},
  {横軸},
  {集計指標}
FROM {決められた参照表}
WHERE {決められた期間条件}
GROUP BY {縦軸}, {横軸}
```

**{} 部分のみをAIが差し替える。それ以外は変更不可**

## バリデーションルール

実行前に以下をチェック：
1. 抽出した「年代」「会員ステージ」が許可された軸マスターに存在するか？
2. 「カード利用金額」が定義済み指標か？
3. 期間「直近3ヶ月」が許可された範囲か？
4. 外部エクスポートは許可された形式か？

**1つでもNGなら実行停止し、ユーザーに差し戻す**

# Design Decisions

## 2026-05-20: 「平均」の計算を member 単位に統一

**背景**: 当初は transaction 単位で AVG(amount) を計算していたが、営業部から「会員単位の平均」が必要と指摘。

**決定**: 
- `AVG(amount)` → `SUM(amount) / COUNT(DISTINCT member_id)`
- business-rules.md の指標定義を更新

**理由**: 1人で100回利用した場合と100人が1回ずつ利用した場合を区別するため