Plantilla de Vault AIOps (LinLin00000000/aiops-vault-template)

Habilidad Complementaria del Vault AIOps

Esta habilidad es una capa de procedimiento. No contiene los activos actuales del usuario. Los hechos actuales residen en el vault AIOps local, normalmente en $AIOPS_ROOT o ~/ai-ops.

Contrato de fuente de verdad

Utiliza esta división:

• README.md: reglas locales estables, roles de archivos, límites de seguridad y convenciones específicas del proyecto.
• resources.md: estado actual en el que se debe confiar ahora.
• maintenance-log.jsonl: historial solo de añadidura de decisiones, mantenimiento, comprobaciones, incidentes y correcciones.
• secrets-location.md: solo nombres de secretos, ubicaciones de almacenamiento, notas de acceso/rotación; nunca valores de secretos.
• services/<servicio>/service-card.md: runbooks y detalles por servicio cuando el archivo de recursos central se vuelve demasiado grande.
• scripts/aiops.py: interfaz de comandos de bajo consumo de tokens sobre el vault.

No inferir la infraestructura actual a partir de esta habilidad. Leer el vault e inspeccionar el estado en vivo cuando sea seguro.

Orden de lectura predeterminado

1. Resolver la ruta del vault: $AIOPS_ROOT si está definida, en caso contrario ~/ai-ops.
2. Leer primero el README.md local del vault si la tarea puede modificar archivos, servicios, exposición, credenciales o copias de seguridad.
3. Ejecutar la capa de comandos antes de las lecturas completas:
   • python3 "$AIOPS_ROOT/scripts/aiops.py" index
   • python3 "$AIOPS_ROOT/scripts/aiops.py" resources --section "<sección>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" service "<nombre>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" host "<nombre>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" log --tail 20 --summary
4. Leer resources.md completo, las tarjetas de servicio o las líneas de registro solo cuando la salida fragmentada sea insuficiente.
5. Usar el historial de la sesión solo cuando el estado en vivo y los documentos del vault no puedan responder la pregunta.

Límites de seguridad

• No leer, imprimir, copiar ni almacenar valores de secretos. secrets-location.md son metadatos, no un volcado de secretos.
• No escribir secretos en resources.md, registros, tarjetas de servicio, avisos, comentarios de incidencias, confirmaciones ni resúmenes de chat.
• Confirmar antes de operaciones irreversibles o de alta exposición: eliminar, sobrescribir, rotar, restaurar, abrir puertos públicos, cambiar DNS, migrar datos, deshabilitar copias de seguridad, o tocar recursos de terceros o propiedad de amigos.
• Mantener los grupos de recursos explícitos. No operar en infraestructura de terceros o propiedad de amigos a menos que el usuario autorice específicamente ese objetivo.
• Preferir la mínima exposición: localhost detrás de proxy inverso o red privada para rutas de administración; HTTPS público solo cuando sea intencionado y autenticado.

Flujo de trabajo de mantenimiento

1. Clasificar el objetivo: host, servicio, dominio/DNS, proxy inverso, datos/copia de seguridad, ubicación de secretos, automatización o el propio vault.
2. Identificar el grupo de recursos y el límite de autoridad.
3. Cargar el contexto actual mínimo a través de aiops.py y las tarjetas de servicio.
4. Inspeccionar el estado en vivo con comandos seguros cuando sea necesario.
5. Planificar la acción reversible más pequeña y señalar los pasos de alto riesgo.
6. Ejecutar con el mínimo privilegio.
7. Verificar con la salida real desde el lado del consumidor: verificación de estado, registro, solicitud HTTP, systemctl, docker ps, listado de copias de seguridad o equivalente.
8. Actualizar la capa correcta:
   • hechos actuales -> resources.md o tarjeta de servicio;
   • historial importante -> un objeto maintenance-log.jsonl añadido;
   • ubicaciones de secretos -> secrets-location.md sin valores;
   • detalles locales del servicio -> README/tarjeta de servicio.
9. Si el cambio mejora el flujo de trabajo/herramientas AIOps reutilizables en lugar de solo hechos locales privados, sincronizar la parte genérica con el repositorio de plantilla en ~/projects/aiops-vault-template, ejecutar sus pruebas/verificaciones, luego confirmar y enviar para que los consumidores downstream de AIOS Kit reciban la mejora. Nunca copiar recursos privados, registros o secretos en la plantilla pública.
10. Ejecutar python3 "$AIOPS_ROOT/scripts/aiops.py" check después de los cambios en el vault.
11. Informar sobre archivos modificados, comandos, verificación, elementos omitidos/bloqueados y seguimientos.

Reglas de escritura

• El estado actual pertenece a resources.md o a una tarjeta de servicio, no solo al registro histórico.
• El historial pertenece a maintenance-log.jsonl, un objeto JSON válido por línea.
• Las correcciones deben ser nuevas entradas correction o supersede; no reescribir el historial a menos que el usuario solicite una migración.
• Evitar duplicar el mismo hecho en README, resources, tarjetas de servicio y registros. Elegir la capa propietaria.
• La evidencia sin procesar grande debe residir bajo evidence/ o fuera del vault con una referencia de ruta.

Lista de verificación de validación

Antes de finalizar:

• python3 "$AIOPS_ROOT/scripts/aiops.py" check se ejecuta correctamente o las fallas se explican.
• Los archivos JSONL se analizan correctamente.
• No se agregaron valores de secretos evidentes.
• Los cambios en el estado actual no están solo en el registro de mantenimiento.
• Las afirmaciones en la respuesta están respaldadas por archivos del vault o la salida de comandos en vivo.
• Cualquier acción de alto riesgo fue confirmada o se dejó explícitamente como un paso propuesto.

Si el vault falta

Si no existe un vault AIOps y el usuario quiere uno, instalar el repositorio de plantilla o crear la estructura mínima:

ai-ops/
  README.md
  resources.md
  maintenance-log.jsonl
  maintenance-log.schema.md
  secrets-location.md        # privado, ignorado por Git
  secrets-location.example.md
  scripts/aiops.py

Luego ejecutar python3 scripts/aiops.py check.