初回実行ウィザードは、サポートされているエージェントを検出し、保護設定を順を追って案内します。ダッシュボードを開く、エージェント統合をインストールする、オプションのクラウドサービスに接続するなど、各設定変更の前に確認を求めます。

インストールを確認します:```bash
hol-guard --version
hol-guard status

手動セットアップについては、[インストールガイド](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/get-started.md)を参照してください。リリースの詳細とプレリリースは[リリースページ](https://github.com/hashgraph-online/hol-guard/releases)にあります。

## HOL Guard が保護するもの

| 対象領域 | 保護内容 |
| :--- | :--- |
| **シェルコマンドとファイルアクセス** | 破壊的な操作、機密ファイルへのアクセス、認証情報の漏洩、疑わしい外向きコマンドをレビューします。 |
| **パッケージインストール** | インストール前に、対応するパッケージマネージャー操作をサプライチェーンインテリジェンスと照合して評価します。 |
| **プラグイン、スキル、エージェント設定** | ローカルの成果物をインベントリ化し、起動前に新規または変更されたツールをレビューします。 |
| **MCP サーバーとツール** | サーバー設定を検査し、対応するフックとマネージドプロキシを通じてツール呼び出しをレビューします。 |
| **プロンプトとツール結果** | 対応するイベントをプロンプトインジェクションと機密コンテンツについてスクリーニングします。 |
| **承認と証跡** | ネイティブプロンプトまたは承認センターに判断をルーティングし、レビュー用にローカルのレシートを記録します。 |

Guard はネイティブエージェントフック、マネージド MCP プロキシ、起動統合を通じて接続します。カバレッジは各エージェントが公開するイベントに依存します。[サポートマトリックス](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/harness-support.md)には、統合ごとの強制適用、承認配信、障害時の動作が記載されています。

## 対応 AI エージェント

Codex、Claude Code、GitHub Copilot CLI、Cursor、Cline、Gemini CLI、Grok、Hermes、Kimi Code、Pi、oh-my-pi、OpenClaw、OpenCode、Antigravity、ZCode。[Paseo](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/paseo.md) はこれらのネイティブプロバイダー統合を通じてサポートされ、プロバイダーごとのカバレッジがあります。

例えば、Codex を明示的にセットアップするには:```bash
hol-guard install codex
hol-guard run codex --dry-run
hol-guard run codex

`command test` と `command explain` は、コマンドを実行したり承認を作成したりせずに検査します。保留中のリクエストを解決するには `hol-guard approvals` を使用し、記録された決定を確認するには `hol-guard receipts` を使用します。

[Extension directory](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/extensions/README.md) には、ランタイムレジストリから生成されたコマンドカバレッジが一覧表示されています。外部からのコントリビューションには明示的なオプトインが必要です。必須のコア保護は有効なままです。カバレッジを追加するには、[Extension contribution guide](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/extensions/contributing.md) に従ってください。

### パッケージをチェックする```bash
hol-guard supply-chain sync
hol-guard supply-chain scan
hol-guard supply-chain explain [email protected] --ecosystem npm

| コマンド | 目的 |
| :--- | :--- |
| `scan` | 検出されたパッケージサーフェス全体にわたるセキュリティ検出事項と品質レポート。 |
| `lint` | ルールレベルのオーサリングフィードバック。 |
| `verify` | インストールサーフェスとランタイムの準備状況チェック。 |
| `submit` | 1つのプラグインパッケージの提出用アーティファクト。 |
| `doctor` | コンポーネントの診断とトラブルシューティングバンドル。 |

スキャナーは Codex、Claude Code、DeepSeek Harness、Gemini CLI、Kimi Code、OpenCode のパッケージ形式を検出します。`plugin-scanner --list-ecosystems` で一覧表示するか、`--ecosystem` で1つを選択できます。Codex マーケットプレイスのルートでは、ローカルプラグインエントリを自動的に検出します。

チェックはマニフェスト、シークレット、MCP トランスポートとコマンド設定、承認デフォルト、スキル、依存関係ロックファイル、GitHub Actions の権限を対象とします。オプションの Cisco 統合により、スキルと MCP の分析が追加されます。レポートは text、JSON、Markdown、SARIF をサポートします。```bash
plugin-scanner scan . --format sarif --output plugin-scanner.sarif
plugin-scanner scan . --fail-on-severity high

[action documentation](https://github.com/hashgraph-online/ai-plugin-scanner-action) で SARIF アップロード、送信ワークフロー、機械可読出力について確認してください。アクションのソースは [`action/`](https://github.com/hashgraph-online/hol-guard/blob/main/action) で管理されています。

<a id="install-the-package-you-need"></a>
<a id="resolver-safe-cisco-extra"></a>

### オプションの Cisco 分析

ベースラインパッケージは Cisco 依存関係なしで動作します。Cisco スキルスキャンを追加するには、Python 3.11 から 3.14 を使用し、分離された環境に extra をインストールしてください:```bash
pipx install 'plugin-scanner[cisco]'

公開されている `cisco` extra はスキルスキャンを提供し、別個の `cisco-mcp` グループは MCP スキャナを提供します。依存関係のバージョンと Python の制約は [`pyproject.toml`](https://github.com/hashgraph-online/hol-guard/blob/main/pyproject.toml) で管理されています。

## エコシステムのサポート

| エコシステム | 検出対象 |
| :--- | :--- |
| Codex | `.codex-plugin/plugin.json`、`marketplace.json`、`.agents/plugins/marketplace.json` |
| Claude Code | `.claude-plugin/plugin.json`、`.claude-plugin/marketplace.json` |
| DeepSeek Harness | `dsh.bundle` を含む `package.json`、宣言されたパッチ、および Cordis の `apply(ctx)` エクスポート、またはパッチのみのバンドル向けに `dsh.bundle.mode` が `"patch"` に設定されているもの |
| Gemini CLI | `gemini-extension.json`、`commands/**/*.toml` |
| Kimi Code | `kimi.plugin.json`、`.kimi-plugin/plugin.json`、宣言されたスキル、エージェント、コマンド、プロンプト、および MCP サーバー |
| OpenCode | `opencode.json`、`opencode.jsonc`、`.opencode/commands`、`.opencode/plugins` |

リポジトリ内のサポート対象パッケージを検出するには `--ecosystem auto` を使用するか、エコシステムを明示的に選択してください:```bash
plugin-scanner scan ./plugins-repo --ecosystem claude
plugin-scanner scan ./dsh-plugin --ecosystem deepseek-harness

リポジトリマーケットプレイスでは、`scan`、`lint`、`verify`、`doctor` はルートを対象にできます。`submit` は1つのプラグインパッケージを対象にします。

## Codex 仕様との整合

スキャナーは Codex プラグインマニフェスト、インターフェースメタデータ、宣言されたアセット、マーケットプレイスパッケージを認識します：

- ローカルマニフェストパスは `./` プレフィックスを使用します。`lint --fix` はそれらを保持または追加します。
- `.agents/plugins/marketplace.json` が推奨されるマーケットプレイス位置であり、互換性のためにルートの `marketplace.json` もサポートされています。
- インターフェース検証は、文書化されていない `type` フィールドを要求せずに、宣言されたリンクとアセットをチェックします。
- `verify --online` は HTTP リモートの到達可能性をチェックします。Stdio サーバーの実行は手動レビューのためにスキップされます。

上流のフォーマットについては、[Codex プラグインドキュメント](https://developers.openai.com/codex/plugins) と [Model Context Protocol 仕様](https://modelcontextprotocol.io) を参照してください。

## 設定 + ベースラインの例

スキャナーを `.plugin-scanner.toml` で設定します：```toml
[scanner]
profile = "public-marketplace"
baseline_file = "baseline.txt"
ignore_paths = ["tests/*", "fixtures/*"]

[rules]
disabled = ["README_MISSING"]
severity_overrides = { CODEXIGNORE_MISSING = "low" }

出力ディレクトリは新規である必要があり、親ディレクトリは既に存在している必要があります。キットには `discovery.json`、`review.json`、`report.json`、コントリビューションメタデータ、ネイティブ検出器、生成されたテスト、およびファイルマニフェストが含まれます。

その他の入力: `--from help` は保存されたコマンドヘルプを読み取ります。`--from click` は Click の `Context.to_info_dict()` エクスポートを読み取ります。`--from oclif` は `oclif.manifest.json` を読み取ります。`--from mcp` は完全にエクスポートされた `tools/list` の結果を読み取ります。そして `--from snapshot` は `discovery.json` を再生します。上記の `cli` の例では、正規化された `guard.cli-surface.v1` JSON を使用しています。

MCP コントリビューションの場合、ジェネレーターは `--executable` の代わりに `--launcher` と `--package` を使用します。完全なコマンドとページネーションの要件については、[MCP キットの例](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/extension-builder/README.md#generate-an-mcp-kit)を参照してください。

**3. 操作をレビューして再生成します。** `report.json` を読み、検出された操作をアップストリームの実装と比較します。編集する前にレビューファイルをコピーしてください:```bash
cp samplectl-kit/review.json samplectl-review.json

`diff` は等しいキットに対して `0` を、有効なキットが異なる場合に `1` を返します。上流のエクスポートが変更された場合は、新しいスナップショットを生成してレビューしてください。

**4. 統合をプレビューして適用します。** コントリビューションブランチで、現在のチェックアウトへの変更をプレビューします:```bash
uv run --no-sync hol-guard extensions apply samplectl-reviewed --repo .

書き込みは、レビュー済みの計画をコントリビューションファイル、外部トラストマップ、カタログ登録、パッケージング、およびオーサリング所有権レコードに適用します。既存の ID または競合するファイルは、レビューのために統合を停止します。

**5. テストしてプルリクエストを送信します。** `samplectl` の例では:```bash
uv run --no-sync python scripts/release/stage_guard_cloud_review_artifacts.py
uv run --no-sync pytest -q tests/test_generated_cli_samplectl_extension.py
uv run --no-sync pytest -q \
  tests/test_guard_extension_contribution.py \
  tests/test_guard_extension_trust.py \
  tests/test_guard_command_extension_registry.py
uv run --no-sync python scripts/render_command_extension_directory.py
uv run --no-sync python scripts/render_command_extension_directory.py --check
git diff --check

オプションの Cisco カバレッジを利用するには、上記の依存関係グループコマンドを使用してください。コントリビューション要件については [CONTRIBUTING.md](https://github.com/hashgraph-online/hol-guard/blob/main/CONTRIBUTING.md) を、統合テストについては [testing matrix](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/testing-matrix.md) を参照してください。

## リソース

- [HOL Plugin Registry](https://hol.org/registry/plugins)
- [HOL Plugin Security dataset on Hugging Face](https://huggingface.co/datasets/HashgraphOnline/hol-plugin-security)
- [HOL Standards Documentation](https://hol.org/docs/standards)
- [OpenAI Codex Plugin Documentation](https://developers.openai.com/codex/plugins)
- [Model Context Protocol Documentation](https://modelcontextprotocol.io)
- [Cisco AI Skill Scanner](https://pypi.org/project/cisco-ai-skill-scanner/)
- [Cisco AI MCP Scanner](https://pypi.org/project/cisco-ai-mcp-scanner/)
- [HOL GitHub Organization](https://github.com/hashgraph-online)

## コミュニティ

[Hashgraph Online](https://github.com/hashgraph-online) によってメンテナンスされています。

- [バグの報告または機能リクエスト](https://github.com/hashgraph-online/hol-guard/issues)
- [リリースを閲覧](https://github.com/hashgraph-online/hol-guard/releases)
- [プラグインセキュリティデータセットを探索](https://huggingface.co/datasets/HashgraphOnline/hol-plugin-security)

## ライセンス

[Apache-2.0](https://github.com/hashgraph-online/hol-guard/blob/main/LICENSE) の下でライセンスされています。