build-dmg

このスキルは `xcodebuild archive` と `exportArchive` を実行し、結果を DMG にパッケージ化します。コード署名、プロビジョニング、書き出しオプションを扱います。

譲れないルール：

1. ビルド前にプロジェクト／ワークスペース、スキーム、チーム ID を特定してください。署名 ID を推測してはいけません。
2. スキームが複数ある場合は、どれをビルドするかユーザーに確認してください。
3. 明示的な承認なしに ExportOptions.plist を自動作成または上書きしてはいけません。書き出しオプションが誤っていると、署名なしのビルドや配布形式が異なるビルドになります。
4. プロジェクトのルートからヘルパースクリプト（helpers/build-dmg.sh）を使用してください。xcodebuild コマンドを直接記述してはいけません。
5. xcodegen が検出された場合（project.yml が存在する場合）は、ビルド前に xcodegen generate を実行してください。
6. 生成された DMG のパス、アプリのバージョン、署名状況を明確に報告してください。

build-dmg

入力

• $request：プロジェクト、ワークスペース、スキーム、または署名に関するヒント（省略可能）

目標

次の手順で DMG ビルドを生成します。

• 適切な Xcode ターゲットの入力を特定する
• 同梱のヘルパースクリプトをプロジェクトのルートから実行する
• 生成された DMG のパスと、パッケージ化を妨げている要因を報告する

ステップ 0：パッケージ化の入力を特定する

リポジトリを確認し、次の項目を特定してください。

• アプリ名
• スキーム
• プロジェクトまたはワークスペースのパス
• 存在する場合は ExportOptions.plist の場所
• 存在する場合は VERSION ファイル
• project.yml が xcodegen を示しているかどうか
• すでに設定されている場合はチーム ID または署名に関するヒント

必須の入力項目が曖昧な場合は、ビルド前に確認してください。

成功基準：ヘルパーを実行する前に、ビルド設定が明確になっていること。

ステップ 1：ヘルパーと作業ディレクトリを確認する

ヘルパースクリプトは、このスキルと同じ場所にあります。

• helpers/build-dmg.sh

現在のリポジトリをビルドコンテキストとして使用できるよう、プロジェクトのルートから実行してください。

成功基準：正しいヘルパーのパスとプロジェクトのルートが特定されていること。

ステップ 2：環境を明示してビルドする

次のような必須の環境変数を指定してください。

• APP_NAME
• SCHEME

プロジェクトで実際に必要な場合に限り、次のオプション変数を追加してください。

• PROJECT
• WORKSPACE
• INFO_PLIST
• EXPORT_OPTIONS
• TEAM_ID
• VERSION_FILE
• USE_XCODEGEN
• DMG_BACKGROUND

成功基準：ヘルパーに必要な入力がすべて揃っており、オプションの入力は必要なものだけが指定されていること。

ステップ 3：成功または失敗に適切に対処する

成功した場合は、次の内容を報告してください。

• DMG の出力パス
• 確認できる場合はアプリのバージョンとビルド番号
• VERSION ファイルが変更されたかどうか

失敗した場合は、次の対応をしてください。

• 実際のエラーを要約する
• 関連する xcodebuild または書き出しの失敗を示す行を提示する
• 問題の原因が署名、スキームの選択、書き出しオプション、ビルド失敗のいずれかを特定する

成功基準：ユーザーが使用可能な成果物のパス、または問題を明確にまとめた説明を得られること。

ガードレール

• このスキルを先回りして実行しないでください。
• .claude 内のローカルなヘルパーのパスを想定せず、このスキルのディレクトリ内にあるヘルパーを使用してください。
• 承認なしに書き出しオプションを自動作成または上書きしないでください。
• 署名の失敗を一般的な「ビルド失敗」という要約で隠さないでください。

出力要件

次の内容を報告してください。

1. 特定したアプリ／プロジェクト／ワークスペース／スキームの入力
2. ヘルパーの実行が成功したかどうか
3. 成功した場合は DMG のパス
4. 確認できる場合はバージョン／ビルド情報
5. 失敗した場合は、問題の正確な分類