/aegisops-ai — 自律的ガバナンスオーケストレーター
AegisOps-AIは、プロフェッショナルグレードの「Living Pipeline」であり、高度なAI推論をSDLCに直接統合します。これは、システムレベルのセキュリティ、クラウドインフラコスト、Kubernetesコンプライアンスのためのインテリジェントなゲートキーパーとして機能します。
目標
以下の方法で、重要度の高いセキュリティおよび財務監査を自動化すること:
- Linuxカーネルパッチにおける論理ベースの脆弱性(UAF、Stale State)を特定する。
- Terraform計画における大規模な「サイレントディザスター」コストドリフトを検出する。
- 自然言語のセキュリティ意図を堅牢なK8sマニフェストに変換する。
使用すべき場合
- カーネルパッチレビュー: CベースのGit差分のメモリ安全性を監査する。
- 適用前IaC監査:
terraform planの出力を分析し、請求額の急上昇を防ぐ。 - クラスターの強化: デプロイメントのための「最小権限」securityContextを生成する。
- CI/CD品質ゲート: GitHub Actionsを介して非準拠のマージをブロックする。
使用すべきでない場合
- Webアプリロジック: 標準的なWeb脆弱性(XSS、SQLi)には使用せず、専用のSASTスキャナを使用すること。
- 非Cメモリ分析: パッチアナライザはCロジックに最適化されています。PythonやJSなどの高級言語には使用しないでください。
- 直接的なリソース変更: これは監査人であり、デプロイツールではありません。
terraform applyやkubectl applyは実行しません。 - 事後分析: 以前のAIセッションが失敗した理由を分析するには、代わりに
/analyze-projectを使用してください。
🤖 生成AI統合
AegisOps-AIは Google GenAI SDK を活用して、自律的なセキュリティおよび財務監査のための「推論経路」を実装しています:
- ニューラルパッチ分析: Linuxカーネルパッチのセマンティックコードレビューを実行し、単純なパターンマッチングを超えて複雑なメモリ状態ロジックを理解します。
- インテリジェントコスト合成: 生のTerraform計画差分を財務推論モデルを通して処理し、高リスクなリソースエスカレーションや「静かな」財政的ドリフトを検出します。
- 自然言語ポリシーマッピング: 人間のセキュリティ意図を、構文的に正しく堅牢化されたKubernetes
securityContext設定に変換します。
🧭 コアモジュール
1. 🐧 カーネルパッチレビューア (patch_analyzer.py)
- 問題: Linuxカーネルのメモリ安全性に関する手動レビューは時間がかかり、人為的ミスが発生しやすい。
- 解決策: Gemini 3が生のGit差分に対して「深層推論」監査を実行し、重大なメモリ破壊脆弱性(UAF、Stale State)を数秒で検出します。
- 主要出力:
analysis_results.json
2. 💰 FinOps & クラウド監査人 (cost_auditor.py)
- 問題: Infrastructure as Code(IaC)の変更は、偶発的な「サイレントディザスター」や大規模なクラウド請求額の急上昇につながる可能性がある。
- 解決策:
terraform planの出力を分析し、t3.microから高性能GPUインスタンスへの偶発的なアップグレードなどのコスト異常を検出します。 - 主要出力:
infrastructure_audit_report.json
3. ☸️ K8sポリシーハードナー (k8s_policy_generator.py)
- 問題: Kubernetesで「最小権限」セキュリティコンテキストを実装することは複雑で、しばしば軽視される。
- 解決策: 自然言語のセキュリティ要件を、本番環境対応の堅牢化されたYAMLマニフェスト(読み取り専用ルートFS、非root強制など)に変換します。
- 主要出力:
hardened_deployment.yaml
🛠️ セットアップと環境
1. リポジトリのクローン
git clone https://github.com/Champbreed/AegisOps-AI.git
cd AegisOps-AI
2. セットアップ
python3 -m venv venv
source venv/bin/activate
pip install google-genai python-dotenv
3. API設定
ルートディレクトリに .env ファイルを作成し、認証情報を安全に保存します:
echo "GEMINI_API_KEY='your_api_key_here'" > .env
🏁 運用ダッシュボード
すべてのエージェントを順に実行し、すべてのセキュリティレポートを生成するには:
python3 main.py
パターン: 過剰権限コンテナ
- 指標:
allowPrivilegeEscalation: trueまたはrootユーザーによる実行。 - 調査: セキュリティ意図(例:「非rootのみ」)をK8sハードナーモジュールに渡します。
💡 ベストプラクティス
- コンテキストが重要: Git差分の周囲に少なくとも5行のコンテキストを提供することで、より正確なニューラル推論が可能になります。
- 継続的なゲーティング: インフラストラクチャの変更前(後ではなく)に毎回FinOps監査人を実行します。
- 手動承認: AIの発見結果を高精度な信号として使用しますが、カーネルレベルのマージでは人間による確認を維持します。
🔒 セキュリティと安全性に関する注意事項
- キー管理: 本番環境ではCI/CDのシークレットを
GEMINI_API_KEYに使用します。 - 最小権限: まずステージング環境で「ハード化された」マニフェストをテストし、機能的な後退がないことを確認します。
リンク
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全性の境界、または成功基準が欠落している場合は、停止して明確化を求めてください。