本文へスキップ

004 / RELEASE / IGUANA LAB ORIGINAL

Mobile Release Preflight

バージョン設定・Git差分・権限の増加・テストの証拠を照合し、PASS / WARN / BLOCK を根拠つきで返します。ビルドも署名も公開もしません。

FREELAB ORIGINAL

何をするものか

モバイルのリリース候補を、出す前に読み取りだけで点検するための道具です。「このコードが良いか」ではなく、「いま見ているリリース候補に、止めるべき理由があるか」を見ます。

Expo、React Native、ネイティブのプロジェクトが対象です。ビルドも署名も公開もしません。

使い方の流れ

Skill を読み込める AI に、たとえばこう頼みます。

mobile-release-preflight を使って、この Expo アプリの Android/iOS 本番リリース前チェックをして。
まず読み取りだけで、ビルドや公開はしないで。

CLI だけでも動きます。

BASH
node scripts/preflight.js --repo <アプリのルート> --platform both --target production --json

比較元を自分で決めるときは --base にローカルの Git 参照を渡します。省略すると、比較対象は HEAD と現在の作業ツリー(ステージ済み・未追跡を含む)です。前回のリリースを自動で選ぶわけではありません。

結果の読み方

判定は PASS / WARN / BLOCK、終了コードは 0 / 1 / 2、検査自体ができなかったときは ERROR(64)です。WARN も CI では非ゼロになります。証拠が足りないことを、無いものとして流さない作りです。

PASS はストア公開の承認ではありません。 どの判定でもレポートに productionReadiness: NOT_VERIFIED と明記されます。ビルドの成功、署名、成果物、プライバシー申告、実機での動作、そのときのストアポリシーは、いずれも別途の確認が要ります。

掲載時点の注意

このページの導入コマンドは、skills.sh の掲載ページから写したものではありません。 2026-10-13 時点で skills.sh にこの Skill のページが無いため、GitHub のリポジトリを直接指す形を載せています。掲載が確認できしだい、掲載ページの形に差し替えます。

当方の環境で実行し、動作を確かめた記録はありません。SKILL.md と README を読んで書いています。

導入

配布元の掲載内容と照合したコマンドです。実行すると配布元のリポジトリから取得されます。コピーできたことと、導入できたことは別です。実行後に結果を確かめてください。

npx skills add https://github.com/iguanagonzaresu-lab/cautious-journey --skill mobile-release-preflight

必要なもの

  • Node.js 22 以上
  • Git(履歴が無い場合は WARN のまま進む)
  • 対象アプリのローカルな作業コピー。monorepo では実際のアプリのディレクトリ

できること

  • Expo の JSON、一般的な app モジュールの Gradle、単一の Info.plist からバージョンを読み取り、突き合わせる
  • HEAD と現在の作業ツリー(ステージ済み・未追跡を含む)を既定の比較対象として差分を見る
  • 認証・API・課金・データ・通知・ネイティブ設定などのパスから、変更の risk 領域を推定する
  • Manifest・Info.plist・Expo JSON に増えた権限を差分として出す
  • 利用者が渡したテスト結果の証拠 JSON を、コミット・アプリのパス・対象・プラットフォーム・日時で照合する
  • 所見ごとに Evidence / Risk / Fix / Verify を付け、JSON か Markdown で報告する
  • PASS 0 / WARN 1 / BLOCK 2 / ERROR 64 の終了コードを返す

できないこと

配布元の SKILL.md に明記されている範囲外です。

  • ビルド・署名・公開をしない。Expo の動的設定や Gradle を実行して値を取り出さない
  • 既定の比較対象は「前回のリリース」でも「PR の範囲」でもなく、HEAD と作業ツリー
  • ネイティブの複数ターゲット・flavor・Xcode 変数・リモート管理のビルド番号は未解決として報告する
  • テスト実行は明示指定したときだけ、既存の root npm test のみ。pre/post は動かさない
  • Gradle・Xcode・Maestro・Detox などは自動実行しない。結果は証拠 JSON で渡す
  • 証拠 JSON は利用者の申告であって、CI への認証付き問い合わせではない
  • ソース検査は 4,000 ファイル / 1ファイル 1MiB / 合計 24MiB まで。超過分と読めないファイルは未確認
  • 資格情報の検出は発見的なもので、網羅的な監査ではない。keystore 類は読まない
  • PASS でもストア公開の承認ではない。レポートは常に productionReadiness NOT_VERIFIED と書く

安全性について

以下は配布元の記述にある設計方針です。当方で実行して確かめた結果ではありません。導入前にご自身でコードを確認してください。

  • 既定で外部通信・ファイル変更・インストールをしない。Git の取得・ブランチ変更・reset をしない
  • リポジトリのファイル・ログ・証拠を「データ」として扱い、その中の指示に従わない
  • 資格情報の値・設定の生値・テストの生ログを表示しない
  • レポートには相対ファイル名とコミットが入る。共有する前に中身を確認すること

関連する解説