> ## Documentation Index
> Fetch the complete documentation index at: https://exosphere-auto-translate-docs-20260623-1106.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 過去のセッションを監査する（ベータ版）

> 過去のトランスクリプト全体で、エージェントが無駄または危険な操作を行った頻度を集計します

<Note>
  **ベータ機能。** 初期フィードバックを収集している間、監査機能はベータ版として提供されます。
  次の安定版リリース前に、検出器カタログとレポート形式が変更される可能性があります。
  問題があればイシューを起票してください。
</Note>

監査機能は、過去のエージェントCLIトランスクリプトを failproofai のポリシーエンジンで再生し、**`/audit` ダッシュボードページ**に共有可能なビジュアルレポートを生成します。レポートにはエージェントのアーキタイプ、0〜100のスコア、そして各ポリシーが何を検出できたかが表示されます。

## 実行方法

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

<CodeGroup>
  ```bash npx (no install) theme={null}
  npx -y failproofai audit
  ```

  ```bash failproofai audit theme={null}
  failproofai audit
  ```

  ```bash failproofai (dashboard) theme={null}
  failproofai
  ```
</CodeGroup>

<CardGroup cols={3}>
  <Card title="インストール不要" icon="bolt">
    `npx -y failproofai audit` は failproofai を取得してスキャンを実行し、ダッシュボードを自動的に開きます。事前インストールは不要です。
  </Card>

  <Card title="CLIから実行" icon="terminal">
    `failproofai audit` はターミナルでスキャンを実行し、完了後に `localhost:8020/audit` を自動的に開きます。
  </Card>

  <Card title="ダッシュボードから実行" icon="gauge">
    `failproofai` を実行してナビバーの **Audit**（PoliciesとProjectsの間）をクリックするか、`/audit` を直接開きます。
  </Card>
</CardGroup>

<Tip>
  使い方を確認するには `failproofai audit -h`（または `--help`）を実行してください。監査は**完全オフライン**で動作し、アカウントやネットワーク接続は不要です。`Ctrl+C` で停止するまでダッシュボードはサービスを継続します。
</Tip>

ダッシュボードはこのマシン上の過去のエージェントCLIトランスクリプト（Claude Code、Codex、Copilot、Cursor、OpenCode、Pi、Gemini）をスキャンし、failproofai が防止するように設計された操作（環境変数チェック、フォースプッシュ、冗長な `cd <cwd>` プレフィックス、スリープポーリングループ、編集直後のファイル再読み込みなど）の発生頻度を報告します。

各トランスクリプトについて、すべてのツール使用イベントが39の組み込みポリシー**および**ランタイムポリシーではまだカバーされていないパターンを検出する8つの監査専用検出器で再生されます。カウントはすべてのセッションにわたってポリシー／検出器ごとに集計されます。

## 取得できる情報

`/audit` ページは1画面で共有可能な**ポスター**と、スクロール下部の4つのセクションで構成されています：

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

## 監査専用検出器

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

| 検出器                         | 検出内容                                                                    |
| --------------------------- | ----------------------------------------------------------------------- |
| `redundant-cd-cwd`          | コマンドがすでに `cwd` で実行されているにもかかわらず、`cd <cwd> && …` で始まる Bash コマンド。          |
| `prefer-edit-over-read-cat` | 単一のソースファイルに対する `cat`/`head`/`tail`/`less`/`more` — `Read` ツールを使用してください。 |
| `prefer-edit-over-sed-awk`  | `sed -i` / `awk … > file` によるインプレース編集 — `Edit` ツールを使用してください。            |
| `prefer-write-over-heredoc` | ヒアドキュメントや複数行の `echo > file` によるファイル書き込み — `Write` ツールを使用してください。         |
| `sleep-polling-loop`        | 長い `sleep N`（30秒以上）または `while …; sleep …; done` ポーリングループ。               |
| `find-from-root`            | `find /`、`find /home`、`find /usr` など — 代わりに `cwd` をスコープとして使用してください。     |
| `git-commit-no-verify`      | `git commit … --no-verify` / `-n` によるフックのスキップ。                          |
| `reread-after-edit`         | 同じセッション内で `Edit`/`Write` した直後のファイルへの `Read`。                            |

## キャッシュ

* **トランスクリプトごとのキャッシュ**：`~/.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年に何が起きたか」という意味のある解釈ができないため、監査カウントには含まれません。
* **カスタムポリシーはスキップ。** ユーザーが定義したカスタムフックは再生されません（元のセッション以降に変更されている可能性があるため）。