Communitygithub.com

LevNas/ccaudit

Enregistrer et préserver les traces d'audit des sessions Claude Code assistées par IA : vidage automatique vers un dépôt distant à la fin de la session, plus /audit-flush pour une inspection manuelle.

Qu'est-ce que ccaudit ?

Cette compétence fournit une commande manuelle `/audit-flush` qui complète le crochet de fin de session automatique dans l'outil d'audit `ccaudit`. Elle permet aux utilisateurs d'inspecter les entrées de trace mises en scène avant leur vidage automatique, de réessayer des entrées qui ont échoué (par exemple, à cause de secrets détectés ou d'erreurs de push), et de forcer le vidage lorsque le mode manuel (`CCAUDIT_MANUAL=1`) est activé. La compétence est conçue pour être utilisée avec Claude Code (et des agents similaires comme Cursor, Codex) et repose sur des scripts shell et un dépôt Git distant. Elle offre des drapeaux comme `--dry-run` pour prévisualiser les actions et `--force` pour inclure le contenu du répertoire d'attente (`$CCAUDIT_PENDING_DIR`). Son objectif principal est de garantir que chaque action de vidage laisse une trace vérifiable (auteur du commit, horodatage) dans le dépôt distant, ce qui est essentiel pour la conformité et l'auditabilité des sessions IA.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add LevNas/ccaudit

Demander à votre IA préférée

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

Documentation

audit-flush

Contrepartie manuelle du crochet Stop. Même logique, invoquée à la demande.

Quand l'utiliser

  • L'utilisateur demande d'inspecter les entrées de trace mises en scène avant leur vidage automatique.
  • L'utilisateur souhaite réessayer des entrées qui ont été déplacées vers $CCAUDIT_PENDING_DIR suite à un échec antérieur (secret détecté ou erreur de push).
  • Le vidage automatique est désactivé (CCAUDIT_MANUAL=1) et les entrées doivent être vidées explicitement.
  • L'utilisateur a besoin d'un enregistrement écrit indiquant que " a inspecté et approuvé ce vidage à l'heure X" — exécuter /audit-flush laisse une trace (auteur du commit et horodatage) qu'un crochet Stop non supervisé ne peut pas fournir.

Drapeaux

DrapeauComportement
(aucun)Même flux que hooks/auto-flush.sh : analyse, vérification des secrets, push, nettoyage de la zone de mise en scène.
--dry-runListe ce qui serait vidé, se termine sans rien toucher.
--forceInclut le contenu de $CCAUDIT_PENDING_DIR en plus de la zone de mise en scène ; réessaie tout.

Procédure

Suivez skills/audit-flush/procedure.md étape par étape. N'inventez pas de vérifications de sécurité supplémentaires — le crochet et cette compétence doivent rester comportement-identiques, car une divergence créerait un état indéfini.

Ce que cette compétence NE fait PAS

  • Elle ne modifie pas les entrées de trace. Les entrées sont en ajout uniquement une fois écrites dans la zone de mise en scène.
  • Elle ne supprime rien du dépôt de trace distant. Si une mauvaise entrée a été poussée, la correction est une nouvelle entrée faisant référence à la mauvaise par son hash — jamais une réécriture.
  • Elle ne reconfigure pas le dépôt distant. CCAUDIT_TRAIL_REPO est en lecture seule du point de vue de cette compétence.

Skills associés