IOS Icon Gen

# iOS Icon Generator

2 つのソースから Xcode アセットカタログ用の PNG アイコンイメージセットを生成します。

## アクティベートするタイミング

- iOS/macOS Xcode プロジェクト向けアイコンアセットを生成する
- オープンソースコレクション全体でアイコンを検索する
- アセットカタログ用の PNG イメージセット（1x、2x、3x）を作成する
- プレースホルダーアイコンをプロダクション品質のアセットに置き換える
- Xcode プロジェクト内の既存アイコンスタイルに合わせる

## コア原則

### 1. 2 つのソース、1 つの出力フォーマット
どちらのソースも同一の Xcode 互換イメージセットを生成します。必要に応じて選択してください。

| ソース | アイコン数 | 要件 | 最適な用途 |
|--------|----------|------|-----------|
| **Iconify API** | 200 以上のコレクションから 275,000 件以上 | インターネット | 幅広い選択肢、特定スタイル、オープンソースアイコン |
| **SF Symbols** | Apple シンボル 5,000 件以上 | macOS のみ | Apple ネイティブスタイル、オフライン使用 |

### 2. 常に既存スタイルに合わせる
生成する前に、サイズ・色・ウェイトの一貫性について、プロジェクトの既存アイコンを確認してください。

### 3. 出力構造
どちらの方法も完全な Xcode イメージセットを生成します。

```
<output-dir>/<asset-name>.imageset/
  Contents.json
  <asset-name>.png        # 1x（デフォルト 68px）
  <asset-name>@2x.png     # 2x（デフォルト 136px）
  <asset-name>@3x.png     # 3x（デフォルト 204px）
```

## 使用例

### ステップ 1: 要件の確認

アイコンのニーズを決定します。アイコンが表すもの、好みのスタイル、対象の色とサイズ。

プロジェクトにすでにアイコンがある場合は、既存スタイルを確認します。
```bash
# 既存アイコンのサイズを確認
sips -g pixelWidth -g pixelHeight path/to/existing@2x.png
```

### ステップ 2: アイコンの検索

**Iconify API（幅広い選択肢に推奨）:**
```bash
# すべてのコレクションを検索
$SKILL_DIR/scripts/iconify_gen.sh search "receipt"

# 特定のコレクション内で検索
$SKILL_DIR/scripts/iconify_gen.sh search "business card" --prefix mdi

# 利用可能なコレクションを一覧表示
$SKILL_DIR/scripts/iconify_gen.sh collections
```

**SF Symbols（Apple ネイティブスタイル向け）:**
SF Symbols アプリを参照するか、一般的な名前を確認します。

| ユースケース | シンボル名 |
|-------------|-----------|