skills.rest
TE-QuanBZhang
TE-QuanBZhangCOMMUNITY
Explore all skills by this author →
GitHub

openspec-android-bug

Investigate Android bugs and generate OpenSpec change proposals with triage, CodeGraph analysis, and regression tests.

1|Updated Jun 27, 2026
Search Tags:#debugging#android#openspec#bug triage#crash analysis#codegraph#regression test
One-click install
npx skills add https://github.com/TE-QuanBZhang/skills-pool --skill openspec-android-bug-te-quanbzhang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-android-bug
Source: https://github.com/TE-QuanBZhang/skills-pool/tree/main/ai-coding/skills/openspec-android-bug
Command: npx skills add https://github.com/TE-QuanBZhang/skills-pool --skill openspec-android-bug-te-quanbzhang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging Android issues like crashes, ANRs, memory leaks, and lifecycle bugs often lacks structure, leading to guesswork fixes without root-cause analysis or regression coverage. This Skill turns a raw bug report into a complete OpenSpec change with proposal, design, and tasks grounded in systematic triage and codebase analysis. ## Core Features & Use Cases - Structured Bug Triage: Classifies reports into eight categories (crash, ANR, lifecycle, memory, network, UI, gallery/media, camera) and routes to specialized debugging skills for deep analysis. - Diagnostic Collection & Deobfuscation: Guides logcat, bugreport, tombstone, and ANR trace collection, and retraces obfuscated release-build stack traces with mapping.txt before analysis. - OpenSpec Artifact Generation: Creates proposal, design, and tasks artifacts via the OpenSpec CLI, with a mandatory failing-regression-test-first task ordering. - Use Case: A user reports "app crashes when rotating during a network request." The Skill triages it as Crash + Lifecycle, loads the relevant debugging skills, runs CodeGraph exploration, and produces an OpenSpec change with root-cause analysis, a failing regression test task, and verification steps. ## Quick Start Ask the AI to investigate your Android bug report or stack trace using the openspec-android-bug skill and produce an OpenSpec change proposal.

Frequently Asked Questions about openspec-android-bug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I investigate an Android crash with a stack trace?▼

Provide the stack trace or bug description and the Skill performs triage to classify the crash, collects logcat or bugreport diagnostics, and loads the android-crash-analyzer skill for deep analysis. It then creates an OpenSpec change with root cause, fix direction, and a regression test.

How to analyze obfuscated Android stack traces from release builds?▼

Locate the mapping.txt for the crashing build under app/build/outputs/mapping/<variant>/ and run retrace mapping.txt obfuscated_stacktrace.txt to restore real symbols. The Skill requires deobfuscation before analysis since obfuscated frames lead to meaningless conclusions.

What tools are required to run this Android debugging workflow?▼

The OpenSpec CLI is required for creating change artifacts. CodeGraph is optional for codebase exploration, and adb is used only when a device or emulator is connected for logcat, bugreport, and tombstone collection.

Does CodeGraph index Android XML layouts and Gradle files?▼

No. CodeGraph indexes Kotlin and Java source symbols but does not reliably cover XML layouts, AndroidManifest.xml, Gradle build scripts, resources, or ProGuard rules. The Skill supplements with rg, find, and gradlew commands for those files.

Why does the Skill require a failing regression test before the fix?▼

A fix without verification is unprovable. The tasks artifact must start with a test that reproduces the bug and currently fails, followed by the root-cause fix, then verification that the test passes and reproduction steps no longer trigger the bug.

What Android bug categories does the triage step cover?▼

Triage covers eight categories: crash, ANR/freeze, lifecycle/state, memory leak/OOM, network/data flow, UI/rendering, gallery/media, and camera. Each primary category routes to a dedicated specialized debugging skill that governs the deep investigation.

Related Skills

Explore More Software Engineering Skills→
msrivmsriv

mobile-debug-doctor

Diagnose Android and iOS crashes from logcat, ANR traces, and Xcode reports.

Community
Advanced
AD-PaladinsAD-Paladins

sdd-archive

Archives completed SDD changes by merging delta specs into main specs.

Community
Advanced
gracefullightgracefullight
46

oma-debug

Reproduces failures, identifies root cause, applies minimal fixes with regression tests.

Community
Advanced
GitnappGitnapp

node-inspect-debugger

Debug Node.js applications using inspector breakpoints and Chrome DevTools Protocol.

Community
Advanced