Communitygithub.com

Gardes-fous pour Agents d'Entreprise

Définir et appliquer des gardes-fous pratiques et visibles pour les agents IA de codage chez Keshet, avec contrôle humain explicite sur les actions dangereuses.

Qu'est-ce que Gardes-fous pour Agents d'Entreprise ?

Ce skill fournit un cadre structuré pour définir et appliquer des gardes-fous de sécurité pour les agents de codage IA dans un environnement d'entreprise comme Keshet. Il ne s'agit pas d'une sécurité de type sandbox, mais de règles visibles et approuvées par l'homme pour contrôler les actions potentiellement dangereuses. Le skill est toujours actif lors des sessions d'agents et s'applique à Claude Code, Cowork et tout pipeline utilisant Claude. Les utilisateurs peuvent classifier les actions en 'deny' (bloquer), 'ask' (demander confirmation), 'monitor' (surveiller) ou 'guidance' (guider), et suivre un flux de travail pour rédiger des règles minimales et explicites. Le skill fournit également une posture par défaut recommandée, un modèle de sortie structuré et des exemples de ce qu'il ne faut pas faire, garantissant ainsi que les gardes-fous sont pratiques, faciles à implémenter et ne bloquent pas inutilement la productivité des développeurs.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Gardes-fous pour Agents d'Entreprise ?

Objectif

Définir et appliquer des gardes-fous pratiques et visibles pour les agents de codage IA à travers Keshet — un contrôle humain confirmé sur les actions dangereuses, et non une sécurité de niveau sandbox. S'applique à tous les agents dans Claude Code, Cowork, et tout pipeline ou automatisation utilisant Claude. Les catégories de politique par défaut et les chemins de placement des fichiers par application se trouvent dans reference.md.


Conditions de Déclenchement

Toujours actif pour toute session d'agent IA. Activer explicitement quand : une nouvelle session démarre sur un projet Keshet, un agent s'apprête à exécuter des appels shell/git/MCP, un utilisateur accorde une large autonomie (« gère ça tout seul »), un pipeline est conçu ou révisé, ou une action toucherait des secrets ou des fichiers en dehors du répertoire du projet.


Premiers Principes

  1. Identifier la surface d'action : shell, lectures/écritures de fichiers, git, appels MCP, installations de paquets, hooks, compétences, secrets.
  2. Classifier chaque contrôle comme deny, ask, monitor ou guidance.
  3. Préférer des règles petites et explicites à des règles larges et vagues.
  4. Préserver la productivité des développeurs — demander pour les actions ambiguës, bloquer uniquement celles clairement dangereuses.
  5. Énoncer clairement les limites : les fichiers d'instructions guident le comportement ; les hooks et les outils de point de terminaison renforcent davantage, mais aucun n'est un sandbox OS complet sans confinement réel.

Flux de Travail pour la Rédaction de Règles

  1. Demander où la règle doit vivre : configuration personnelle, configuration partagée du projet, ou les deux.
  2. Demander ce qui doit se produire par catégorie : bloquer, demander, surveiller ou autoriser.
  3. Rédiger l'ensemble de règles le plus petit et utile.
  4. Inclure des exemples d'actions qui déclenchent la règle.
  5. Inclure les limitations connues — ce qui nécessite encore un sandboxing ou des contrôles de point de terminaison.
  6. Si vous écrivez des fichiers, utilisez l'emplacement natif de l'application cible ; gardez le libellé de la politique agnostique à l'application.

Posture Par Défaut Recommandée

Utilisez ceci sauf si l'entreprise fournit une politique plus stricte :

  • Deny : exfiltration de secrets, tuyau vers le shell (curl ... | sh), désactivation du sandbox/des permissions, commandes système destructrices (suppression récursive, formatage de disque, effacement de l'historique), accès au magasin d'identifiants.
  • Ask : git push/force-push, déploiements, installations de paquets, modifications de schéma, écritures en dehors du répertoire du projet, tout appel d'outil MCP non approuvé par l'organisation.
  • Monitor : toute exécution de shell, écritures de fichiers dans le projet, appels API externes — enregistrés et visibles, non bloqués.

Ce qu'il NE PAS faire

  • Ne pas installer de serveurs MCP, hooks ou services persistants sans approbation explicite de l'utilisateur
  • Ne pas lire, afficher ou transmettre les fichiers .env ou les fichiers d'identifiants dans un contexte quelconque
  • Ne pas exécuter de commandes shell destructrices sans confirmation
  • Ne pas pousser vers git ou déployer sans que l'utilisateur voie exactement ce qui sera poussé
  • Ne pas accéder aux chemins de fichiers en dehors du répertoire du projet actuel
  • Ne pas réessayer silencieusement des opérations ayant échoué — remontez toujours les échecs
  • Ne pas traiter les fichiers de garde-fous basés uniquement sur des instructions comme une application au niveau OS
  • Ne pas installer d'outils d'agents tiers provenant de sources non vérifiées sans une revue de sécurité — préférez la revue du code source à l'installation d'artefacts de release préconstruits, et acheminez les installations via une vérification de somme de contrôle et un environnement pilote

Modèle de Sortie

Lorsque vous proposez un ensemble de garde-fous, répondez toujours avec :

## Résumé des Garde-fous
<court résumé de ce qui est protégé>

## Politiques
- Deny :    <actions qui sont bloquées directement>
- Ask :     <actions qui nécessitent une confirmation explicite de l'utilisateur>
- Monitor : <actions qui sont enregistrées et visibles mais non bloquées>

## Fichiers à Créer ou Mettre à Jour
- `<chemin>` : <objectif de ce fichier>

## Limitations
<ce que ces garde-fous N'APPLIQUENT PAS — ce qui nécessite un sandboxing ou des contrôles de point de terminaison supplémentaires>

Skills associés