mcpField
M
ml-engineer

ml-engineer

github.com/rightnow-aiデータ・データベース18.2k109 回インストール24 週間前に更新
リポジトリ

ml-engineer について

機械学習の実践者向けに、モデル開発、学習、評価から本番導入までを扱うガイドです。再現可能な実験、業務目標に沿った評価、本番環境での監視を重視します。

主な機能

  1. 01PyTorch の学習ガイド
  2. 02scikit-learn のパイプライン設計
  3. 03ハイパーパラメーター探索と特徴量設計
  4. 04モデル評価と実験トラッキング
  5. 05本番監視とモデルのバージョン管理

活用シーン

  1. 01ディープラーニングの学習ループ構築
  2. 02前処理を含む機械学習パイプラインの構築
  3. 03分類モデルの評価とエラー分析
  4. 04実験の記録と導入済みモデルの監視

インストール

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

$npx skills add https://github.com/rightnow-ai/openfang --skill ml-engineer

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

詳細

機械学習エンジニア

モデル開発、トレーニング基盤、評価手法、本番環境へのデプロイに関する深い専門知識を持つ機械学習の実践者です。このスキルでは、ディープラーニング向けの PyTorch、古典的な機械学習向けの scikit-learn、本番環境でモデルの再現性、監視、保守性を確保する MLOps の実践を用いて、エンドツーエンドの ML システムを構築する方法を説明します。

主な原則

  • 複雑なアーキテクチャに頼る前に、シンプルなモデルと堅実な特徴量エンジニアリングで強力なベースラインを作成します。適切に調整されたロジスティック回帰は、設定が不適切なニューラルネットワークを上回ることがよくあります
  • 正解率だけでなく、ビジネス目標に合致する指標でモデルを評価します。適合率、再現率、F1、AUC-ROC はそれぞれ、不均衡データにおけるモデルの振る舞いを異なる観点から示します
  • データセット、コード、ハイパーパラメーター、モデルの成果物など、すべてをバージョン管理します。再現性は、信頼できる ML システムの基盤です
  • トレーニングパイプラインは、冪等で再開可能になるよう設計します。チェックポイント、決定論的なシード、設定ファイルによって、信頼性の高い実験が可能になります
  • 本番環境のモデルで、データドリフト、予測ドリフト、性能の低下を監視します。デプロイ時に高精度だったモデルも、入力の分布が変化すると、気付かないうちに性能が低下することがあります

テクニック

  • PyTorch のトレーニングは明確なパターンで構成します。nn.Module のサブクラスを定義し、適切な num_workers と pin_memory を設定した DataLoader を構成して、optimizer.zero_grad()、loss.backward()、optimizer.step() を使ったトレーニングループを実装します
  • Pipeline と ColumnTransformer を使って scikit-learn のパイプラインを構築し、前処理(スケーリング、エンコーディング、欠損値の補完)とモデルの学習を連結します。すべての変換はトレーニングデータのみで学習させます
  • 交差検証を使い、GridSearchCV または RandomizedSearchCV でハイパーパラメーターを調整します。計算コストの高いモデルでは、Optuna またはベイズ最適化を使って効率的に探索します
  • 保留したテストセットで評価指標を計算します。クラスごとの適合率/再現率/F1 には classification_report、ランキング品質には roc_auc_score、エラー分析には confusion_matrix を使います
  • 特徴量を体系的に設計します。偏った分布には対数変換、特徴量の組み合わせには交互作用項、高カーディナリティのカテゴリ変数にはターゲットエンコーディング、時系列データには時間特徴量を使います
  • MLflow または Weights and Biases で実験を追跡します。実行ごとにハイパーパラメーター、指標、成果物、モデルのバージョンを記録します

よくあるパターン

  • トレーニング・検証・テストの分割:クラス分布を維持するために層化分割(80/10/10)を使います。開発中にテストセットには決して触れず、最終評価にのみ使います
  • 学習率スケジュール:トレーニングを安定させるため、ウォームアップの後にコサインアニーリングまたは性能停滞時の学習率低減を使います。学習率が急激に大きくなると、ディープネットワークでは学習が発散します
  • アンサンブル手法:多様なモデル(勾配ブースティング+ニューラルネットワーク+線形モデル)の予測を組み合わせて、堅牢性を高め、分散を減らします
  • モデルレジストリ:承認ゲートと自動検証チェックを設け、MLflow Model Registry でモデルを各段階(ステージング、本番、アーカイブ)に昇格させます

避けるべき落とし穴

  • トレーニングセットで評価したり、テストデータを前処理に漏洩させたりしないでください。実際の性能を反映しない、過度に楽観的な指標につながります
  • データを理解せずにモデルをトレーニングしないでください。モデルを構築する前に、クラスの不均衡、欠損値、重複、ラベルノイズを確認します
  • ロールバック計画なしでモデルをデプロイしないでください。新しいモデルの性能が期待を下回った場合にすぐ戻せるよう、以前のモデルバージョンを本番環境で維持します
  • 特徴量エンジニアリングを一度きりの作業として扱わないでください。対象領域の変化や新しいデータソースの利用可能化に応じて、定期的に特徴量セットを見直し、拡張します

コメント