Community图像github.com

store-pack

为应用构建Google Play和App Store提审包(图标、带框截图、功能图、限字数的上架文本、控制台表单答案、问题清单),输出到项目的store/文件夹。当用户要求将应用“准备上架Play Store/App Store”或准备商店素材、上架信息、控制台表单答案时使用。

store-pack 是什么?

store-pack 是一个AI代理技能,旨在帮助开发者将应用准备好提交到Google Play和App Store。它会自动生成商店所需的所有素材,包括图标、带框截图(精确的商店尺寸)、功能图、限字数的上架文本、控制台表单答案以及一个包含阻碍项的README文件。该技能支持Flutter、Web、桌面或混合应用,通过检查应用代码获取包名、版本、权限、SDK等事实信息,然后从真实应用中捕获截图(使用虚构数据),最后生成符合商店规范的素材包。它不会自动提审、提交或部署,而是将最终结果交给用户自行处理。此技能适用于Claude Code、Cursor和Codex等AI编码代理,要求系统已安装Python 3、Flutter SDK和macOS。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nowfalsalahudeen/store-pack/tree/HEAD

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

store-pack 是做什么的?

在项目根目录生成 store/ 文件夹,内含:图标、带框截图、功能图、上架文本、控制台表单答案以及一个阻碍项README。不进行提审、提交或部署,这些操作留给用户自行处理。

环境要求:Python 3、Flutter SDK(图片合成器是一个Flutter测试,无需完整应用)、macOS(sips 用于图像检查和图标尺寸)。原始截图来自应用本身。

工作流程

  1. 检查应用事实(绝不虚构):包名/束 ID、版本、权限(AndroidManifest、Info.plist)、pubspec、Cargo.toml 或 package.json 中的 SDK(广告、分析、崩溃报告、计费、登录)、账户和支付方式、隐私政策和支持URL、签名配置、设备系列。阅读项目自己的贡献者文档了解其规则。
  2. 原始截图。使用真实应用捕获,数据为虚构的逼真数据。绝不使用生产数据或生产账号。
    • Flutter:一个widget测试框架,使用真实字体(debugDisableShadows = false,否则阴影会渲染为硬轮廓);手机尺寸 440x956 3x 对应 1320x2868。
    • Web、桌面或混合应用:在临时数据库上运行应用自带的服务器,通过API填充数据,然后使用浏览器自动化工具驱动。使用独立的浏览器上下文,deviceScaleFactor 设置为 3(手机,视口 440x956)或 2(平板,1032x1376),并在每次截图前用 *::-webkit-scrollbar{display:none!important}*{scrollbar-width:none!important} 隐藏滚动条。
    • 仅通过端口杀死监听在自己临时端口上的进程(lsof -ti tcp:PORT -sTCP:LISTEN),绝不通过名称杀死进程。
    • 目视检查每张截图。丢弃在该宽度下损坏的截图并告知用户。
  3. store/app.json(参见 docs/config-reference.md),然后运行 python3 scripts/make_pack.py store/app.json。该脚本在品牌渐变背景上为截图加框并添加说明文字,生成功能图和图标,然后运行 scripts/check_pack.py。
    • 图标:通常只有带圆角或文字的艺术图;icon 任务将标记裁剪到纯色全覆盖背景上。告知用户仍需一个矢量或干净的 1024 px 源文件。
  4. 上架文本: store/listings.json,然后运行 python3 scripts/write_listings.py store/listings.json(fastlane 布局,强制检查字数限制)。仅描述构建的实际功能和平台构建包含的内容。
  5. 文档: store/README.md(先放阻碍项表格),google-play/console-forms.md,app-store/connect-forms.md。

商店规范(请在控制台中确认;Apple 的页面可能无法加载)

  • Play:图标 512 px(<= 1 MB);功能图 1024x500,无透明通道;2-8 张手机截图,每边 320-3840 px,长边 <= 短边的 2 倍(使用 1080x1920);可选 7" /10" 平板截图(1200x1920,1600x2560);标题 30 字符,简短描述 80 字符,完整描述 4000 字符。
  • App Store:iPhone 6.9" 1320x2868(必填),6.5" 1284x2778;iPad 13" 2064x2752(如果支持 iPad);每种最多 10 张;无透明通道;图标 1024 px,无透明通道;名称 30 字符,副标题 30 字符,宣传文本 170 字符,关键词 100 字符。
  • 两个商店都拒绝包含透明通道的截图;合成器输出 RGB PNG。

每个应用都要检查的阻碍项(经验总结)

  • 支付: 在应用内通过 Web 支付提供商销售数字解锁或许可证违反 Play 计费 / Apple IAP 规则。对于 iOS,发布时不包含购买界面,或添加 StoreKit。移动构建中不得包含价格或购买链接。
  • 账户删除: 任何创建账户的应用都需要在应用内提供删除路径,并且(Play)需要一个公开的 Web URL 描述此功能。
  • Apple 登录: 如果在 iOS 上提供 Google 或其他第三方登录,则必须提供 Apple 登录。
  • 测试广告 ID 遗留发布版本;缺少真实 ID。
  • Play 应用签名: 将 Play 的应用签名 SHA-1 添加到 Google OAuth Android 客户端,否则在 Play 安装版本上登录会失败。
  • 受限或声明的权限: REQUEST_IGNORE_BATTERY_OPTIMIZATIONS、前台服务类型(需要声明和视频)、位置权限(即使使用 maxSdkVersion)、蓝牙 neverForLocation。
  • 审核者访问: 需要服务器或许可证的应用需要提供演示服务器、PIN 和操作步骤(Play 应用访问权限,Apple 指南 2.1)。
  • 隐私政策 URL 必须存在;欧盟/英国贸易商状态需要联系地址和电话。
  • 发布签名 已配置;版本号递增;Play 使用 AAB;Apple 团队和束 ID;ITSAppUsesNonExemptEncryption;隐私清单。
  • 新的个人 Play 账户: 在生产发布前需要一个 12 名测试者、14 天的封闭测试。
  • 数据安全: 只有那些在内存中使用且从未存储的数据才可声明为“临时处理”(例如发送给 AI 服务的照片);存储在服务器上的电子邮件或 ID 不属于临时处理。广告 ID:仅当没有广告或转化 SDK 且已移除广告 ID 权限时才回答“否”。
  • 目标受众 18+,除非应用确实是面向儿童的。
  • 最小化缩减器(R8)可能在可选库上失败: 如果发布构建因“缺少类”而失败,请为指定的包添加 -dontwarn 规则。

文件

  • scripts/make_pack.py 运行所有流程;scripts/compose/ 是 Flutter 合成器(STORE_JOBS=jobs.json flutter test);scripts/build_icons.py;scripts/check_pack.py;scripts/write_listings.py。
  • templates/app.example.json、templates/listings.example.json - 配置模板,可供复制。examples/ - 一个完整的示例,包含虚构应用及其输出。
  • docs/ - 入门指南、配置参考、工作原理。

相关技能