safety-guard

Descripción general de la skill safety-guard

Qué hace safety-guard

La skill safety-guard añade una capa de protección para acciones del agente que sean destructivas o de alto riesgo. Resulta especialmente útil cuando quieres detener comandos peligrosos, limitar las escrituras a un directorio o ejecutar un agente autónomo con menos probabilidades de dañar producción, destinos de despliegue o datos activos.

Casos de uso más adecuados

Instala safety-guard si gestionas sistemas en vivo, ejecutas agentes de código en modo totalmente automático o trabajas con frecuencia en migraciones, cambios de infraestructura o tareas de release. La safety-guard skill encaja cuando el trabajo real no es solo “tener cuidado”, sino “hacer que las acciones inseguras sean más difíciles de ejecutar”.

Por qué importa

Su valor principal es el control del flujo de trabajo: la skill bloquea comandos de riesgo como force push, hard reset, eliminaciones destructivas y limpiezas amplias del sistema, y además permite congelar ediciones en una sola ruta. Eso hace que safety-guard for Access Control sea especialmente útil cuando un modelo tiene acceso amplio al repo pero solo debe modificar una superficie muy concreta.

Cómo usar la skill safety-guard

Instalar y localizar el origen

Usa el comando safety-guard install que aparece en el repo:
npx skills add affaan-m/everything-claude-code --skill safety-guard

Empieza por skills/safety-guard/SKILL.md. Si quieres una lectura rápida, revisa primero las definiciones de modo y luego repasa las notas de implementación enlazadas en ese mismo archivo.

Convertir un objetivo vago en un prompt utilizable

El patrón de safety-guard usage funciona mejor cuando especificas a la vez la tarea, el nivel de riesgo y el límite de escritura. Los buenos inputs nombran el área objetivo y la barrera que quieres:

• “Actualiza la API de facturación, pero escribe solo dentro de src/api/ y bloquea comandos destructivos.”
• “Ejecuta en modo protegido mientras reviso los cambios antes de cualquier publicación o despliegue.”
• “Protege el trabajo de migración en producción y pide confirmación antes de cualquier comando que pueda borrar o restablecer estado.”

Leer las partes que cambian el comportamiento

Para una guía práctica de safety-guard, céntrate en las descripciones de modo y en el flujo de desbloqueo. Los detalles útiles del repo son los tres modos de protección, los comandos que supervisa y la sintaxis exacta de congelación. Esas son las piezas que determinan si la skill realmente se puede hacer cumplir en tu entorno.

Flujo de trabajo que da mejores resultados

Usa el modo careful cuando lo que principalmente quieras sea confirmación para comandos peligrosos. Usa el modo freeze cuando necesites restringir las escrituras a un área concreta. Usa el modo de protección combinado cuando se den ambos riesgos. Si la tarea es acotada, nombra explícitamente el directorio permitido; si es operativa, nombra los comandos o acciones concretos que deben disparar confirmación.

Preguntas frecuentes sobre la skill safety-guard

¿safety-guard es solo para trabajo en producción?

No. Es más fuerte en producción, pero también ayuda en staging, repos compartidos y ejecuciones autónomas locales en las que un borrado, reset o publicación accidental seguiría teniendo un coste alto.

¿En qué se diferencia de un prompt normal?

Un prompt normal depende de que el modelo recuerde la cautela. La safety-guard skill convierte esa cautela en un patrón de control repetible: vigila comandos de riesgo, bloquea escrituras fuera del árbol permitido y deja explícito el límite.

¿safety-guard es apta para principiantes?

Sí, si el objetivo es sencillo: proteger un repo mientras un agente lo edita. Lo principal que deben entender los principiantes es la diferencia entre la protección basada en confirmación y la restricción de escritura basada en directorio.

¿Cuándo no debería usarla?

No uses safety-guard como sustituto de la revisión de código, las copias de seguridad o los permisos del entorno. Es una barrera de protección, no un plan de recuperación. Si tu tarea necesita una refactorización amplia sin restricciones, el modo freeze puede resultar demasiado limitante.

Cómo mejorar la skill safety-guard

Dale un límite más preciso a la skill

La mejora más útil es una declaración de alcance más clara. En lugar de “sé seguro”, indica qué debe protegerse, qué puede editarse y qué solo debe leerse. Los inputs más sólidos generan menos bloqueos falsos y menos idas y venidas.

Nombra las operaciones de riesgo que esperas

Si tu flujo incluye despliegues, publicaciones, cambios en bases de datos o comandos de limpieza, dilo desde el principio. La safety-guard skill es más fácil de ajustar cuando sabe si debe priorizar confirmación, congelación de escrituras o ambas cosas.

Vigila los fallos más comunes

El principal fallo es un alcance de congelación demasiado amplio que bloquea ediciones legítimas. El segundo es una tarea demasiado vaga que deja al agente sin saber si un comando está permitido. Si el primer resultado es demasiado restrictivo, acota la ruta protegida; si es demasiado permisivo, añade restricciones explícitas de comandos y rutas.

Itera después de la primera ejecución

Tras la primera pasada, ajusta en función de lo que el agente intentó hacer, no solo de lo que cambió. Si intentó comandos arriesgados, amplía los patrones bloqueados en tus instrucciones de uso. Si se salió del área prevista, estrecha el directorio permitido.