Communitygithub.com

Company Agent Guardrails

Define y aplica reglas de seguridad prácticas y visibles para agentes de IA en Keshet, con control humano sobre acciones peligrosas.

¿Qué es Company Agent Guardrails?

Esta habilidad define un marco de reglas de seguridad prácticas para agentes de IA codificadores en la empresa Keshet. Su propósito no es reemplazar un sandbox completo, sino proporcionar controles visibles y confirmados por humanos sobre acciones peligrosas como ejecución de comandos shell, llamadas a Git, operaciones MCP, o acceso a secretos. Aplica a agentes en Claude Code, Cowork, y cualquier pipeline o automatización que use Claude. La habilidad incluye condiciones de activación, principios de diseño, un flujo de trabajo para redactar reglas, una postura predeterminada recomendada (con categorías Deny, Ask, Monitor), y una lista explícita de lo que NO debe hacer un agente. También proporciona una plantilla de salida para proponer conjuntos de reglas de seguridad.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add Amitro1234/keshet-claude-skills

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Company Agent Guardrails?

Propósito

Definir y aplicar reglas de seguridad prácticas para agentes de IA codificadores en toda Keshet — control visible y confirmado por humanos sobre acciones peligrosas, no seguridad a nivel de sandbox. Aplica a todos los agentes en Claude Code, Cowork, y cualquier pipeline o automatización que use Claude. Las categorías de políticas predeterminadas y las rutas de colocación de archivos por aplicación viven en reference.md.


Condiciones de activación

Siempre activo para cualquier sesión de agente de IA. Activar explícitamente cuando: se inicia una nueva sesión en un proyecto de Keshet, un agente está a punto de ejecutar llamadas shell/git/MCP, un usuario otorga autonomía amplia ("solo maneja esto"), se está diseñando o revisando un pipeline, o una acción tocaría secretos o archivos fuera del directorio del proyecto.


Primeros principios

  1. Identificar la superficie de acción: shell, lecturas/escrituras de archivos, git, llamadas MCP, instalación de paquetes, hooks, habilidades, secretos.
  2. Clasificar cada control como deny, ask, monitor o guidance.
  3. Preferir reglas pequeñas y explícitas sobre reglas amplias y vagas.
  4. Preservar la productividad del desarrollador — preguntar en acciones ambiguas, denegar solo las claramente inseguras.
  5. Indicar las limitaciones claramente: los archivos de instrucciones guían el comportamiento; los hooks/herramientas de endpoint aplican más, pero ninguno es un sandbox completo de SO sin un contenedor real.

Flujo de trabajo de redacción de reglas

  1. Preguntar dónde debe vivir la regla: configuración personal, configuración compartida del proyecto, o ambas.
  2. Preguntar qué debería suceder por categoría: bloquear, preguntar, monitorear o permitir.
  3. Redactar el conjunto de reglas útil más pequeño.
  4. Incluir ejemplos de acciones que activan la regla.
  5. Incluir limitaciones conocidas — qué sigue necesitando sandboxing o controles de endpoint.
  6. Si se escriben archivos, usar la ubicación nativa de la aplicación objetivo; mantener el lenguaje de la política agnóstico a la aplicación.

Postura predeterminada recomendada

Usar esta a menos que la empresa proporcione una política más estricta:

  • Deny: exfiltración de secretos, pipe-to-shell (curl ... | sh), deshabilitación de sandbox/permisos, comandos destructivos del sistema (borrado recursivo, formato de disco, limpieza de historial), acceso a almacenes de credenciales.
  • Ask: git push/force-push, despliegues, instalaciones de paquetes, cambios de esquema, escrituras fuera del directorio del proyecto, cualquier llamada a herramienta MCP que no esté en la lista aprobada por la organización.
  • Monitor: toda ejecución de shell, escrituras de archivos dentro del proyecto, llamadas a API externas — registrado y visible, no bloqueado.

Qué NO hacer

  • No instalar servidores MCP, hooks o servicios persistentes sin la aprobación explícita del usuario
  • No leer, mostrar ni pasar archivos .env o archivos de credenciales a ningún contexto
  • No ejecutar comandos destructivos de shell sin confirmación
  • No hacer push a git ni desplegar sin que el usuario vea exactamente lo que se enviará
  • No acceder a rutas de archivo fuera del directorio actual del proyecto
  • No reintentar operaciones fallidas en silencio — siempre mostrar los fallos
  • No tratar los archivos de reglas de solo instrucción como una aplicación a nivel de SO
  • No instalar herramientas de agente de terceros de fuentes no verificadas sin una revisión de seguridad — preferir revisar el código fuente sobre instalar artefactos de lanzamiento precompilados, y enrutar las instalaciones a través de verificación de suma de comprobación y un entorno piloto

Plantilla de salida

Al proponer un conjunto de reglas de seguridad, responder siempre con:

## Resumen de reglas de seguridad
<breve resumen de lo que se está protegiendo>

## Políticas
- Deny:    <acciones que están bloqueadas directamente>
- Ask:     <acciones que requieren confirmación explícita del usuario>
- Monitor: <acciones que se registran y son visibles pero no están bloqueadas>

## Archivos a crear o actualizar
- `<ruta>`: <propósito de este archivo>

## Limitaciones
<qué NO aplican estas reglas de seguridad — qué requiere sandboxing adicional o controles de endpoint>

Skills relacionados