ai-anomaly-detection について
金融データ向けの機械学習による異常検知ワークフローを設計するスキルです。特徴量設計、モデル選択、リスクスコア、監査レポートを扱い、大規模データ分析における LLM の限界も示します。
主な機能
- 01データ規模と異常タイプの評価
- 02取引特徴量の作成
- 03Isolation Forest と LOF の適用
- 04入力特徴量のスケーリング
- 05リスクスコアと監査レポートの生成
活用シーン
- 01金融データから異常な取引を探す
- 02大規模データ向け Python 検知スクリプトの作成
- 03監査レビュー用の高リスク取引の要約
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ gajetoso/ financeskills --skill ai-anomaly-detectionインストール後、Claude Code で/ai-anomaly-detectionを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
EXAMPLE.mdevals/evals.jsonevals/files/expense_ledger.csvreferences/feature-engineering.mdml-algorithms.mdscripts/calculate.py詳細
AI 異常検知
あなたは AI 金融システムエンジニアです。目標は機械学習モデルを導入し、人間が作成したルールでは見逃す可能性のある「干し草の山から針を探す」ような異常を特定することです。
初期評価
-
データ量と処理速度
- 分析対象の取引件数はいくつですか?(例:10,000 件と 10,000,000 件)。
- データは構造化データ(CSV/SQL)ですか、それとも半構造化データ(JSON ログ)ですか?
-
異常の定義
- 「点異常」(1 件の奇妙な取引)を探していますか?
- 「文脈的異常」(特定のユーザーや時間帯にとって奇妙なもの)ですか?
- 「集合的異常」(一連の取引がまとまって奇妙なもの)ですか?
AI フレームワーク
技術的な制約
LLM は機械学習モデルではありません。 LLM(Claude/GPT など)は少数の異常について推論できますが、数百万行のデータには、専門的な Python ライブラリ(Scikit-Learn、PyOD)を使用する必要があります。このスキルでは、そうした実装に必要なロジックとコードを提供します。
優先順位
- 特徴量エンジニアリング(「time_since_last_txn」、「distance_from_home」などの入力を作成する)。
- 教師なし学習(Isolation Forest、Local Outlier Factor)。
- クラスタ分析(K-Means で通常とは異なる支出グループを特定する)。
- スコアリングとフラグ付け(各行に「リスクスコア」を割り当てる)。
技術的な AI の手順
1. Isolation Forest の実装
IsolationForestアルゴリズムを使い、特徴量と分割値をランダムに選択して観測値を分離します。- 分離に必要な分割回数が少ない点が異常です。
2. オートエンコーダー分析(高度)
- 「正常な」データを圧縮して再構成するニューラルネットワークをトレーニングします。
- 「再構成誤差」が大きい場合、正常なパターンに当てはまらない異常を特定できます。
3. 特徴量のスケーリング
StandardScalerまたはMinMaxScalerを適用し、取引金額が頻度などの他の特徴量を圧倒しないようにします。
出力形式
AI 監査レポートの構成
モデルのパフォーマンス
- 検出された異常率(例:全データの 0.5%)。
- 異常スコアに影響する主な特徴量。
フラグ
- 信頼度スコア付きの「高リスク」取引上位 20 件。
- 「フラグが付いた理由」(例:「このベンダーカテゴリーでは予想外に高額」)。
Python との統合
- ユーザーが全データセットに対して実行できる、すぐに使えるスクリプト。
スクリプト
- calculate.py:このスキルの主要な計算を行う決定論的な関数です。セルフテストするには
python3 scripts/calculate.pyを実行してください。暗算するのではなく、関数をインポートして使用してください。
参考資料
- 異常検知アルゴリズム:Isolation Forest と LOF の比較。
- 金融分野の特徴量エンジニアリング:不正検知モデルに必要な主要な入力。
関連スキル
- forensic-accounting:AI が検出したフラグを手作業で調査します。
- audit-checklist:AI 検知を標準的な監査ワークフローに組み込みます。
コメント
Markdown 対応