app-store-compliance — アプリストア審査のリジェクトを防ぐ検査ツール
mjmirza/app-store-compliance
★ 1,899 ・ Shell
概要
app-store-compliance は、iOS(App Store)およびAndroid(Google Play)向けアプリの審査リジェクトを事前に防ぐことを目的としたオープンプレイブック兼静的スキャンツールです。
モバイルアプリの公開プロセスでは、審査提出後に数日待たされた上で不合格となり、原因の特定と修正に多くの日数を要することがあります。本プロジェクトは、117件のリジェクトパターンと具体的な修正方法、EU AI法やDSA、COPPAといった95の規制・法改正スケジュールの追跡、さらには各種AIコーディングツールのフック(Hook)やスキル(Skill)として動作する自動ガードスクリプトを提供します。
提出前にローカル環境やCI環境でリスクを検出したいアプリ開発者や、Claude CodeやCursorなどのAIコーディングアシスタントを活用してアプリ開発を行うエンジニアに向いています。
主な特徴
-
117のリジェクトパターンと修正法のドキュメント化 AppleおよびGoogleの審査ガイドラインに基づくリジェクト事例を網羅し、曖昧な不合格通知に対して該当するガイドライン番号と具体的な対処法を紐付けて参照できます。
-
提出前の自動ガードスクリプト(app-store-compliance-guard.sh) ローカルのソースコードディレクトリを指定してスクリプトを実行するだけで、重大なリジェクトリスクをスキャンします。小規模プロジェクトであれば約1秒、大規模なプロジェクトでも約1分で解析が完了します。
-
主要なリジェクト要因への重点対応 審査で頻出する「動作確認用デモアカウントと稼働中バックエンドの準備」「アプリの実装や組み込みSDKと完全に一致するプライバシー申告・マニフェスト」のチェックが優先して組み込まれています。
-
幅広いAIコーディングツールとの統合 Claude Code、Codex CLI、Gemini CLI、Cursor、GitHub Copilot、Grok、Qwen Code、Kimi Code、Factory Droid、Windsurfなど、多様なAIツールの事前実行フックとして組み込み可能です。
-
Managed Expo環境のサポート ネイティブコードのフォルダが存在しないManagedなExpoアプリであっても、
app.jsonやapp.configから目的記述文字列(Purpose Strings)、プライバシーマニフェスト、Androidのパーミッション設定を読み取って検査します。
使い方
1. 手動でのワンタイムスキャン
GitとBash環境があれば、リポジトリをクローンしてスクリプトを実行するだけでコードを変更せずに検査を行えます。
git clone https://github.com/mjmirza/app-store-compliance ~/repositories/app-store-compliance
bash ~/repositories/app-store-compliance/agent-os/hooks/app-store-compliance-guard.sh "/path/to/your/app"
/path/to/your/app の部分を、検査対象となるXcodeプロジェクトまたはAndroidアプリが存在するフォルダパスに置き換えます。スキャンが終了すると、検出されたリスクが一覧表示され、末尾にステータスが出力されます。
BLOCKED.: 重大なリジェクトリスクが検出された状態です。出力された[CRITICAL]行とそれに付随する修正手順(fix.)を確認して修正後、再実行します。CLEAR.: コード上に重大なリスクが見つからなかった状態です。アカウントやストア掲載情報など、コード以外のチェック項目へ進むことが推奨されます。NOT CHECKED.: 指定パスにiOSやAndroidのプロジェクトが見つからない場合や、一時スキャンファイルの書き込みができなかった場合に出力されます。Expoアプリでネイティブコードも対象に含めたい場合は、事前にnpx expo prebuildを実行することが案内されています。
2. AIコーディングツールへの自動ガード導入
AIエージェントによるアップロードコマンドなどの前に自動スキャンを挟む場合、インストーラスクリプトを実行します。Claude Code以外のツールでは、事前にPython 3が必要です。
git clone https://github.com/mjmirza/app-store-compliance ~/repositories/app-store-compliance
bash ~/repositories/app-store-compliance/scripts/install.sh --tool all
--tool all を指定すると、検出された対応ツールすべてに対してインストールが行われます。個別ツールにのみ導入したい場合は、--tool codex や --tool cursor のようにツール名を指定します。
導入後は各ツールの再起動や設定の承認が必要です。例えば、Codex CLIでは /hooks コマンドを実行して新しいフックを承認する必要があり、Gemini CLIの場合はバージョン0.22以上(スキルの利用には0.24以上)が必要とされています。
技術的なポイント
-
シェルスクリプト主体の軽量ガード設計 コアとなる検査スクリプトはBashスクリプトで構成されており、プロジェクトの依存関係を汚染することなく単体で素早く実行できるように設計されています。
-
ツールの設定ファイルを破壊しない安全機構
install.shは各AIツールの設定ファイル(~/.claude/settings.jsonや~/.cursor/hooks.jsonなど)を更新する際、既存の設定を保持し、日付付きのバックアップを作成します。また、JSON構文が無効な場合やキーが重複している場合は自動書き換えを行わず、手動で貼り付けるためのブロックを出力する設計になっています。 -
Kimi Codeなどの機密情報への配慮 APIキーなどが含まれる可能性がある
~/.kimi-code/config.tomlに対しては、特定の[[hooks]]ブロックの追加・削除のみを行い、ファイル全体の再書き込みや標準出力への表示を行わない仕組みが取られています。
注意点
-
ライセンスの確認が必要 GitHubのリポジトリメタデータ上ではライセンスが「不明(None)」となっています。利用や改変、組織内での再配布を行う際は、リポジトリ内の最新状況やライセンスファイルの有無を確認してください。
-
未対応ツールの手動設定 すべてのCLIツールが自動インストーラに対応しているわけではありません。例えば Kiro CLI のように、プロトコル上はコマンドフックに対応していても自動配線スクリプトが未提供のツールについては、
.kiro/hooks/に手動で設定ファイルを作成する必要があります。 -
コード外の要件 ガードスクリプトはソースコードや設定ファイルを静的にスキャンするものであり、App Store ConnectやGoogle Play Console側で入力する審査情報、テスター用アカウントの稼働状況などは別途チェックリストを参照して人手で確認する必要があります。
まとめ
app-store-compliance は、モバイルアプリ開発における審査落ちの手間と手戻りを減らすためのチェックリストと自動スキャン用シェルスクリプトを提供するプロジェクトです。ローカル単体での実行はもちろん、各種AIエージェントのガードレールとしても組み込むことができるため、ストア申請を控えた開発プロセスにおいて有用な選択肢となります。





