Communitygithub.com

LevNas/ccaudit – 監査証跡フラッシュ

AI支援によるClaude Codeセッションの監査証跡を記録・保存します。セッション終了時に自動でリモート証跡リポジトリにフラッシュし、/audit-flush で手動点検も可能です。

ccaudit – 監査証跡フラッシュ とは?

このスキルは、Claude CodeセッションにおけるAI支援作業の監査証跡を確実に記録・保存するためのものです。セッション終了時に自動でリモート証跡リポジトリへフラッシュ(自動フラッシュ)するStopフックの手動版として機能します。ユーザーは /audit-flush コマンドを実行することで、ステージングされた証跡エントリをフラッシュ前に検査したり、以前の失敗(秘密情報検出やプッシュエラー)により $CCAUDIT_PENDING_DIR に移動したエントリを再試行したりできます。また、手動フラッシュを強制する `--dry-run` フラグや `--force` フラグもサポートしています。このスキルは、証跡の改ざん防止(追記のみ、削除不可)と、自動フラッシュとの動作同一性を保つように設計されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add LevNas/ccaudit

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

audit-flush

Stopフックの手動版です。同じロジックをオンデマンドで実行します。

使用タイミング

  • ユーザーが自動フラッシュ前にステージングされた証跡エントリを検査したい場合
  • 以前の失敗(秘密情報検出やプッシュエラー)により $CCAUDIT_PENDING_DIR に移動したエントリを再試行したい場合
  • 自動フラッシュが無効になっている場合(CCAUDIT_MANUAL=1)で、明示的にフラッシュする必要がある場合
  • 「<ユーザー> が時刻Xにこのフラッシュを検査・承認した」という記録を残す必要がある場合 – /audit-flush を実行すると、無人実行のStopフックでは残せない痕跡(コミット作成者とタイムスタンプ)が残ります。

フラグ

フラグ動作
(なし)hooks/auto-flush.sh と同じフロー:スキャン、秘密情報チェック、プッシュ、ステージングクリア。
--dry-runフラッシュされる内容を一覧表示し、何も変更せずに終了。
--forceステージングに加えて $CCAUDIT_PENDING_DIR の内容も含め、すべてを再試行。

手順

skills/audit-flush/procedure.md に従って手順を進めてください。追加の安全チェックを独自に追加しないでください – フックとこのスキルの動作は同一でなければならず、逸脱すると未定義の状態になります。

このスキルが行わないこと

  • 証跡エントリを変更しません。エントリはステージングに書き込まれた後は追記のみです。
  • リモート証跡リポジトリから削除しません。誤ったエントリがプッシュされた場合の修正は、そのエントリのハッシュを参照する新しいエントリを作成することであり、書き換えは決して行いません。
  • リモートの再構成は行いません。CCAUDIT_TRAIL_REPO はこのスキルからは読み取り専用です。

関連スキル