flutter-appstore-doc-ui-kit（Flutter appstore DOC UI KIT 控制）

Flutter AppStore Doc + UI Kit

Generate an App Store-ready pack in gated stages with mandatory user review between stages:

• docs/app-feature-spec.zh-CN.md + docs/app-feature-spec.en-US.md
• ui/*.png (AI-generated Apple-style page design images)
• icon/app_icon_1024.png + icon/app_icon_1024.svg (square-corner icon)

Workflow (Approval-Gated)

1. Generate APP feature docs in Chinese + English and output them.
2. Ask user to download/review docs; wait for: continue or revise docs.
3. Proceed only after user explicitly approves docs.
4. Confirm image-generation capability:

- If API/model access exists, generate page-level UI images from approved docs. - If no API/model access, output one unified style prompt package for user-side generation.

1. Ask user to download/review UI images.
2. Proceed only after user explicitly approves UI images.
3. Confirm icon-generation capability:

- If API/model access exists, generate icon via model. - If no API/model access, generate icon with programmatic SVG->PNG pipeline.

1. Ask user to review icon.
2. Finish only after user explicitly approves icon.

Do not auto-skip any gate. If user asks for changes, revise only that stage and re-submit for approval.

1) Required Inputs

Collect/confirm:

• App name
• Target language(s)
• Preferred app direction (if none, pick a low-saturation utility direction)
• Optional color style

Hard constraints to enforce:

• Tech stack: Flutter via FVM Flutter 3.35.1
• Includes camera + photo library permissions
• Avoid over-saturated app categories and avoid risky claim patterns
• No backend server required
• No TODO placeholders or temporary/fake data sections
• Document scope must be version 1.0.0 only
• Do not include roadmap/future updates/backlog/post-v1 plans
• Can include general capabilities: i18n, dark mode, accessibility, privacy-first local storage
• App icon must be square-corner (not rounded)

2) Stage 1 — Generate and Deliver Feature Docs (ZH + EN)

Run once:

python3 scripts/generate_appstore_pack.py \
  --app-name "SnapSort" \
  --out ./out/snapsort \
  --locales "en,zh-Hans" \
  --primary-color "#0A84FF"

Then prepare doc outputs first and deliver only docs for review:

• docs/app-feature-spec.zh-CN.md (if missing, derive from base spec and provide Chinese version)
• docs/app-feature-spec.en-US.md (if missing, derive from base spec and provide English version)

If the generator only creates one base spec file, split/translate into two locale files before sending to user.

3) Stage 2 — Generate and Deliver UI Design Images

After user approves both docs, check capability first.

Option A: API/model access available

Use scripts/generate_ui_ai.py.

Required auth:

• OPENAI_API_KEY in environment (or another confirmed image model backend configured by user).

Example:

python3 scripts/generate_ui_ai.py \
  --doc ./out/snapsort/docs/app-feature-spec.en-US.md \
  --out ./out/snapsort/ui \
  --primary-color "#0A84FF"

Outputs:

• ui/page-01-*.png ... ui/page-08-*.png

Option B: no API/model access

Output a single unified prompt package (global style + 8 page prompts + naming rules) for the user to generate images manually in external tools. Then collect user-generated images and continue to UI review gate.

Do not deliver icon in this stage.

4) Stage 3 — Generate and Deliver App Icon

After user approves UI images, check capability first.

Option A: API/model access available

Generate icon with image model and export PNG.

Option B: no API/model access

Generate icon with deterministic programmatic pipeline (SVG source + PNG output).

Deliver icon artifacts:

• icon/app_icon_1024.png
• icon/app_icon_1024.svg

5) Quality Validation

Before each approval gate, validate that stage artifacts are complete:

Doc stage:

• Both zh-CN and en-US docs exist and are semantically aligned.
• Feature doc explicitly states FVM Flutter 3.35.1.
• Feature doc version is explicitly marked 1.0.0.
• Camera + photo permissions appear in feature/privacy sections.
• No backend dependency appears in architecture/data flow.
• No TODO/TBD/temp/placeholder language.
• No roadmap / future update sections are present.

UI stage:

• UI images are PNG outputs (AI-generated or user-generated from provided prompt package).
• UI images cover all listed key pages in approved spec.
• Labels and flows match approved doc wording.

Icon stage:

• Icon is visually square (no rounded corner mask baked into source).
• Icon style matches approved product direction.

6) App Store Safety Guidance

Use references/review-safety-checklist.md and keep copy conservative:

• No medical/financial/legal guarantee claims
• No “instant earnings” or manipulative wording
• Permission usage tied to clear user-triggered actions
• Privacy text explicitly local-first and user-controllable

Notes

• This skill creates design/spec artifacts, not Flutter code.
• If user also needs implementation scaffolding, create a separate Flutter build skill.