菜单
Drive the running game apps in the iOS Simulator with idb (tap / describe / screenshot) to find UX + layout bugs that snapshot tests cannot — navigation, modals, back-stack, completion, safe-area/Dynamic-Island clipping, offline/signed-out flows. Use when asked to "test the UI", "find UX problems", or verify an interactive flow.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Use when planning, scoping, or executing user-owned App Store Connect / TestFlight / Apple Developer operations for the repo apps (Sudoku / Minesweeper) — IAP product registration, App Privacy questionnaire, AdMob console linkage, sandbox tester provisioning, TestFlight upload + review, ASC submission, App Metadata uploads. Codifies which steps are user-owned (require Apple ID / 2FA / web UI) vs Leader-orderable (via ASC API + ASCRegister CLI), and the canonical doc + verification checklist for each.
Index + entry point for EVERY repo ops / build / release task. Before running or hand-rolling any infra command (TestFlight upload, CloudKit schema, screenshots, acknowledgements, l10n gate, secret scan, lint, provisioning) — or before grepping the repo to "find how X is done" — consult this: the pipeline is almost always already a `mise run <task>`. Lists each task with its invocation, safety gate, and the deeper owning skill. Invoke when asked to build / archive / upload / deploy / scan / lint / generate / provision anything, or when wiring a new ops script.
The shared composition template that lets multiple games (Sudoku / Minesweeper) share ONE live stack — `GameConfig<Route>` + `makeGameApp(config:)` in GameAppKit, `<Game><Concern>` target naming, and shared non-gameplay UI (Home / DailyHub skeleton / board-redirect / GC dashboard). Only the Game module is per-game; everything else is reusable module + DI config. Invoke when adding a new game, migrating a game's composition root, deciding what is shared vs per-game, writing a `GameConfig`, or when asked "how do I bootstrap game N / why is there a makeGameApp".
Local archive → export → TestFlight upload via `mise run tf:upload`, the temporary stand-in for the Xcode Cloud "Main CI" workflow while the XCC monthly compute quota is exhausted. Covers the per-app/per-platform pipeline (tuist generate → xcodebuild archive → CFBundleVersion bump → App-Store-Connect export → gated altool upload), ASC API auth from secrets/.env, and the user-owned --i-am-sure upload gate. Invoke when a build needs to reach TestFlight without Xcode Cloud, when running or debugging `tf:upload`, when deciding archive-only vs upload, or when asked "how do I get a build to TestFlight locally / why is the export plist failing / what build number do I use".
Regenerate each app's Settings.bundle Acknowledgements (open-source license) page from the SwiftPM dependency graph via `mise run gen:acknowledgements` (wraps LicensePlist, configured by `App/<App>/license_plist.yml`). Invoke when adding / removing / upgrading a third-party SwiftPM dependency (especially the AdMob / UMP graph under AppMonetizationKit), when license disclosure must be refreshed before a release, when editing a `license_plist.yml`, or when asked "how is the Acknowledgements / licenses page generated".
Sync App Store screenshot PREVIEWS from committed snapshot-test baselines via `mise run store:screenshots` (list / sync / clean). Symlinks selected baseline PNGs into docs/app-store/screenshots/<app>/<device>/<locale>/NN-screen.png so re-recording snapshots auto-refreshes previews. PREVIEW-ONLY — baselines carry an alpha channel and wrong dimensions, so they are NOT ASC submission-spec; a separate marketing-frame/upscale pass is still required before any real upload. Invoke when wiring or refreshing store-preview screenshots, running/debugging `store:screenshots`, eyeballing the storefront storyline, or when asked "can I upload these snapshot PNGs to App Store Connect" (answer: not directly).
| name | interactive-sim-ux-audit |
| description | Drive the running game apps in the iOS Simulator with idb (tap / describe / screenshot) to find UX + layout bugs that snapshot tests cannot — navigation, modals, back-stack, completion, safe-area/Dynamic-Island clipping, offline/signed-out flows. Use when asked to "test the UI", "find UX problems", or verify an interactive flow. |
Snapshot tests render views in a fixed-size NSHostingView — they do not model
navigation, taps, the device safe area, or the Dynamic Island. A whole class of bugs
only shows when you actually drive the app: blank-board-after-tap (#491), unplayable
when iCloud signed out (#512), completion icon clipped by the Dynamic Island (#518).
This skill is how to run that audit.
The no-Homebrew/CocoaPods policy does not forbid idb. Install via direct GitHub release download (user-authorized path). Verified on macOS 26 / Xcode 26 / arm64:
idb_companion: download idb-companion.universal.tar.gz (latest = v1.1.8; 2022 but
works) from https://github.com/facebook/idb/releases → extract to
~/idb-tools/companion/idb-companion.universal/ (binary in bin/, Frameworks/
sibling). The objc duplicate-class warning for FBProcess is non-fatal.idb CLI: pip3 install --user fb-idb → ~/Library/Python/3.9/bin/idb.~/.local/bin (already on the MCP-inherited PATH): symlink idb;
for the companion use a wrapper script that execs the real binary's absolute
path (a bare symlink breaks @executable_path/../Frameworks rpath).idb list-targets, then idb ui describe-all --udid <booted-sim> returns the
a11y tree (frames + AXLabel) in device-point space (iPhone 17 Pro = 402×874 pt).See [[idb-sim-ui-driving-works]] (memory) for the exact commands.
1.0.0 build; Settings → Version exposes it. Confirm it's the
version you mean to test before reporting any bug.xcodebuild -workspace Game.xcworkspace -scheme <Sudoku|Minesweeper> -sdk iphonesimulator -configuration Debug -destination 'platform=iOS Simulator,name=iPhone 17 Pro' -derivedDataPath build/sim build, then xcrun simctl install <udid> <App.app>.Tuist/AdMob.xcconfig + secrets/.env, so the Debug build's AppComposition.live()
hits an assertion at launch (EXC_BREAKPOINT) → app drops to springboard. That crash is
an env artifact, not a code bug. (Tuist needs tuist install && tuist generate --no-open
first; the workspace is gitignored.)idb ui describe-all --udid <udid> # get element frames + AXLabel (pipe to python/jq)
idb ui tap --udid <udid> <x> <y> # tap at device-point coords (center of a frame)
xcrun simctl io <udid> screenshot <path.png> # capture; then Read the PNG and eyeball
describe-all, not from screenshot pixels (screenshot is 3× the
point space). Tap the center of an element's frame.describe-all again to confirm where you landed (a tap can miss / hit
springboard / over-navigate on double-back).$var. idb ui tap --udid $S $xy with xy="201 488"
fails (invalid int value: '201 488'). Use ${=xy} (zsh split) or literal ints. Bare
literals work; variables need ${=...}.idb ui describe-all / ui_tap need idb on PATH — without it the ios-simulator-MCP
errors spawn idb ENOENT. simctl can screenshot but cannot tap.xcrun simctl ui <udid> content_size accessibility-extra-extra-extra-large
then relaunch to test Dynamic Type; reset with content_size large. appearance dark|light
for color scheme. System alerts (e.g. StoreKit "Sign in to Apple Account") persist across
app relaunch — dismiss them before reading the app.-uitest-near-win) to land one move from a win. A loss is
reachable by tapping cells until a mine.latestInProgress() returns nil by graceful-degrade design (#515) so no ResumePill ever
shows — #4(pill)/#12/#19/#20/#38 + GC completion are un-testable until the user signs a
sandbox Apple ID into Simulator → Settings → Apple Account (iCloud and Game Center are
SEPARATE sign-ins — GC alone does not enable CloudKit). GKGameCenterViewController is a
system overlay idb can't introspect; absence of the #513 sign-in alert is the signal GC is
recognized.File each finding with the screenshot evidence + repro; note when it's environmental (no iCloud / stale build) vs a genuine current bug, and re-validate on a fresh main build before calling it real.