Communitygithub.com

Phreee/meter-anomaly-detection-skill

このプロジェクトは、Claude Code Skill(Form Cアーキテクチャ)を使用して、スマートメーターの30分単位の電力消費データに対して異常検出を実行するPythonパイプラインを駆動する方法を示しています。

meter-anomaly-detection-skill とは?

このスキルは、Claude Code Skill(Form Cアーキテクチャ)を活用して、スマートメーターから収集された30分単位の電力消費データに対して異常検出を実行するためのPythonベースのパイプラインを構築・実行する方法を示しています。開発者は、このスキルを使用することで、Form C規格に準拠したClaude Codeエージェントが自動的にデータの前処理、特徴量エンジニアリング、異常検出モデルの適用、結果の可視化までを一連のワークフローとして実行できるようになります。主なユースケースとしては、家庭やビルの電力使用パターンから異常な消費行動(機器の故障、不正使用、メーター障害など)を検出することが挙げられます。このスキルは、Claude CodeのSkillシステムと連携して動作し、開発者が定義した異常検出ロジックをエージェントが自律的に実行し、結果をレポートとして提供します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add Phreee/meter-anomaly-detection-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

meter-anomaly-detection-skill は何をしますか?

このプロジェクトは、Claude Code Skill(Form Cアーキテクチャ)を使用して、スマートメーターの30分単位の電力消費データに対して異常検出を実行するPythonパイプラインを駆動する方法を示しています。

概要

このスキルは、以下の機能を提供します:

  • データ読み込み: CSV形式のスマートメーターデータを読み込みます。
  • 前処理: 欠損値の補完、時系列のリサンプリング、異常値の除去を行います。
  • 特徴量エンジニアリング: 移動平均、曜日効果、時間帯効果などの特徴量を生成します。
  • 異常検出: Isolation Forest、LOF(Local Outlier Factor)、または統計的手法(Zスコア)を使用して異常を検出します。
  • 可視化: 検出された異常をグラフで可視化し、レポートを生成します。

必要条件

  • Python 3.8以上
  • 必要なライブラリ: pandas, numpy, scikit-learn, matplotlib, seaborn

インストール

pip install pandas numpy scikit-learn matplotlib seaborn

使用方法

  1. データファイル(例:meter_data.csv)をプロジェクトディレクトリに配置します。
  2. Claude Codeで以下のコマンドを実行します:
claude-code skill run phreee/meter-anomaly-detection-skill --input ./meter_data.csv
  1. 出力はoutput/ディレクトリに生成されます。

スキルの設定

スキルは環境変数または設定ファイルで以下のパラメータをカスタマイズできます:

  • METHOD: 異常検出手法(isolation_forest, lof, zscore)
  • CONTAMINATION: 期待される異常の割合(デフォルト: 0.1)
  • WINDOW_SIZE: 移動平均のウィンドウサイズ(デフォルト: 48)

出力

  • output/anomalies.csv: 検出された異常の一覧
  • output/plot.png: 異常を可視化したグラフ
  • output/report.md: 分析レポート

ライセンス

MIT

関連スキル