trombonet12/Rally-Copilot / .claude/skills/android-add-permission
android-add-permission
Verifiedandroid-add-permission
Añade un permiso con el mínimo privilegio: declaración, petición en el momento de uso, rationale y todos los estados.
Cuándo usarla
- Una función necesita un permiso de runtime o especial:
ACCESS_FINE_LOCATION/ACCESS_COARSE_LOCATION,POST_NOTIFICATIONS(API 33+),FOREGROUND_SERVICE+FOREGROUND_SERVICE_LOCATION(API 34+),INTERNET(descarga de mapas e incidencias),RECORD_AUDIO(edición de notas por voz, H8).
Cuándo NO usarla
- Crear el servicio, receiver o canal que lo usa →
android-create-system-component(los permisos se añaden con esta skill). - Solo auditar permisos existentes →
android-review(permissions) osecurity-review. ACCESS_BACKGROUND_LOCATION: la navegación usa foreground service iniciado desde la UI y no lo necesita; no añadir sin decisión registrada endocs/DECISIONES.md.
Precondiciones
- Función concreta que lo justifica y pantalla desde la que se pedirá. Sin uso real, no se añade.
- Comprobar que no hay alternativa sin permiso y que no está ya declarado:
grep -n "uses-permission" app/src/main/AndroidManifest.xml.
Pasos
- Declarar solo ese permiso en
AndroidManifest.xml; usarandroid:maxSdkVersionsi solo aplica hasta cierta versión. Nada "por si acaso". - Modelar el estado en una clase sellada:
Granted,Denied,ShouldShowRationale,PermanentlyDenied(y para ubicación,SoloAproximada). - Pedir con
ActivityResultContracts.RequestPermission/RequestMultiplePermissions(rememberLauncherForActivityResult) en el momento de uso («Conducir», «Reconocimiento»), nunca al arrancar. - Rationale: si
shouldShowRequestPermissionRationalees true, explicación propia (para qué sirve la ubicación precisa en las notas) y botón para pedir de nuevo. - Denegación permanente: botón a ajustes (
Settings.ACTION_APPLICATION_DETAILS_SETTINGS); al volver, reevaluar conContextCompat.checkSelfPermissionenON_RESUME. - Degradación: sin permiso la app sigue usable (mapas, mis tramos, análisis); con ubicación aproximada se avisa de que las notas no son fiables; sin notificaciones, el servicio funciona pero se avisa.
- Lógica de estado en el ViewModel o helper testeable; el chequeo de plataforma tras una interfaz inyectada (
android-create-hilt-module). - Tests JVM: mapeo de estados con fake del chequeo; Compose/Robolectric del rationale y del estado permanente (
shadowOf(application).grantPermissions(...)).
Validaciones / tests
./gradlew testDebugUnitTest ktlintCheck detekt lintDebug.grep -rn "uses-permission" app/src --include=AndroidManifest.xml: solo permisos justificados.
Definition of Done
- Permiso declarado una vez, con
maxSdkVersionsi procede. - Petición en contexto, con rationale y denegación permanente cubiertos.
- La app funciona degradada sin el permiso.
- Tests de estados en verde; lint sin avisos nuevos.
-
./gradlew ktlintCheck detekt lintDebug testDebugUnitTest assembleDebugen verde.
Docs a actualizar
docs/DECISIONES.mdsi cambia la estrategia de permisos ·docs/privacidad.mdsi existe · docs/ESTADO.md (skillsession-handoff)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |