Files
affaan-m--everything-claude…/docs/es/commands/build-fix.md
T
wehub-resource-sync d48cda4081
CI / Test (ubuntu-latest, Node 18.x, bun) (push) Failing after 15m1s
CI / Test (ubuntu-latest, Node 18.x, npm) (push) Failing after 15m1s
CI / Test (ubuntu-latest, Node 18.x, pnpm) (push) Failing after 15m1s
CI / Test (ubuntu-latest, Node 18.x, yarn) (push) Failing after 15m1s
CI / Test (ubuntu-latest, Node 20.x, bun) (push) Failing after 17m13s
CI / Test (ubuntu-latest, Node 20.x, npm) (push) Failing after 18m42s
CI / Test (ubuntu-latest, Node 20.x, pnpm) (push) Failing after 15m0s
CI / Test (ubuntu-latest, Node 20.x, yarn) (push) Failing after 49m44s
CI / Test (ubuntu-latest, Node 22.x, bun) (push) Failing after 51m55s
CI / Test (ubuntu-latest, Node 22.x, pnpm) (push) Failing after 21m57s
CI / Test (ubuntu-latest, Node 22.x, npm) (push) Failing after 37m39s
CI / Test (ubuntu-latest, Node 22.x, yarn) (push) Failing after 34m7s
CI / Validate Components (push) Failing after 37m15s
CI / Python Tests (push) Failing after 10m1s
CI / Security Scan (push) Failing after 10m1s
CI / Lint (push) Failing after 17m12s
CI / Coverage (push) Failing after 20m19s
CI / Test (macos-latest, Node 18.x, bun) (push) Has been cancelled
CI / Test (macos-latest, Node 18.x, npm) (push) Has been cancelled
CI / Test (macos-latest, Node 18.x, pnpm) (push) Has been cancelled
CI / Test (macos-latest, Node 18.x, yarn) (push) Has been cancelled
CI / Test (windows-latest, Node 18.x, npm) (push) Has been cancelled
CI / Test (windows-latest, Node 18.x, pnpm) (push) Has been cancelled
CI / Test (windows-latest, Node 18.x, yarn) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, bun) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, npm) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, pnpm) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, yarn) (push) Has been cancelled
CI / Test (windows-latest, Node 20.x, npm) (push) Has been cancelled
CI / Test (windows-latest, Node 20.x, pnpm) (push) Has been cancelled
CI / Test (windows-latest, Node 20.x, yarn) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, bun) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, npm) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, pnpm) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, yarn) (push) Has been cancelled
CI / Test (windows-latest, Node 22.x, npm) (push) Has been cancelled
CI / Test (windows-latest, Node 22.x, pnpm) (push) Has been cancelled
CI / Test (windows-latest, Node 22.x, yarn) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 11:55:55 +08:00

67 lines
2.9 KiB
Markdown

---
description: Detectar el sistema de build del proyecto y corregir incrementalmente errores de build/tipos con cambios mínimos y seguros.
---
# Build y Corrección
Corregir incrementalmente errores de build y de tipos con cambios mínimos y seguros.
## Paso 1: Detectar el Sistema de Build
Identificar la herramienta de build del proyecto y ejecutar el build:
| Indicador | Comando de Build |
|-----------|-----------------|
| `package.json` con script `build` | `npm run build` o `pnpm build` |
| `tsconfig.json` (solo TypeScript) | `npx tsc --noEmit` |
| `Cargo.toml` | `cargo build 2>&1` |
| `pom.xml` | `mvn compile` |
| `build.gradle` | `./gradlew compileJava` |
| `go.mod` | `go build ./...` |
| `pyproject.toml` | `python -m compileall -q .` o `mypy .` |
## Paso 2: Parsear y Agrupar Errores
1. Ejecutar el comando de build y capturar stderr
2. Agrupar errores por ruta de archivo
3. Ordenar por orden de dependencia (corregir imports/tipos antes que errores de lógica)
4. Contar errores totales para seguimiento del progreso
## Paso 3: Bucle de Corrección (Un Error a la Vez)
Para cada error:
1. **Leer el archivo** — Usar la herramienta Read para ver el contexto del error (10 líneas alrededor del error)
2. **Diagnosticar** — Identificar la causa raíz (import faltante, tipo incorrecto, error de sintaxis)
3. **Corregir mínimamente** — Usar la herramienta Edit para el cambio más pequeño que resuelva el error
4. **Re-ejecutar el build** — Verificar que el error desapareció y que no se introdujeron nuevos errores
5. **Continuar** — Seguir con los errores restantes
## Paso 4: Salvaguardas
Parar y preguntar al usuario si:
- Una corrección introduce **más errores de los que resuelve**
- El **mismo error persiste después de 3 intentos** (probablemente un problema más profundo)
- La corrección requiere **cambios arquitectónicos** (no es solo una corrección de build)
- Los errores de build provienen de **dependencias faltantes** (se necesita `npm install`, `cargo add`, etc.)
## Paso 5: Resumen
Mostrar resultados:
- Errores corregidos (con rutas de archivos)
- Errores restantes (si los hay)
- Nuevos errores introducidos (debe ser cero)
- Próximos pasos sugeridos para problemas no resueltos
## Estrategias de Recuperación
| Situación | Acción |
|-----------|--------|
| Módulo/import faltante | Verificar si el paquete está instalado; sugerir comando de instalación |
| Incompatibilidad de tipos | Leer ambas definiciones de tipo; corregir el tipo más restrictivo |
| Dependencia circular | Identificar el ciclo con el grafo de imports; sugerir extracción |
| Conflicto de versiones | Verificar `package.json` / `Cargo.toml` para restricciones de versión |
| Mala configuración de herramienta de build | Leer el archivo de configuración; comparar con valores por defecto funcionales |
Corregir un error a la vez por seguridad. Preferir diffs mínimos sobre refactorización.