Skip to main content
ベータ機能。 初期フィードバックを収集している間、監査機能はベータ版として提供されます。 次の安定版リリース前に、検出器カタログとレポート形式が変更される可能性があります。 問題があればイシューを起票してください。
監査機能は、過去のエージェントCLIトランスクリプトを failproofai のポリシーエンジンで再生し、/audit ダッシュボードページに共有可能なビジュアルレポートを生成します。レポートにはエージェントのアーキタイプ、0〜100のスコア、そして各ポリシーが何を検出できたかが表示されます。

実行方法

3つの方法があり、いずれも同じ /audit レポートにアクセスできます。

インストール不要

npx -y failproofai audit は failproofai を取得してスキャンを実行し、ダッシュボードを自動的に開きます。事前インストールは不要です。

CLIから実行

failproofai audit はターミナルでスキャンを実行し、完了後に localhost:8020/audit を自動的に開きます。

ダッシュボードから実行

failproofai を実行してナビバーの Audit(PoliciesとProjectsの間)をクリックするか、/audit を直接開きます。
使い方を確認するには failproofai audit -h(または --help)を実行してください。監査は完全オフラインで動作し、アカウントやネットワーク接続は不要です。Ctrl+C で停止するまでダッシュボードはサービスを継続します。
ダッシュボードはこのマシン上の過去のエージェントCLIトランスクリプト(Claude Code、Codex、Copilot、Cursor、OpenCode、Pi、Gemini)をスキャンし、failproofai が防止するように設計された操作(環境変数チェック、フォースプッシュ、冗長な cd <cwd> プレフィックス、スリープポーリングループ、編集直後のファイル再読み込みなど)の発生頻度を報告します。 各トランスクリプトについて、すべてのツール使用イベントが39の組み込みポリシーおよびランタイムポリシーではまだカバーされていないパターンを検出する8つの監査専用検出器で再生されます。カウントはすべてのセッションにわたってポリシー/検出器ごとに集計されます。

取得できる情報

/audit ページは1画面で共有可能なポスターと、スクロール下部の4つのセクションで構成されています:
  1. ポスター — エージェントのプロファイルを一目で確認:アーキタイプ(8種類のうちの1つ — optimistcowboyexplorergoldfishparanoid architectprecision builderhammerghost)、ペルソナキーワード、そのアーキタイプの希少性、および階層バンド付きの0〜100スコアS から bottom tier まで)。XやLinkedInへの投稿やPNGダウンロードに対応した共有向けデザインです。
  2. // strengths — エージェントがすでに得意とすること。スキャンの実際の数値として表示されます(例:クリーンなツールコール率、0 回のmainへのプッシュ試行)。関連ポリシーで問題が検出されなかった場合のみ表示されます。
  3. // quirks — 問題として検出されたもの:failproofai がキャッチできた可能性のある動作のランク付きテーブル。いつ最後に発生したか、何が問題だったか(およびブロックできた組み込みポリシー)、その深刻度確認頻度newrecurringN× seen)が含まれます。
  4. // how to improve — 推奨される修正リスト:コピー貼り付け可能な failproofai policy add <slug> を含むポリシーの行と、すべての推奨事項を一括で有効にするすべてインストールボタン、および適用後の予測スコアが表示されます。
  5. // come back better — 習慣づくり:再監査のリマインダーメールを設定(3d7d14d30d)するか、今すぐ再監査を実行し、友人を招待して自分自身の監査を実行してもらえます(failproof.ai から送信され、あなたにCCされます)。リマインダーと招待にはサインインが必要です。failproofai auth を参照してください。

監査専用検出器

これらはリアルタイムでは(まだ)強制されていない「非効率な動作」パターンを検出します。監査中のみ実行され、ライブのツールコールをブロックすることはありません。

キャッシュ

  • トランスクリプトごとのキャッシュ~/.failproofai/cache/audit/<sha1>.json(mtime, size, engineVersion, detectorVersion) をキーとして保存されます。トランスクリプトまたはポリシー/検出器のコードが変更された場合、自動的に無効化されます。各エントリには cachedAt タイムスタンプが TTLメタデータとして保存されます(キャッシュキーには含まれません)。7日以上経過したエントリは読み取り時に拒否されるため、検出器の意図が進化しても古い結果が残り続けることはありません。
  • 結果全体のキャッシュ~/.failproofai/audit-dashboard.json(モード 0600)。ダッシュボードのナビゲーション時に再実行なしで即座にレンダリングできます。7日間のTTLを超えると読み取り時に拒否されます。その場合、/audit は空の状態にフォールバックして新規実行を促します。レポート下部の [ re-audit now ] をクリックすると更新できます。再監査は noCache: true を送信するため、トランスクリプトごとのキャッシュをバイパスしてキャッシュ結果を返す代わりにすべてのトランスクリプトを再スキャンします。実行状況は上部の固定ストリップでストリーミング表示され、成功時は結果がその場で更新されます(ページのリロードなし。再監査に失敗した場合は以前のレポートが保持されます)。

注意事項

  • 変更なし。 監査は読み取り専用モードで再生されます。warn-repeated-tool-calls は、セッションごとのサイドカーが変更されてしまうためスキップされます。
  • ワークフローポリシーはスキップ。 require-*-before-stop ポリシーは Stop イベント時にのみ発火し、ライブのgit状態に対して execSync を実行します。これらは「2025年に何が起きたか」という意味のある解釈ができないため、監査カウントには含まれません。
  • カスタムポリシーはスキップ。 ユーザーが定義したカスタムフックは再生されません(元のセッション以降に変更されている可能性があるため)。