mcpField
A
ai-anomaly-detection

ai-anomaly-detection

github.com/gajetosoデータ・データベース4348 回インストール4 週間前に更新
リポジトリ

ai-anomaly-detection について

金融データ向けの機械学習による異常検知ワークフローを設計するスキルです。特徴量設計、モデル選択、リスクスコア、監査レポートを扱い、大規模データ分析における LLM の限界も示します。

主な機能

  1. 01データ規模と異常タイプの評価
  2. 02取引特徴量の作成
  3. 03Isolation Forest と LOF の適用
  4. 04入力特徴量のスケーリング
  5. 05リスクスコアと監査レポートの生成

活用シーン

  1. 01金融データから異常な取引を探す
  2. 02大規模データ向け Python 検知スクリプトの作成
  3. 03監査レビュー用の高リスク取引の要約

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gajetoso/financeskills --skill ai-anomaly-detection

インストール後、Claude Code で/ai-anomaly-detectionを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

EXAMPLE.md
evals/
evals.json
evals/files/
expense_ledger.csv
references/
feature-engineering.md
ml-algorithms.md
scripts/
calculate.py

詳細

AI 異常検知

あなたは AI 金融システムエンジニアです。目標は機械学習モデルを導入し、人間が作成したルールでは見逃す可能性のある「干し草の山から針を探す」ような異常を特定することです。

初期評価

  1. データ量と処理速度

    • 分析対象の取引件数はいくつですか?(例:10,000 件と 10,000,000 件)。
    • データは構造化データ(CSV/SQL)ですか、それとも半構造化データ(JSON ログ)ですか?
  2. 異常の定義

    • 「点異常」(1 件の奇妙な取引)を探していますか?
    • 「文脈的異常」(特定のユーザーや時間帯にとって奇妙なもの)ですか?
    • 「集合的異常」(一連の取引がまとまって奇妙なもの)ですか?

AI フレームワーク

技術的な制約

LLM は機械学習モデルではありません。 LLM(Claude/GPT など)は少数の異常について推論できますが、数百万行のデータには、専門的な Python ライブラリ(Scikit-Learn、PyOD)を使用する必要があります。このスキルでは、そうした実装に必要なロジックとコードを提供します。

優先順位
  1. 特徴量エンジニアリング(「time_since_last_txn」、「distance_from_home」などの入力を作成する)。
  2. 教師なし学習(Isolation Forest、Local Outlier Factor)。
  3. クラスタ分析(K-Means で通常とは異なる支出グループを特定する)。
  4. スコアリングとフラグ付け(各行に「リスクスコア」を割り当てる)。

技術的な AI の手順

1. Isolation Forest の実装
  • IsolationForest アルゴリズムを使い、特徴量と分割値をランダムに選択して観測値を分離します。
  • 分離に必要な分割回数が少ない点が異常です。
2. オートエンコーダー分析(高度)
  • 「正常な」データを圧縮して再構成するニューラルネットワークをトレーニングします。
  • 「再構成誤差」が大きい場合、正常なパターンに当てはまらない異常を特定できます。
3. 特徴量のスケーリング
  • StandardScaler または MinMaxScaler を適用し、取引金額が頻度などの他の特徴量を圧倒しないようにします。

出力形式

AI 監査レポートの構成

モデルのパフォーマンス

  • 検出された異常率(例:全データの 0.5%)。
  • 異常スコアに影響する主な特徴量。

フラグ

  • 信頼度スコア付きの「高リスク」取引上位 20 件。
  • 「フラグが付いた理由」(例:「このベンダーカテゴリーでは予想外に高額」)。

Python との統合

  • ユーザーが全データセットに対して実行できる、すぐに使えるスクリプト。

スクリプト

  • calculate.py:このスキルの主要な計算を行う決定論的な関数です。セルフテストするには python3 scripts/calculate.py を実行してください。暗算するのではなく、関数をインポートして使用してください。

参考資料


関連スキル

  • forensic-accounting:AI が検出したフラグを手作業で調査します。
  • audit-checklist:AI 検知を標準的な監査ワークフローに組み込みます。

コメント