跳到正文
cccskills
免费在 GitHub 公开

mobile-debug

Diagnoses build and runtime failures across Flutter, native Android, native iOS, React Native and Kotlin Multiplatform. Covers pub/Dart, Gradle/AGP, Xcode/CocoaPods, Metro, KMP source sets and iOS frameworks, crashes and deep links. Use for failing builds, app launches, stack traces or /reis-mobile:debug.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(17)

  • SKILL.md3.8 KB
  • references/android.md2.8 KB
  • references/android/anr.md4.5 KB
  • references/android/gradle-build.md6.5 KB
  • references/android/memory-leaks.md3.4 KB
  • references/deep-links.md5.4 KB
  • references/flutter.md1.6 KB
  • references/flutter/build.md5.2 KB
  • references/flutter/errors.md3.1 KB
  • references/flutter/layout-issues.md5.0 KB
  • references/flutter/package-conflicts.md5.0 KB
  • references/flutter/runtime-errors.md6.0 KB
  • references/ios.md2.2 KB
  • references/ios/cocoapods.md4.9 KB
  • references/ios/xcode-build.md5.8 KB
  • references/kotlin-multiplatform.md1.4 KB
  • references/react-native.md4.0 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Mobile Debug

One debugging process for every mobile stack. This file holds how to find a cause; each platform's error signatures and fixes live in its reference.

1. Pick the reference

Choose by the stack and by the layer the error comes from — a Flutter or React Native build often fails inside Gradle or Xcode:

The failure is inRead
A Flutter app: pub, Dart compilation, generated code, widgets, runtime exceptionsreferences/flutter.md
Gradle, the Android build, logcat crashes or ANRs (native Android, or the android/ folder of any app)references/android.md
Xcode, signing, CocoaPods, Swift packages or iOS crash logs (native iOS, or the ios/ folder of any app)references/ios.md
A React Native or Expo app: Metro, native modules, JavaScript errorsreferences/react-native.md
Kotlin Multiplatform compilation, source-set or framework integrationreferences/kotlin-multiplatform.md
A deep link, App Link or Universal Link that opens the browser, the wrong screen or crashes (any stack)references/deep-links.md

When reis-mobile debug (or /reis-mobile:debug) ran, its area line points at the layer: gradle, manifest, proguard → Android; xcode, signing, cocoapods, spm → iOS; pub → Flutter; metro → React Native.

2. Find the first real error

Build and crash logs bury the cause under cascading failures. Quote the line that starts the failure — the first error:, the What went wrong block, the top of the exception with its Caused by — not the final BUILD FAILED or the last frame. Ask for the full output when the user pasted only the end.

3. Collect versions before theorizing

Most build failures after an upgrade are toolchain mismatches. Read the versions that decide the behavior — the SDK and toolchain versions (the doctor report shows them), wrapper and lock files, build scripts, deployment targets — and quote them in the diagnosis. Check compatibility against the official tables named in the reference; do not state compatibility ranges from memory.

4. Reproduce safely

Read-only commands can run: version checks, dependency trees, flutter doctor -v, ./gradlew --version, pod --version, xcodebuild -version. A build that only compiles can run when the user already ran it or agrees, since it takes time and writes build outputs.

5. Confirm the cause

Tie the cause to evidence: file:line, a version, a build setting or a log line. If two causes are plausible, say what evidence would separate them instead of picking one.

6. Propose, then wait

Answer with:

  • Cause — one or two sentences, with the evidence.
  • Fix — the minimal change, as a diff or exact commands, in order.
  • Side effects — what else the fix changes: a higher minimum Android or iOS version, a Gradle or Kotlin upgrade that CI needs too, pods changing version.
  • Verify — the command that failed, run again.

Do not edit files, upgrade dependencies or run commands that change the project, the caches or the machine — flutter clean, pod install, pod repo update, npx expo prebuild --clean, deleting DerivedData, ~/.gradle caches or node_modules — until the user asks you to apply the fix. Then apply it, run the verification and report the result.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Audits and fixes mobile accessibility across Flutter, native Android, native iOS, React Native and Kotlin Multiplatform, including shared Compose UI and native hosts. Covers TalkBack/VoiceOver labels, roles, state, reading order, touch targets, text scaling, contrast and focus. Use for a11y audits, screen-reader bugs or accessible UI implementation.

中文简介正在准备中。当前显示原文说明。

wrsilva/reis-mobile72026年10月14日 更新

Builds native Android apps with the Android team's guides — Jetpack Compose UI, adaptive layouts, edge-to-edge, Compose styles, migrating XML views to Compose, Navigation 3 and predictive back; Android Gradle Plugin 9 upgrades, R8 keep rule analysis, profiling with Android Studio and Perfetto, and the Android CLI; Google Play policy compliance, Play Billing upgrades and the Engage SDK; Credential Manager restore and verified email; CameraX and Media3 Cast; App Functions and the ML Kit GenAI Prompt API; Wear OS, Android TV and display glasses. Use when writing, upgrading or auditing native Android (Kotlin) code for any of these topics, even if the user does not name the library.

中文简介正在准备中。当前显示原文说明。

wrsilva/reis-mobile72026年10月14日 更新

Designs and reviews mobile architecture across Flutter, native Android, native iOS, React Native and Kotlin Multiplatform. Covers state ownership, data flow, modules, dependency boundaries, navigation, offline data and KMP shared source sets versus host apps. Use when structuring a feature, choosing state management, refactoring layers or deciding where a real class or screen belongs.

中文简介正在准备中。当前显示原文说明。

wrsilva/reis-mobile72026年10月14日 更新

Implements and reviews mobile identity and session flows across Flutter, Android, iOS, React Native and Kotlin Multiplatform. Use for sign-in, passkeys, account recovery, provider linking, reauthentication, logout and concurrent refresh. Security audits belong to mobile-security; account deletion belongs to mobile-privacy.

中文简介正在准备中。当前显示原文说明。

wrsilva/reis-mobile72026年10月14日 更新

Reviews mobile code for production bugs across Flutter, native Android, native iOS, React Native and Kotlin Multiplatform, including KMP source-set and host API contracts. Covers lifecycle, concurrency, UI state and native boundaries with file:line evidence. Use for a code review, PR, project audit, quality check or /reis-mobile:review.

中文简介正在准备中。当前显示原文说明。

wrsilva/reis-mobile72026年10月14日 更新

Detects the mobile stack of the current project (Flutter, Android, iOS, React Native, Kotlin Multiplatform), its languages and target platforms, using the reis-mobile detector. Use when you need to know which mobile stack a project uses before reviewing, debugging or changing it, or when the user asks "what stack is this project?".

中文简介正在准备中。当前显示原文说明。

wrsilva/reis-mobile72026年10月14日 更新

查看 wrsilva 的全部技能

报告此技能的问题