AgentSkillsCN

navigation-audit

审计 React Navigation 的导航结构。可用于检查路由配置、发现深层链接问题,或重新规划导航流程。

SKILL.md
--- frontmatter
name: navigation-audit
description: Audita la estructura de navegación de React Navigation. Usar para revisar rutas, detectar problemas de deep linking, o reorganizar la navegación.

Navigation Audit

Auditoría de la estructura de navegación.

Proceso de Auditoría

1. Mapear Estructura Actual

Buscar archivos de navegación:

bash
# Archivos de router/navigation
find src -name "*Router*" -o -name "*Navigator*" -o -name "*Stack*"

2. Documentar Árbol de Rutas

Crear mapa visual:

code
AppNavigator
├── AuthStack
│   ├── Login
│   ├── Register
│   └── ForgotPassword
└── MainTabs
    ├── HomeStack
    │   ├── Home
    │   └── Details
    ├── ProfileStack
    │   ├── Profile
    │   └── Settings
    └── ...

3. Checklist de Auditoría

markdown
## Navigation Audit Checklist

### Estructura
- [ ] Navegadores anidados tienen sentido lógico
- [ ] No hay rutas duplicadas
- [ ] Nombres de rutas son consistentes (PascalCase)

### Deep Linking
- [ ] Rutas principales tienen path definido
- [ ] Params requeridos están documentados
- [ ] URLs son user-friendly

### Performance
- [ ] Lazy loading en stacks grandes
- [ ] No se pasan objetos grandes en params
- [ ] Reset de stack al cambiar de flujo

### UX
- [ ] Back button funciona correctamente
- [ ] Gestures habilitados donde corresponde
- [ ] Headers consistentes

4. Problemas Comunes

ProblemaSíntomaSolución
Rutas huérfanasScreen no accesibleAñadir navegación
Params perdidosundefined en destinoVerificar navigate()
Stack infinitoMemory leakUsar replace/reset
Deep link rotoURL no abre screenVerificar linking config

Output Esperado

markdown
## Navigation Audit Report

### Estructura
- Total navigators: X
- Total screens: Y
- Profundidad máxima: Z

### Issues Encontrados
1. [CRÍTICO] Ruta X no tiene deep link
2. [WARN] Stack Y tiene 10+ screens

### Recomendaciones
- Dividir HomeStack en sub-stacks
- Añadir linking config para rutas públicas