---
name: store-metadata
description: App Store メタデータ（タイトル・サブタイトル・キーワード・説明文）を日本語 ASO 原則に基づいて最適化生成し fastlane/metadata/ に出力する。「ストアメタデータ」「ASO メタデータ」「/store-metadata」などで自動適用。
---

# メタデータ最適化生成

## CONTEXT

### 適用範囲
App Store のメタデータ（タイトル、サブタイトル、キーワード、説明文、プロモーションテキスト、リリースノート）を
ASO 最適化した状態で生成し、fastlane/metadata/{locale}/ に直接書き出す。

### 用語
- **メタデータ**: App Store Connect で設定するテキスト情報の総称
- **fastlane/metadata/**: fastlane が管理する App Store メタデータのディレクトリ構造
- **4 文字体系**: 日本語の「ひらがな・カタカナ・漢字・ローマ字」の 4 種類の表記体系
- **キーワードフィールド**: App Store Connect の 100 文字キーワード欄（カンマ区切り）
- **最初の 3 行**: 説明文の「続きを読む」タップ前に表示される領域

### 前提条件
- store-craft.config.json が存在すること
- fastlane/metadata/{locale}/ ディレクトリが存在すること（なければ作成する）
- アプリの基本情報（名前、機能、ターゲット）が把握できること

## ROLE

| 属性 | 内容 |
|------|------|
| **専門性** | App Store メタデータ最適化、日本語 ASO コピーライティング、キーワードリサーチ |
| **権限** | fastlane/metadata/{locale}/ 配下のメタデータファイル生成・更新 |
| **責任** | ASO 最適化されたメタデータの生成とキーワード戦略の策定 |
| **禁止事項** | store-craft.config.json の変更、スクリーンショットの変更 |

## INTENT

### Goal
ターゲットペルソナと競合分析に基づき、ダウンロード率を最大化する App Store メタデータを生成する。

### Value
- **V-1**: 日本語 ASO に特化した 4 文字体系バリエーション考慮のキーワード戦略
- **V-2**: fastlane/metadata/ に直接書き出し、`fastlane deliver` ですぐ反映可能
- **V-3**: タイトル/サブタイトル/キーワードの重複排除による 100 文字枠の最大活用

### Success Criteria
- [ ] 全メタデータファイル（6 種）が fastlane/metadata/{locale}/ に生成されている
- [ ] タイトルが 30 文字以内
- [ ] サブタイトルが 30 文字以内
- [ ] キーワードが 100 文字以内で、タイトル/サブタイトルと重複なし
- [ ] 説明文の最初 3 行が強力な訴求を含む

## STEPS

### Step 1: アプリ情報読み込み

```
1. store-craft.config.json を Read で読み込む
2. アプリ名、キャッチコピー、スクリーンショット構成を把握
3. locale を確認（デフォルト: ja）
4. fastlane/metadata/{locale}/ の存在確認、なければ mkdir -p で作成
```

### Step 2: 既存メタデータ確認

```
1. fastlane/metadata/{locale}/ 配下の全ファイルを Glob で検索
2. 存在するファイルを Read で読み込み、現状を把握
3. 現状のキーワード使用状況、文字数を確認
```

### Step 3: 競合分析（オプション）

ユーザーが競合アプリ名を指定した場合、WebSearch で競合のメタデータを調査する。

```
1. 競合アプリ名で App Store 検索結果を WebFetch
2. 競合のタイトル、サブタイトル、キーワード傾向を分析
3. 差別化すべきポイントと狙うべきキーワードギャップを特定
```

### Step 4: metadata-writer エージェント起動

メタデータ生成を `metadata-writer` エージェントに委譲する。

```
Agent(subagent_type: "store-assets:metadata-writer")
prompt: |
  以下のアプリ情報に基づき、ASO 最適化されたメタデータを生成してください。

  ## アプリ情報
  {store-craft.config.json の内容}

  ## 既存メタデータ（あれば）
  {現在の各ファイル内容}

  ## ターゲットペルソナ
  {ユーザー指定のペルソナ情報}

  ## 競合分析結果（あれば）
  {競合のメタデータ分析}

  ## 出力形式
  各メタデータファイルの内容をそれぞれ出力してください。
```

### Step 5: メタデータファイル書き出し

metadata-writer の出力を fastlane/metadata/{locale}/ に書き出す。

```
生成対象ファイル:
- fastlane/metadata/{locale}/name.txt
- fastlane/metadata/{locale}/subtitle.txt
- fastlane/metadata/{locale}/keywords.txt
- fastlane/metadata/{locale}/description.txt
- fastlane/metadata/{locale}/promotional_text.txt
- fastlane/metadata/{locale}/release_notes.txt
```

**書き出し前の検証:**

| ファイル | 検証項目 |
|---------|---------|
| name.txt | 30 文字以内 |
| subtitle.txt | 30 文字以内 |
| keywords.txt | 100 文字以内、カンマ区切り、name/subtitle と重複なし |
| description.txt | 4000 文字以内、最初 3 行の訴求力確認 |
| promotional_text.txt | 170 文字以内 |
| release_notes.txt | 4000 文字以内 |

### Step 6: 自動評価（オプション）

生成後に `/store-evaluate` を実行して品質を確認する。

```
ユーザーに確認:
「メタデータを生成しました。/store-evaluate で品質評価を実行しますか？」
```

## PROOF

### Output
- `fastlane/metadata/{locale}/name.txt` -- タイトル（30 文字以内）
- `fastlane/metadata/{locale}/subtitle.txt` -- サブタイトル（30 文字以内）
- `fastlane/metadata/{locale}/keywords.txt` -- キーワード（100 文字以内）
- `fastlane/metadata/{locale}/description.txt` -- 説明文（4000 文字以内）
- `fastlane/metadata/{locale}/promotional_text.txt` -- プロモーションテキスト（170 文字以内）
- `fastlane/metadata/{locale}/release_notes.txt` -- リリースノート（4000 文字以内）

### Verification
- [ ] 全ファイルが文字数制限内
- [ ] キーワードがタイトル/サブタイトルと重複していない
- [ ] 日本語の自然さが保たれている
- [ ] 説明文の最初 3 行が訴求力を持つ
- [ ] fastlane deliver で利用可能なディレクトリ構造

### Done Criteria
- [ ] 6 ファイルすべてが fastlane/metadata/{locale}/ に書き出されている
- [ ] 文字数制限違反がゼロ
- [ ] キーワード重複がゼロ
- [ ] metadata-writer エージェントの出力が検証済み

### Do / Don't

**Do:**
- ✅ 4 文字体系（ひらがな/カタカナ/漢字/ローマ字）のバリエーションを考慮する
- ✅ キーワードフィールドはタイトル/サブタイトルと重複させない（Apple が自動的に含めるため）
- ✅ 説明文の最初 3 行に全力を注ぐ（「続きを読む」前の領域）
- ✅ 競合分析結果をキーワード戦略に反映する
- ✅ 書き出し前に文字数を正確にカウントする

**Don't:**
- ❌ store-craft.config.json を変更しない
- ❌ スクリーンショットや画像ファイルを変更しない
- ❌ 文字数制限を超過したまま書き出さない
- ❌ 同じキーワードをタイトル・サブタイトル・キーワードフィールドに重複させない
- ❌ 「AIチャット」と「AI チャット」を同一視しない（App Store は別キーワードとして扱う）