Lint de Runbook para Agentes
Usa este skill cuando un agente esté a punto de seguir, publicar o delegar un runbook y necesite una verificación de preparación local primero.
Entradas Requeridas
- Ruta a un runbook en Markdown.
- Ruta opcional para el reporte.
Salidas
- Informe de linting en Markdown.
- Código de salida
0cuando se superan los controles requeridos, de lo contrario1.
Límites de Efectos Secundarios
El skill lee runbooks y puede escribir un archivo de reporte. No debe ejecutar comandos del runbook, hacer push a ramas, llamar conectores ni mutar sistemas externos.
Requisitos de Aprobación
Cualquier acción de seguimiento que escriba en GitHub, Slack, CRM, herramientas de gestión de proyectos u otras cuentas externas requiere aprobación explícita en el flujo de trabajo propietario.
Esto incluye operaciones de lanzamiento redactadas como tag the release o create a release tag. Una sección de aprobación que indique que la aprobación no es necesaria no constituye una puerta de aprobación.
Ejemplos
agent-runbook-lint check docs/ORCHESTRATION.md
agent-runbook-lint check RUNBOOK.md --report reports/runbook-lint.md
Flujo de Validación
Ejecuta npm test, npm run check y npm run smoke antes de usar el reporte en un PR de candidato a lanzamiento. Los scripts npm resuelven el intérprete .venv local del repositorio creado por el Quickstart del README (con fallback a un python3 ambiente), así que primero sigue el Quickstart desde un checkout nuevo.