Repolode
Agent-Threat-Rule

Agent-Threat-Rule/agent-threat-rules

AIエージェントへの脅威を検出するオープンなルール形式。プロンプトインジェクション、ツールポイズニング、MCP攻撃に対応した実行・テスト可能なYAMLルールを提供します。

スター
426
フォーク
66
未解決の Issue
46
最終コミット
17 時間前

これは何?

ATR(Agent Threat Rules)は、AIエージェントを狙う攻撃を検出するベンダー非依存のルール形式です。SIEMログ向けのSigmaやマルウェア向けのYARAを参考にしています。各ルールはバージョン管理されたスキーマに基づくYAMLドキュメントで、攻撃パターン、検査対象の入力フィールド(LLMの入力と出力、ツール呼び出しの引数、SKILL.mdの内容、エージェント設定)、テストケース、OWASPやMITRE ATLASなどのフレームワークとのマッピングを定義します。

リポジトリには、npmパッケージとCLIを備えたTypeScript製の参照エンジンに加え、Pythonラッパー(pyatr)が含まれています。CLIでは、スキルファイル、MCP設定、ツール一覧をスキャンできるほか、ルールを正規表現、Splunk SPL、Elasticsearch形式にエクスポートしたり、各ルールに付属するテストケースを実行したりできます。GitHub ActionはSecurityタブに表示できるSARIF結果を出力し、MCPサーバーを介してClaude CodeやCursorなどのIDEクライアントと連携できます。

ルール集は、プロンプトインジェクション、ツールポイズニング、コンテキストの窃取、権限昇格、スキルの侵害などのカテゴリを網羅しています。プロジェクトでは、ソースごとの検出測定値をレーン別に公開し、既知の制約や回避手法についても説明しています。

主な機能

  • 01ルールはバージョン管理されたスキーマに基づくYAMLドキュメントで、公開形式のATR-YYYY-NNNNN識別子を使用します。
  • 02TypeScript製のエンジンとCLIに加え、Pythonパッケージ(pyatr)も提供します。
  • 03ルールを正規表現、Splunk SPL、Elasticsearchクエリ形式にエクスポートできます。
  • 04GitHub Actionがコードスキャン用のSARIF結果を出力します。
  • 05Claude CodeやCursorなどのIDEクライアントとリアルタイムに連携するMCPサーバーを提供します。
  • 06各ルールはOWASP Agentic Top 10、OWASP LLM Top 10、MITRE ATLASの項目に対応付けられています。

ユースケース

  • マージ前にCIでSKILL.mdファイルやMCPサーバー設定をスキャンする。
  • エンジンAPIを介して、エージェントフレームワークやプロキシに実行時のプロンプトインジェクション検査を追加する。
  • 検出ルールをSplunkやElasticsearchなど、既存のSIEMにエクスポートする。
  • 共有可能でテスト可能なエージェント攻撃パターン集を使い、LLMアプリケーションをレッドチーム演習で検証する。

クイックスタート

  1. 1

    npm パッケージをインストールする

    npm install agent-threat-rules
  2. 2

    CLI で SKILL.md ファイルをスキャンする

    atr scan skill.md

使う前に知っておきたいこと

  • Lane の誤検知率は取り下げられ、再測定もまだ行われていないため、現在は適合率の数値を確認できません。
  • 現在のガバナンスは単独メンテナー体制で、今後 Technical Steering Committee への移行が予定されています。

トピック

#agent-security#ai-security#prompt-injection#mcp-security#llm-security#threat-detection#yaml-rules#sigma-rules#agent-threat-rules#garak

よくある質問

agent-threat-rules とは?
AIエージェントへの脅威を検出するオープンなルール形式。プロンプトインジェクション、ツールポイズニング、MCP攻撃に対応した実行・テスト可能なYAMLルールを提供します。 ATR(Agent Threat Rules)は、AIエージェントを狙う攻撃を検出するベンダー非依存のルール形式です。SIEMログ向けのSigmaやマルウェア向けのYARAを参考にしています。各ルールはバージョン管理されたスキーマに基づくYAMLドキュメントで、攻撃パターン、検査対象の入力フィールド(LLMの入力と出力、ツール呼び出しの引数、SKILL.mdの内容、エージェント設定)、テストケース、OWASPやMITRE ATLASなどのフレームワークとのマッピングを定義します。
agent-threat-rules は無料で使えますか?ライセンスは?
agent-threat-rules は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
agent-threat-rules は今もメンテナンスされていますか?
活発にメンテナンス中。agent-threat-rules の最終コミットは 2026年11月6日 です。
agent-threat-rules は何に使えますか?
マージ前にCIでSKILL.mdファイルやMCPサーバー設定をスキャンする。 エンジンAPIを介して、エージェントフレームワークやプロキシに実行時のプロンプトインジェクション検査を追加する。 検出ルールをSplunkやElasticsearchなど、既存のSIEMにエクスポートする。 共有可能でテスト可能なエージェント攻撃パターン集を使い、LLMアプリケーションをレッドチーム演習で検証する。
agent-threat-rules のインストール方法は?
npm パッケージをインストールする: npm install agent-threat-rules CLI で SKILL.md ファイルをスキャンする: atr scan skill.md
agent-threat-rules はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/Agent-Threat-Rule/agent-threat-rules

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト