mcpField
H
harness-oia-audit

harness-oia-audit

github.com/ruvnetセキュリティ80.0k236 回インストール今日更新
リポジトリ

harness-oia-audit について

harness-oia-auditは、MetaHarness環境向けのセキュリティ監査スキルです。アーキテクチャ整合性、脅威モデル、MCPスキャンをまとめ、記録を保存して経時的な変化を確認できます。

主な機能

  1. 013種類の静的監査の実行
  2. 02最も高い重大度の算出
  3. 03比較用監査記録の保存
  4. 04重大度に応じたアラート
  5. 05コンポーネント不在時の縮退動作

活用シーン

  1. 01週次CIジョブでのセキュリティ監査
  2. 02監査結果の比較による変化の検出
  3. 03重大度の高い検出時のCI停止

MCP 対応

MCPサーフェスの脅威モデルを実行し、サーバーとツールごとのポリシー、権限、依存関係をスキャンして結果を統合します。

インストール

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

$npx skills add https://github.com/ruvnet/ruflo --skill harness-oia-audit

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

詳細

第 13 のワーカー（ADR-150 フェーズ 2）— 3 つの MetaHarness 静的サーフェスを一度に実行し、複合的な最悪重大度シグナルを算出して、監査記録をメモリに保存することで、時間の経過に伴うドリフトを確認できるようにします。

アルゴリズム

実装：scripts/oia-audit.mjs。

  1. harness oia-manifest <path> を実行します — Open Infrastructure Architecture レイヤーの整合性（L1-L9）。
  2. harness threat-model <path> を実行します — worst: clean|low|medium|high を含む、MCP サーフェスの脅威レポートをカテゴリ別に生成します。
  3. harness mcp-scan <path> を実行します — サーバー／ツールごとのポリシー、権限、依存関係に関する検出結果を出力します。
  4. 複合的な最悪重大度 = max(threatModel.worst, max(mcpScan.findings.severity))。
  5. ペイロードをメモリの名前空間 metaharness-audit にキー audit-<iso-timestamp> で保存します（--dry-run の場合を除く）。
  6. --alert-on-worst <severity>：複合的な最悪重大度がしきい値以上の場合、終了コード 1 で終了します。

グレースフルデグラデーション

3 つのコンポーネントすべてが metaharness-not-available を報告した場合、スクリプトは標準の縮退ペイロードを出力し、終了コード 0 で終了します。一部のコンポーネントのみが縮退している場合、監査記録では各コンポーネントにそれぞれ degraded: true フラグが付きます。監査は引き続き実行され、収集できた情報が保存されます。

CI／cron との連携

.github/workflows/ での週次 cron を想定しています。

on:
  schedule:
    - cron: '17 4 * * 0'  # Sundays at 04:17 UTC
jobs:
  oia-audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
      - run: node plugins/ruflo-metaharness/scripts/oia-audit.mjs --alert-on-worst high

--alert-on-worst high を指定すると、重大度 HIGH の検出結果がある場合にジョブが失敗します。HIGH 未満のドリフトは記録されますが、処理はブロックされません。

メモリの名前空間

各監査実行の結果は metaharness-audit:audit-<iso-ts> に保存されます。最近の監査を一覧表示するには、次のコマンドを実行します。

npx @claude-flow/cli@latest memory list --namespace metaharness-audit --limit 10

2 つの監査を比較する（ドリフトを検出する）には、次のコマンドを実行します。

A=$(npx ... memory retrieve --key audit-2026-06-01... --namespace metaharness-audit)
B=$(npx ... memory retrieve --key audit-2026-06-15... --namespace metaharness-audit)
# Compare composite.worst, components.threatModel.worst, etc.

今後の ADR で、監査ドリフト専用の cost-diff のような差分ビューアーに連携できる可能性があります。

関連項目

  • harness-threat-model — 基盤となる脅威モデルコンポーネント
  • harness-mcp-scan — 基盤となる MCP スキャンコンポーネント
  • harness-score + harness-genome — 準備状況の指標（監査とは直交するもの）

コメント

Markdown 対応