trombonet12/Rally-Copilot / .claude/skills/android-debug-failure
android-debug-failure
Verifiedandroid-debug-failure
Diagnostica $ARGUMENTS (build o crash; por defecto build). Produce causa aparente, hipótesis y reproducción mínima; no corrige.
Cuándo usarla
build: falla./gradlew(compilación, ktlint, detekt, lint o tests).crash: la app se cierra, ANR o excepción en el emulador/dispositivo.
Cuándo NO usarla
- Bug ya reproducido con test rojo y causa conocida →
bugfix-flow. - Solo leer logs de la app funcionando →
android-install-and-logcat. - Lentitud o consumo sin fallo →
android-profile.
Precondiciones
- Fallo reciente y reproducible (o su log). Si
$ARGUMENTSfalta:buildsi hay log de Gradle,crashsi hay stack de logcat; si no, preguntar. crash:adbcon un dispositivo (verandroid-install-and-logcat).- Logs a un archivo temporal fuera del repo; nunca versionarlos.
Pasos
- Capturar el log:
build:./gradlew <tarea> --stacktrace > <log-temporal> 2>&1(la tarea que falló).crash:adb logcat -d -b crash -v threadtime > <log-temporal>; con ANR, añadiradb logcat -d -v threadtime *:E.
- Primera pasada con un subagente haiku de solo lectura sobre ese archivo: error, archivo, línea, stack (≤ 5 líneas) y errores en cascada. No pedirle arreglos.
- Abrir el
archivo:líneacitado y verificar que existe y coincide. - 1-3 hipótesis por probabilidad, cada una con evidencia (línea de log o código) y cómo refutarla. Si el log no basta:
no determinable. Si es comportamiento de AGP/Gradle/Compose no verificable, consultar la documentación oficial. - Reproducción mínima: el comando más corto (una tarea con
--tests "<Clase>"o los pasos en la app). Ejecutarla una vez. - Decisión:
- Reproducido y causa clara →
bugfix-flowcon el resumen (test rojo primero). - No reproducible → documentar lo intentado y pedir datos; no tocar código.
- Reproducido y causa clara →
- Redactar antes de compartir: sin tokens, emails ni coordenadas reales del usuario.
Validaciones / tests
- Reproducción:
./gradlew <tarea>(build) o pasos +adb logcat -d -b crash(crash) muestra el mismo error. - Cada
archivo:líneadel informe existe en el repo.
Definition of Done
- Causa aparente con
archivo:líneaverificada contra el código. - Hipótesis con evidencia y forma de refutarlas.
- Reproducción mínima ejecutada (o
no reproduciblejustificado). - Derivado a
bugfix-flowsi el bug está confirmado; ningún código modificado aquí. - Logs compartidos sin datos sensibles.
Docs a actualizar
- Hallazgo abierto en docs/ESTADO.md (skill
session-handoff)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |