laravel-verification
Bucle de verificación para proyectos Laravel: verificaciones de entorno, linting, análisis estático, pruebas con cobertura, escaneos de seguridad y preparación para despliegue.
- License 许可
- MIT
- 最近更新
- 2026-11-04
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- laravel-verification
- origin
- ECC
- description
- Bucle de verificación para proyectos Laravel: verificaciones de entorno, linting, análisis estático, pruebas con cobertura, escaneos de seguridad y preparación para despliegue.
03 SKILL.md 正文
Bucle de Verificación Laravel
Ejecutar antes de PRs, después de cambios importantes y antes del despliegue.
Cuándo Usar
- Antes de abrir un pull request para un proyecto Laravel
- Después de refactorizaciones importantes o actualizaciones de dependencias
- Verificación previa al despliegue para staging o producción
- Ejecutar el pipeline completo de lint -> prueba -> seguridad -> preparación para despliegue
Cómo Funciona
- Ejecutar las fases secuencialmente desde las verificaciones de entorno hasta la preparación para despliegue, de modo que cada capa construya sobre la anterior.
- Las verificaciones de entorno y Composer son requisitos previos para todo lo demás; detener inmediatamente si fallan.
- El linting/análisis estático debe estar limpio antes de ejecutar pruebas completas y cobertura.
- Las revisiones de seguridad y migraciones ocurren después de las pruebas para verificar el comportamiento antes de los pasos de datos o lanzamiento.
- La preparación de build/despliegue y las verificaciones de cola/scheduler son los últimos filtros; cualquier fallo bloquea el lanzamiento.
Fase 1: Verificaciones de Entorno
php -v
composer --version
php artisan --version
- Verificar que
.envesté presente y que las claves requeridas existan - Confirmar
APP_DEBUG=falsepara entornos de producción - Confirmar que
APP_ENVcoincida con el despliegue objetivo (production,staging)
Si se usa Laravel Sail localmente:
./vendor/bin/sail php -v
./vendor/bin/sail artisan --version
Fase 1.5: Composer y Autoload
composer validate
composer dump-autoload -o
Fase 2: Linting y Análisis Estático
vendor/bin/pint --test
vendor/bin/phpstan analyse
Si el proyecto usa Psalm en lugar de PHPStan:
vendor/bin/psalm
Fase 3: Pruebas y Cobertura
php artisan test
Cobertura (CI):
XDEBUG_MODE=coverage php artisan test --coverage
Ejemplo de pipeline CI (formato -> análisis estático -> pruebas):
vendor/bin/pint --test
vendor/bin/phpstan analyse
XDEBUG_MODE=coverage php artisan test --coverage
Fase 4: Seguridad y Verificación de Dependencias
composer audit
Fase 5: Base de Datos y Migraciones
php artisan migrate --pretend
php artisan migrate:status
- Revisar cuidadosamente las migraciones destructivas
- Asegurarse de que los nombres de archivo de migración sigan el formato
Y_m_d_His_*(ej.2025_03_14_154210_create_orders_table.php) y describan el cambio claramente - Asegurarse de que los rollbacks sean posibles
- Verificar los métodos
down()y evitar la pérdida irreversible de datos sin copias de seguridad explícitas
Fase 6: Preparación de Build y Despliegue
php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache
- Asegurarse de que los warmups de caché tengan éxito en la configuración de producción
- Verificar que los workers de cola y el scheduler estén configurados
- Confirmar que
storage/ybootstrap/cache/sean escribibles en el entorno objetivo
Fase 7: Verificaciones de Cola y Scheduler
php artisan schedule:list
php artisan queue:failed
Si se usa Horizon:
php artisan horizon:status
Si queue:monitor está disponible, usarlo para verificar el backlog sin procesar jobs:
php artisan queue:monitor default --max=100
Verificación activa (solo staging): despachar un job no-op a una cola dedicada y ejecutar un solo worker para procesarlo (asegurarse de que esté configurada una conexión de cola que no sea sync).
php artisan tinker --execute="dispatch((new App\\Jobs\\QueueHealthcheck())->onQueue('healthcheck'))"
php artisan queue:work --once --queue=healthcheck
Verificar que el job produjera el efecto secundario esperado (entrada de log, fila en tabla de healthcheck o métrica).
Ejecutar esto solo en entornos que no sean producción donde procesar un job de prueba sea seguro.
Ejemplos
Flujo mínimo:
php -v
composer --version
php artisan --version
composer validate
vendor/bin/pint --test
vendor/bin/phpstan analyse
php artisan test
composer audit
php artisan migrate --pretend
php artisan config:cache
php artisan queue:failed
Pipeline estilo CI:
composer validate
composer dump-autoload -o
vendor/bin/pint --test
vendor/bin/phpstan analyse
XDEBUG_MODE=coverage php artisan test --coverage
composer audit
php artisan migrate --pretend
php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan schedule:list
04 同仓库更多 Skills
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
youtube-downloader
Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.
theme-factory
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.
template-skill
Replace with description of the skill and when Claude should use it.
tailored-resume-generator
Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances
slack-gif-creator
Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like "make me a GIF for Slack of X doing Y".