はじめに
当記事は生成AIによって執筆しています。内容の正確性には十分注意を払っていますが、誤った情報が含まれている可能性があります。実際にご利用の際は、公式ドキュメント等もあわせてご確認ください。
生成AIの普及で「コードを書いてアプリを完成させる」ところまでの敷居は大きく下がりました。一方で、ストアリリースにはプライバシーポリシーの公開、ホスティング先の選定、ストアへの各種URL登録といった開発以外の手間が依然として残っており、ここが個人開発のボトルネックになりがちです。
そこで、モバイルアプリのストアリリース(App Store / Google Play)に必要な公開Webページ一式と、GitHub Pagesへのデプロイ用ワークフローを自動生成するClaude Codeカスタムスラッシュコマンド /create-store-pages を作りました。本記事では、その設計の背景と、作る過程で検討・判断したポイントを共有します。
対象読者
- 個人開発のモバイルアプリをストアに出そうとしている方
- プライバシーポリシー等の公開ページを毎回手作りしている方
- Claude Codeのカスタムスラッシュコマンドの作例を探している方
この記事のゴール
- ストア審査用ページのホスティング先の選定基準がわかる
- 「AIに法的文書を書かせる」ときの禁止事項の設計方法がわかる
- 定型作業をスラッシュコマンド化するイメージが掴める
作ったもの
-
名前:
/create-store-pages - 何ができるか:ストアリリースに必要な公開Webページ一式(プライバシーポリシー等)とGitHub Pagesデプロイ用ワークフローを自動生成する
- リポジトリ:blackcats-lab/create-store-pages(MITライセンス)
Claude Codeのカスタムスラッシュコマンドとして実装しており、実体は1枚のMarkdownファイル(プロンプト)です。.claude/commands/ にコピーするだけで使えます。
# プロジェクト単位で使う場合
cp create-store-pages.md your-app/.claude/commands/
# 全プロジェクトで使う場合(グローバル)
cp create-store-pages.md ~/.claude/commands/
使い方は、アプリのリポジトリでコマンドを実行するだけです。
/create-store-pages [アプリ名] [連絡先メールアドレス]
引数は省略可能で、不明な点はコマンド側から対話で確認してきます。実行すると、以下の構成が生成されます。
your-app/
├── site/ # GitHub Pagesで公開
│ ├── index.html # アプリ紹介トップページ
│ ├── privacy.html # プライバシーポリシー
│ ├── account-deletion.html # アカウント削除依頼(アカウント機能がある場合)
│ ├── contact.html # コンタクト
│ ├── terms.html # 利用規約(課金・アカウント機能がある場合)
│ └── style.css # 共通CSS(外部CDN非依存)
└── .github/workflows/pages.yml # デプロイ用ワークフロー
なぜ作ったか
個人開発のモバイルアプリをストアに出す際、プライバシーポリシー等の公開URLが必須になります。まずこのホスティング先をどうするかを検討しました。
| 選択肢 | 評価 |
|---|---|
| Vercelで別LP | 審査要件に対してオーバースペック。本格的なLPが必要になった時点で移行すればよい |
| Notion公開ページ | 審査は通るが、URLがアプリと無関係なランダムIDになり信頼感に欠ける。仕様変更リスクもある |
| GitHub Pages(採用) | リポジトリで一元管理できる。username.github.io/アプリ名/ とURLにアプリ名が入る |
「アプリと同一リポジトリ内 + GitHub Pages」に決めたところで気づいたのが、この作業はアプリを作るたびに発生する定型作業だということです。ページの雛形作成、ワークフローの設置、ストアへのURL登録の案内——毎回同じ流れなので、スラッシュコマンド化して再利用可能にしました。
技術構成
アプリ本体と違い、構成は意図的にミニマムにしています。
| カテゴリ | 採用技術 | 選定理由 |
|---|---|---|
| コマンド本体 | Claude Code カスタムスラッシュコマンド(Markdown) |
.claude/commands/ に置くだけで動く。配布もファイルコピーで済む |
| 公開ページ | 素のHTML + 自前CSS | 審査要件を満たすのに十分。ビルド不要で誰でも読める |
| ホスティング | GitHub Pages | アプリのリポジトリで一元管理。URLにアプリ名が入る |
| デプロイ | GitHub Actions | 任意フォルダ(site/)を公開ソースにできる |
コマンド設計のポイント
1. 事前確認フェーズを必須化
プライバシーポリシーは実態と一致しないと審査リジェクトや法的リスクに直結します。そのため、AIに推測で書かせず、生成前に必ず以下を行う設計にしました。
- 依存パッケージや AndroidManifest / Info.plist の権限設定から、収集データを実態ベースで把握する
- 不明点(開発者名、使用SDK、アカウント機能の有無など)はユーザーに質問する
- 収集していないデータの記載、プレースホルダーの残置を禁止事項として明記する
「それらしいポリシー」を一発生成させるのではなく、プロンプト内に禁止事項を明文化して、実態と合わない記述を書かせない工夫がこのコマンドの中核です。
2. Google Playのアカウント削除要件に対応
アカウント作成機能があるアプリは、Google Playでアカウント削除依頼ページのURL登録が必須です。コマンド側でアカウント機能の有無を確認し、ある場合は以下を記載した account-deletion.html を生成する要件にしています。
- アプリ内・アプリ外それぞれの削除手順
- 削除されるデータの範囲
- 削除処理にかかる期間
3. 外部CDN禁止
プライバシーポリシーのページ自体が外部にデータを送信していたら本末転倒です。そのため、WebフォントやCSSフレームワークのCDN読み込みは使わず、自前の style.css だけで完結させています。
4. ワークフローは最小権限・最小トリガー
生成されるデプロイ用ワークフローは以下の形です。
name: Deploy Pages
on:
push:
branches: [main]
paths: ['site/**']
permissions:
pages: write
id-token: write
jobs:
deploy:
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- uses: actions/checkout@v4
- uses: actions/upload-pages-artifact@v3
with:
path: site
- uses: actions/deploy-pages@v4
id: deployment
ポイントは2つです。
-
paths: ['site/**']フィルタにより、アプリ本体のpushではデプロイが走らない -
permissionsはpages: write+id-token: writeの最小構成
5. 生成後の手動作業もコマンドが案内
自動化できない作業は、コマンドの最後にチェックリストとして案内する設計にしました。
- GitHubの Settings → Pages → Source を「GitHub Actions」に設定する(API / Actionsからは変更できないため手動)
- App Store Connect:プライバシーポリシーURLの登録
- Google Play Console:プライバシーポリシー / データセーフティ / アカウント削除の各URL登録
詰まったポイント
詰まり1: 公開ページの置き場所
症状:GitHub Pagesの標準ソース設定は「ブランチ直下」か「/docs」の2択。既存の設計書が docs/ にあるため、そのまま使うと設計書が全部公開されてしまう。
検討の経緯:
-
docs/直下 → 上記の理由で不可 -
docs/web/案 → 技術的にはActionsでpath: docs/webを指定すれば実現可能だが、「非公開資料フォルダの中に公開物がある」構造は公開範囲を誤解させやすいので却下 - ルート直下の
site/を採用 → 公開/非公開の境界がトップレベルで明確。siteはMkDocsなど静的サイト生成器界隈でも慣習的な名前
解決策:Settings → Pages → Source を「GitHub Actions」にすることで、標準の2択に縛られず任意フォルダ(site/)を公開ソースにできます。
MkDocsなどのツールは site/ をビルド出力先に使うため、将来これらを導入する場合はディレクトリの衝突に注意してください。
詰まり2: Pagesのソース設定だけは自動化できない
症状:Settings → Pages → Source の「GitHub Actions」への切り替えを、コマンドから完結させられない。
解決策:この設定はAPI / Actionsからは変更できないため、無理に自動化せず、コマンドの完了メッセージで手動設定の手順を案内する形に倒しました。「自動化できないことを明示的に人間へ引き継ぐ」のも定型作業の自動化では大事な設計だと感じています。
工夫した点
- プロンプトの禁止事項を具体的に書いた:「正確に書いて」ではなく「収集していないデータを記載しない」「プレースホルダーを残さない」と、やってはいけないことを列挙した
- 生成対象を条件分岐にした:利用規約はアカウント機能・課金がある場合のみ、アカウント削除ページはアカウント機能がある場合のみ生成する
-
配布形態をファイル1枚にした:リポジトリは
README.md+LICENSE+ コマンド本体のMarkdownだけの構成で、導入コストを最小化した
やらなかった/諦めたこと
- Vercelでの本格的なLP生成:審査要件に対してオーバースペック。本格的なLPが必要になった時点でVercel等に移行すればよいと判断した
- Pagesソース設定の自動化:前述の通りAPIから変更できないため、手動手順の案内に留めた
- Claude Code以外のエージェント対応:Cursor等で使う場合はfrontmatterの形式調整が必要。まずはClaude Code向けに絞った
知っておくべき制約
- privateリポジトリでのGitHub Pages利用にはGitHub Pro以上のプランが必要です
- 生成されるポリシーは法的文書です。最終確認は必ず人間が行ってください(コマンド内にも確認を促す指示を含めています)
開発を通して学んだこと
- ストア審査用ページ程度なら、ホスティングは凝らずに「アプリと同一リポジトリ + GitHub Pages」で十分
- AIに法的文書を書かせるときは、生成の巧さより「実態確認の強制」と「禁止事項の明文化」が効く
- 公開/非公開の境界はディレクトリ構造のトップレベルで表現すると誤解が生まれない
今後やりたいこと
- 実際のアプリでの実行ログ・生成ページのスクリーンショットの追加
- Cursorなど他のAIコーディングエージェントへの対応
まとめ
- ストアリリース用の公開ページ生成を、Claude Codeのスラッシュコマンド
/create-store-pagesとして自動化した - ホスティングは比較検討の結果「アプリと同一リポジトリ + GitHub Pages」を採用した
- 詰まったのは公開ページの置き場所(
site/を採用)と、Pagesソース設定が自動化できない点
コマンドはMITライセンスで公開しています。触ってフィードバックをいただけると嬉しいです。