ディテクターライブラリファイルの影響範囲

ファイルの影響範囲

小さなタスク。30個のファイルが変更された。

エージェントタスクが予想以上のファイルに及んだ場合を検出する。

問題を見て、検出結果を理解する。

英語のナレーション、キャプション付き。

なぜ見落とされるのか

小さな修正をリクエストしました。エージェントはプロジェクト全体のファイルに触れ始めます。広範なリファクタリングが正しい場合もありますが、1行の変更とは異なるレベルの注意が必要です。

ファイル操作が1つずつ現れると、このリスクは見逃しやすいです。各編集は単独では小さく見えます。しかし全体では、元のタスクが示唆していたよりもはるかに広い範囲に影響する可能性があります。

ClawMetryが検出するもの

ClawMetryはファイル変更の範囲と破壊的なコマンドパターンについてキャプチャされたツール引数を検査します。広範な編集はファイルの影響範囲の警告を発することがあります。ルートの場所をターゲットにした認識された再帰的な削除は、クリティカルな検出結果を発することがあります。

検出結果を左右する違い

トリガーの例

30個の異なるファイルへの書き込み

警告の検出結果

静かな比較例

4個の異なるファイルへの書き込み

このディテクターの検出結果はありません。

確認した比較では、30個の異なるファイルへの書き込みで警告が発生します。4個のファイルへの書き込みは静かなままです。広範な編集のしきい値はランタイムとそのベースラインによって異なる場合があります。検出結果はレビューに集中するための回数と範囲を示すエビデンスを提供します。

ディテクターの結果を確認する
{
  "kind": "file_blast_radius",
  "severity": "warning",
  "evidence": {
    "distinct_files": 30,
    "write_calls": 30,
    "threshold": 25,
    "threshold_source": "static",
    "baseline": null,
    "outside_workspace": 0,
    "destructive": [],
    "samples": [
      "example/f0.py",
      "example/f1.py",
      "example/f2.py"
    ],
    "observed": "tool_arguments"
  }
}
入力と完全な結果をダウンロードする(JSON)
例の確認方法

これらの例は、作成されたイベントデータまたは使い捨ての設定ファイルを使って公開済みディテクターを評価します。動画はこれらの動作を説明しています。ライブエージェントや製品インターフェイスの録画ではありません。例のコマンドは実行されていません。

この結果はこれらの入力に対する動作を示すものです。ランタイムへの取り込み、防止、または実際の侵害を証明するものではありません。 固定されたソースコントラクトを確認する.

次に確認すること

影響を受けた範囲とリクエストを比較してください。特に生成された変更と削除を含む実際の差分を確認してください。結果を受け入れる前に、関連するファイルをテストがカバーしていることを確認してください。まだコンテキストがある間に、予期せず広い変更を捉えることが目的です。

  1. スコープとタスクを比較する
  2. 実際の差分をレビューする
  3. テストと削除を確認する

このシグナルが示すもの

これはツール引数を読み取るものであり、ファイルシステムのシスコールではありません。アクションの後に報告し、名前付きのすべての変更が成功したことを証明するものではありません。

重要な瞬間を見逃さない。

エージェントのアクティビティを追跡し、検出結果を確認して、注意が必要なものを判断してください。