shellcheck-configuration

Descripción general

¿Qué es shellcheck-configuration?

shellcheck-configuration es una skill diseñada para ayudar a desarrolladores y equipos DevOps a configurar y usar ShellCheck, una herramienta de análisis estático para scripts shell. Proporciona orientación práctica para establecer infraestructura de linting, corregir problemas de código y asegurar la portabilidad de scripts entre entornos. Esta skill es ideal para quienes buscan aplicar buenas prácticas, detectar errores comunes en scripting shell e integrar controles de calidad en pipelines de CI/CD.

¿Quién debería usar esta skill?

• Desarrolladores que escriben scripts Bash, sh, dash o ksh
• Ingenieros DevOps que mantienen scripts de automatización
• Equipos que aplican estándares de calidad en scripting shell
• Cualquier persona que integre linting de scripts shell en flujos CI/CD

Problemas que resuelve

• Detecta errores y trampas comunes en scripting shell
• Aplica estándares de codificación consistentes
• Facilita la migración de scripts para cumplir con controles de calidad
• Soporta configuración específica por proyecto y supresión de falsos positivos

Cómo usar

Pasos de instalación

1. Instala la skill con:
   npx skills add https://github.com/wshobson/agents --skill shellcheck-configuration
2. Revisa el archivo SKILL.md para guía detallada sobre configuración y uso.
3. Explora archivos complementarios como README.md, AGENTS.md y metadata.json para contexto adicional.

Configuración de ShellCheck

• Instala ShellCheck usando el gestor de paquetes de tu plataforma:
  • macOS: brew install shellcheck
  • Ubuntu/Debian: apt-get install shellcheck
  • Desde el código fuente: Clona el repositorio oficial y compila con make build && make install
• Verifica la instalación con shellcheck --version

Configuración de ShellCheck

• Crea un archivo .shellcheckrc en tu proyecto para personalizar reglas y shells objetivo.
• Integra ShellCheck en tu pipeline de CI/CD para linting automatizado.
• Usa las opciones de ShellCheck para adaptar el análisis a las necesidades de tu proyecto.

Adaptando el flujo de trabajo

• Comienza con los archivos proporcionados por la skill y ajusta la configuración para tu repositorio y herramientas.
• Evita copiar configuraciones textualmente; personaliza según las necesidades de tu equipo y restricciones operativas.

Preguntas frecuentes

¿Dónde puedo encontrar ejemplos de configuración?

Consulta los archivos SKILL.md y .shellcheckrc para ejemplos de configuración y prácticas recomendadas.

¿Se puede usar shellcheck-configuration en CI/CD?

Sí, la skill está diseñada para integrarse fácilmente en pipelines CI/CD, permitiendo linting y controles de calidad automatizados de scripts shell.

¿Qué shells son compatibles?

ShellCheck soporta Bash, sh, dash, ksh y otros shells compatibles con POSIX.

¿Cómo se suprimen falsos positivos?

Puedes configurar conjuntos de reglas y suprimir advertencias específicas en tu archivo .shellcheckrc o directamente en los scripts.

¿Por dónde empiezo?

Revisa el archivo SKILL.md para una visión general completa, luego explora otros archivos complementarios para mayor contexto. Usa la pestaña Archivos para inspeccionar el árbol completo, incluyendo referencias y scripts auxiliares.