Community画像github.com

hmos-appgallery-poster

HarmonyOS アプリ向けに、AppGallery に掲載する宣伝画像(アプリ詳細ページのスクリーンショット、掲載用バナー、ストア画像など)を生成します。ユーザーが「宣伝画像」「掲載用バナー」「ストアスクリーンショット」「AppGallery プロモーション素材」「アプリ紹介画像」などをリクエストした際に使用します。

hmos-appgallery-poster とは?

このスキルは、HarmonyOS アプリ開発プロジェクトから自動的にアプリ情報を読み取り、AppGallery Connect にアップロード可能な一連のプロモーション画像(アプリ詳細ページのトップカルーセル画像)を生成するエージェントスキルです。具体的な流れは以下の通りです。まず、アプリのソースコードからバンドル名、アイコン、機能一覧、テーマカラーを抽出し、プロモーション計画を立案します。次に、最新の AppGallery 画像仕様をウェブ検索で確認し、サイズや禁止事項を検証します。その後、エミュレーターでアプリを起動し、各機能画面をスクリーンショットします。さらに、Pollinations などの無料 AI 画像生成サービスを用いて、アプリのテーマに合わせた背景画像を複数パターン生成します。最後に、Python (Pillow) または Canva コネクタを使って、スクリーンショットと背景画像を統合し、HarmonyOS 端末の輪郭を模したレイアウトにテキストを配置して、最終的なプロモーション画像を作成します。このスキルは、開発者がデザインツールを使わずに、プロフェッショナルなストア画像を素早く作成するための強力なワークフローを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Huangzihengcmd/hmos-appgallery-poster/tree/HEAD

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

鴻蒙アプリ宣伝画像作成

現在の HarmonyOS プロジェクト用に、AppGallery Connect に直接アップロードできる一連の宣伝画像(アプリ詳細ページ上部のカルーセル画像/プロモーション画像)を生成します。

基本原則

  1. 背景イラストはコードで描かない。人間のデザイナーのように振る舞います:プロンプトを書く → 無料生成モデルを呼ぶ → 画像を確認 → 不満なら seed 変更/プロンプト修正を繰り返す(ステップ 3 参照)。コードは合成(コラージュ、角丸、テキスト配置、リサイズ出力)のみに使用します。
  2. 仕様は先にネットで確認してから着手する。このファイルに埋め込まれた基準仕様は古くなっている可能性があるため、タスクごとに最初にステップ 1 を実行します。
  3. デフォルト出力は「標準プロモーション画像セット」:スマートフォン縦型 5 枚(最大 8 枚)+タブレット横型 2〜3 枚+PC 16:9 2 枚。ユーザーから別途要望がある場合はそれに従います。
  4. すべての成果物は <プロジェクトルート>/promotion/ に出力し、プロジェクトのソースコードディレクトリを汚染しない。
  5. 素材ダウンロードや画像生成などの一時ファイルはプロジェクトディレクトリ内に置き、システムの Temp ディレクトリには書き込まない。

ワークフロー

ステップ 0:アプリ分析

以下のファイルを読み込んで情報を抽出します(ユーザーに質問せず、コードを自分で読みます):

  • AppScope/app.json5:bundleName、icon、label
  • entry/src/main/module.json5:abilities、パーミッション、デバイス種別(tablet/pc 対応かどうか)
  • AppScope/resources/base/element/string.json と resources/zh/:アプリ名
  • entry/src/main/resources/base/profile/main_pages.json + pages/ 以下の各ページ:機能一覧
  • resources/base/media/ 以下のアイコン:色抽出でブランドのメインカラーを決定(目視で画像を見て判定可)

promotion/plan.md を出力し、以下を含めます:アプリ名、一言キャッチコピー、3〜5 のコアセールスポイント(各宣伝画像が 1 つのセールスポイントに対応)、ターゲットユーザー、ブランドメインカラーの hex、スタイルの選定。

ステップ 1:ネットで仕様確認(必須)

websearch / webfetch を使って最新要件を検索・確認します。検索キーワード例:

  • AppGallery 宣传图 尺寸 规格 应用信息
  • 华为应用市场 应用介绍图片 截图 要求
  • developer.huawei.com 主题设计指导及规范(HarmonyOS 設計規範)
  • AppGallery Connect 图片规格 上架

華為公式ドキュメント(developer.huawei.com / AppGallery Connect ヘルプセンター)を優先します。公式ページが JS レンダリングで取得できない場合は、上記キーワードで複数の信頼できる情報源をクロスチェックします。

基準仕様表(2026年11月確認版、それでもネットで再確認必須):

素材サイズ/比率形式と制限
スマホ宣伝画像(縦)1080×1920 / 1080×2340 / 1080×2400(9:16 〜 9:19.5)JPG/PNG、1枚 ≤2MB、3〜8 枚
タブレット宣伝画像(横)2560×1440(16:9)または 3:2同上
PC 宣伝画像1920×1080(16:9)同上
AppGallery アイコン216×216(AGC開発者コンソール)/ 512×512PNG、角丸はコンソール側で処理
HarmonyOS デスクトップアイコン前景/背景1024×1024PNG、透明、角丸・枠線・影は禁止

審査レッドライン:iOS / iPhone / Apple Store / 競合アプリストアの表示や端末外観を画像に含めない;実際の機能と異なる虚偽の宣伝をしない;国旗や政治的に敏感な要素を表示しない;スクリーンショットに個人情報を露出しない。

確認結果を promotion/plan.md に記録します。

ステップ 2:エミュレーターのスクリーンショット(プロダクト紹介画像素材)

  1. devecocli devices でデバイスを確認;デバイスがなければエミュレーターを起動します。
  2. プロジェクトがビルドされていない場合:devecocli build;その後 devecocli run --skip-build でインストール・起動します。
  3. ページごとにスクリーンショット(デフォルトでは hdc でスクリーンショットを取得し、verify_ui は使用しない。UI 検証ツールはユーザーが明示的に UI 検証を要求した場合のみ使用):
hdc shell "snapshot_display -f /data/local/tmp/shot_1.jpeg"
hdc file recv /data/local/tmp/shot_1.jpeg .\promotion\shots\shot_1.jpeg
  1. セールスポイントに沿ってスクリーンショットを計画:各コア機能ページにつき少なくとも 1 枚;該当ページに遷移してから次のスクリーンショットを取得します。
  2. スクリーンショットの幅が 1080 でない場合、plan.md に実際の解像度を記録し、合成時にアスペクト比を維持してリサイズします。

ステップ 3:AI 画像生成——人間の絵画プロセスを模倣(複数スタイルの背景)

方法 A(デフォルト、無料で Key 不要):Pollinations 直接接続

URL 形式(プロンプトは URL エンコード、英語で記述):

https://image.pollinations.ai/prompt/{encoded_prompt}?width=1024&height=2048&seed={n}

2026年11月の実測注意点:

  • nologo=true は付けない。このパラメータは有料化されました(402 Payment Required が返る);model=flux も付けず、デフォルトモデルを使用します。
  • 無料枠はレート制限があり、初回リクエストで 503(Retry after 10s)がよく発生します。12 秒待ってリトライ、最大 5 回で成功することが多い。
$prompt = [uri]::EscapeDataString("soft gradient fluid abstract background, deep blue and cyan, smooth flowing shapes, no text, no watermark")
foreach ($i in 1..5) {
  Start-Sleep -Seconds 12
  try {
    Invoke-WebRequest -Uri "https://image.pollinations.ai/prompt/$prompt`?width=1024&height=2048&seed=42" -OutFile .\promotion\bg\style1_s42.png -TimeoutSec 120
    break
  } catch { }
}

人間のように反復:スタイルごとに 2〜3 個の seed を生成し、1 枚ずつ確認(画質を目視判定)、不満ならプロンプトを修正するか seed を変えてやり直します。一度に何十枚も生成しないでください。

方法 B(フォールバック、ユーザーが「人間のように Web ページを操作して」と要求した場合):ブラウザ自動化

deveco.json でブラウザ系 MCP(例:@playwright/mcp)が設定されている場合、無料画像生成サイト(pollinations.ai など)を開き、人間のように操作します:プロンプト入力 → 画像生成待ち → promotion/bg/ にダウンロード。該当 MCP がない場合は方法 A を直接使用します。

方法 C:環境に設定済みの画像生成 MCP/コネクター(例:Canva コネクター内蔵の AI 画像生成)がある場合、方法 A より優先します。

スタイルライブラリ(アプリの種類に応じて plan.md で 3〜5 種類選択、各種類につき 1〜2 枚の宣伝画像):

スタイル適用アプリプロンプトキーワード
グラデーションフルイドツール/テック/AIsoft gradient fluid abstract, smooth flowing shapes
ミニマル幾何学効率化/ビジネスminimalist flat design, geometric shapes, clean, pastel
3D カートゥーンレンダー子供/教育/カジュアルcute 3d cartoon render, soft lighting, playful
自然風景写真ライフスタイル/健康/旅行natural landscape photography, golden hour, bokeh
チャイナトレンドコンテンツ/カルチャーchinese traditional illustration, modern guochao style
ダークネオンゲーム/eスポーツdark neon glow, cyberpunk, dramatic lighting
ソフトディフューズライトソーシャル/感情soft diffuse light, dreamy pastel, warm

プロンプトの鉄則:必ず no text, no watermark を含める——画像内のテキストはステップ 4 のレイアウトで配置します。画像生成モデルのテキストは必ず乱れます。配色はブランドのメインカラーを中心に記述します。

ステップ 4:プロダクト紹介画像の合成(HarmonyOS 端末の輪郭 + テキスト)

Python + Pillow で合成(ない場合は pip install pillow)。縦型画像の構成:

┌─────────────────────┐  1080×2400
│  アプリ名(大見出し)   │  ← タイトルエリア:アプリ名 + 一言キャッチコピー、メインカラー/白文字
│  一言キャッチコピー    │
│ ┌─────────────┐     │
│ │ 端末輪郭     │     │  ← 端末本体:メインカラーグラデーション角丸長方形(r≈140px)、
│ │ ┌─────────┐ │     │     縁取りハイライト、内側にステップ 2 のスクリーンショット(同様に角丸切り抜き)
│ │ │ スクリーン│ │     │
│ │ │ ショット  │ │     │
│ │ └─────────┘ │     │
│ └─────────────┘     │
│  icon + アプリ名     │  ← 下部ブランドエリア
└─────────────────────┘

必要最小限のスケルトンコード(必要に応じてパラメータを変更し、そのままコピーして無理に使わない):

from PIL import Image, ImageDraw, ImageFilter, ImageFont

W, H = 1080, 2400
bg = Image.open("bg/style1_s42.png").convert("RGB")
bg = bg.resize((W, H))  # 背景を敷き詰める。必要に応じて先に crop してからリサイズし比率を維持

img = bg.copy()
draw = ImageDraw.Draw(img)

# 端末の輪郭
frame_w, frame_h = 760, 1560
fx, fy = (W - frame_w) // 2, 560
body = Image.new("RGB", (frame_w, frame_h), (20, 20, 25))
mask = Image.new("L", (frame_w, frame_h), 0)
ImageDraw.Draw(mask).rounded_rectangle([0, 0, frame_w, frame_h], radius=110, fill=255)
img.paste(body, (fx, fy), mask)

shot = Image.open("shots/shot_1.jpeg").convert("RGB")
shot = shot.resize((frame_w - 24, int((frame_w - 24) * shot.height / shot.width)))
if shot.height > frame_h - 24:
    shot = shot.crop((0, 0, shot.width, frame_h - 24))
smask = Image.new("L", shot.size, 0)
ImageDraw.Draw(smask).rounded_rectangle([0, 0, shot.width, shot.height], radius=98, fill=255)
img.paste(shot, (fx + 12, fy + 12), smask)
draw.rounded_rectangle([fx, fy, fx + frame_w, fy + frame_h], radius=110, outline=(255, 255, 255), width=4)

# テキスト(日本語フォント:Windows では msyh.ttc、HarmonyOS Sans がインストール済みなら優先)
font_big = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", 88)
font_sub = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", 46)
draw.text((W // 2, 300), "アプリ名", font=font_big, fill=(255, 255, 255), anchor="mm")
draw.text((W // 2, 410), "一言キャッチコピー", font=font_sub, fill=(230, 230, 230), anchor="mm")

img.save("final/phone/poster_1.png", optimize=True)

要件:

  • タブレット/PC 版は横構図にする:スクリーンショットを左または右に配置し、テキストエリアを反対側に、解像度はステップ 1 で確認した結果に従う。
  • 出力後、1 枚ずつ確認:1枚 ≤2MB(超えたら JPG quality=88 に変換するかダウンサンプリング)、テキストがメイン被写体を圧迫していない、角丸が自然。
  • テキストは plan.md のセールスポイントから抽出し、短文にする(1行 ≤12 文字)、虚偽の機能説明を禁止。

ステップ 5:オプションの強化——Web デザインツール(Canva コネクターなど)

Canva には多数の内蔵グラフィックアセットがあります:既存テンプレート(アプリプロモーション/携帯電話ポスター系)、シェイプ、イラストステッカー、アイコン、フォント、タイポグラフィ。AI が Canva コネクターを介してこれらの内蔵グラフィックを直接流用して仕上げることができ、ゼロから描く必要はありません。

  1. プロジェクトの deveco.json / グローバル設定の mcp セクションに Canva、Figma、MasterGo、Pixso などのデザインコネクターがあるか確認します。
  2. Canva がある場合:内蔵テンプレートを検索(キーワード "app promotion" / "携帯電話ポスター")→ ステップ 3 の AI 背景とステップ 2 のスクリーンショットをテンプレートのプレースホルダーに差し替え → 内蔵グラフィックでレイアウトとテキストを微調整 → promotion/final/ にエクスポート。Canva の既存デザインアセットを活用するため、高速でプロフェッショナルです。
  3. ない場合:このステップはスキップ。メインフロー(無料画像生成+合成)で十分です。納品時に、Canva コネクターを設定すればテンプレート精修機能が得られることをユーザーに伝えます。

位置づけ:このステップは、仕上げを強化するオプションです。宣伝画像の主な成果物は常にステップ 3(Pollinations での無料画像生成)+ステップ 4(コード合成)です。Canva はコネクターが存在し、ユーザーがより洗練されたテンプレートベースのレイアウトを必要とする場合にのみ使用します。

ステップ 6:自己チェックと納品

promotion/final/ の各画像について以下を確認:

  • 解像度 = ステップ 1 で確認した仕様(サイズ、アスペクト比)
  • 形式 JPG/PNG、1枚 ≤2MB
  • スマホ版 3〜8 枚、各画像が 1 つのセールスポイントに対応
  • iOS/Apple/競合の表記なし、透かしなし、文字化けなし
  • テキストに誤字脱字なし、アプリの実際の機能と一致

ディレクトリ構成:

promotion/
  plan.md          # セールスポイント、仕様確認記録、スタイル選定
  shots/           # エミュレーターの生スクリーンショット
  bg/              # AI 生成背景(複数スタイル、複数 seed)
  final/phone/     # スマホ版完成品
  final/tablet/    # タブレット版完成品(該当する場合)
  final/pc/        # PC 版完成品(該当する場合)
  manifest.md      # 納品リスト:ファイル名、サイズ、容量、対応セールスポイント

納品時にユーザーに報告:完成品のパス、各画像のサイズと対応するセールスポイント、および AppGallery Connect に掲載する際のアップロード場所(アプリ情報 → 紹介画像/宣伝画像)。

関連スキル