Communitygithub.com

LevNas/ccaudit

Registra y preserva registros de auditoría de sesiones de Claude Code asistidas por IA: vaciado automático a un repositorio de seguimiento remoto al finalizar la sesión, más /audit-flush para inspección manual.

¿Qué es ccaudit?

Esta habilidad proporciona un mecanismo de auditoría inmutable y auditable para sesiones de Claude Code. Al adjuntar un hook de "Stop" que vacía automáticamente las entradas de seguimiento a un repositorio remoto al finalizar la sesión, se asegura que cada acción asistida por IA quede registrada permanentemente. Además, ofrece un comando manual `/audit-flush` que replica la misma lógica, permitiendo a los usuarios inspeccionar, verificar o reintentar entradas antes de que sean enviadas. Soporta flags como `--dry-run` para previsualizar el vaciado y `--force` para incluir entradas pendientes de reintentos. Es útil para cumplir con requisitos de auditoría, mantener transparencia en sesiones de desarrollo colaborativo y dejar un rastro verificable de revisiones humanas.

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

Preguntar en tu IA favorita

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

Documentación

audit-flush

Contraparte manual del hook Stop. Misma lógica, invocada bajo demanda.

Cuándo usarlo

  • El usuario pide inspeccionar las entradas de seguimiento preparadas antes de que se vacíen automáticamente.
  • El usuario quiere reintentar entradas que se movieron a $CCAUDIT_PENDING_DIR después de un fallo anterior (acierto secreto o error de push).
  • El vaciado automático está deshabilitado (CCAUDIT_MANUAL=1) y las entradas deben vaciarse explícitamente.
  • El usuario necesita un registro escrito de que " inspeccionó y aprobó este vaciado a la hora X" — ejecutar /audit-flush deja un rastro (el autor del commit y la marca de tiempo) que un hook Stop desatendido no puede dejar.

Banderas

BanderaComportamiento
(ninguna)Mismo flujo que hooks/auto-flush.sh: escanear, verificar secretos, hacer push, limpiar preparación.
--dry-runLista lo que se vaciaría, sale sin tocar nada.
--forceIncluye el contenido de $CCAUDIT_PENDING_DIR además de la preparación; reintenta todo.

Procedimiento

Sigue paso a paso skills/audit-flush/procedure.md. No inventes verificaciones de seguridad adicionales — el hook y esta habilidad deben permanecer con comportamiento idéntico, ya que la divergencia crea un estado indefinido.

Qué NO hace esta habilidad

  • No modifica las entradas de seguimiento. Las entradas son de solo añadido una vez que se escriben en la preparación.
  • No elimina del repositorio de seguimiento remoto. Si se envió una entrada incorrecta, la corrección es una nueva entrada que referencia la incorrecta por su hash — nunca una reescritura.
  • No reconfigura el repositorio remoto. CCAUDIT_TRAIL_REPO es de solo lectura desde la perspectiva de esta habilidad.

Skills relacionados