HOL Guard

HOL Guard は何をしますか？

HOL Guardは、ツール実行前にローカルのAIハーネスを保護します。このスキルは、ユーザーがAIアンチウイルス動作、ローカル承認レビュー、Codex保護、Claude Code保護、MCP安全性チェック、スキル/パッケージ検証、または hol-guard と plugin-scanner を使ったリリースゲートを求める場合に使用します。

ハードルール

• .env ファイルを絶対に読まないでください。
• Guard承認を絶対にバイパスしないでください。
• Guardコマンドがステータスを証明するまで、ワークスペースを保護済みとマークしないでください。
• 直接的なハーネス設定編集よりも、可逆的なGuardコマンドを優先してください。
• hol-guard コマンドがその変更を所有していない限り、ユーザーレベルのハーネス設定を変更しないでください。
• スキャナーエラーは、調査されるまで実際のエラーとして扱ってください。
• 既存のユーザー変更を保持し、リポジトリ内で編集する前に git status --short を確認してください。

インストール確認

両方のCLIを個別に確認します：

command -v hol-guard
command -v plugin-scanner

hol-guard が見つからず、ユーザーがランタイムセットアップを要求した場合は、次を優先：

pipx install hol-guard

plugin-scanner が見つからず、ユーザーがスキャンを要求した場合は、別のスキャナー配布パッケージをインストール：

pipx install plugin-scanner

hol-guard 配布パッケージが plugin-scanner コマンドを提供するとは想定しないでください。pipx が利用できない場合は、ユーザーのPython環境を静かに変更せずに、隔離されたCLIインストールを推奨することを説明してください。

ランタイムインストール後：

hol-guard status
hol-guard detect --json

ローカルハーネスを保護する

このフローをCodex、Claude Code、Copilot CLI、Cursor、Gemini、Hermes、OpenClaw、OpenCode、またはAntigravityに使用します。

hol-guard bootstrap
hol-guard install <harness>
hol-guard run <harness> --dry-run
hol-guard run <harness>
hol-guard status

ハーネス名：

• codex
• claude-code
• copilot
• cursor
• gemini
• hermes
• openclaw
• opencode
• antigravity

ハーネスエイリアス：

• claude は claude-code にマッピング
• gemini-cli は gemini にマッピング
• open-code は opencode にマッピング
• open-claw は openclaw にマッピング
• copilot-cli は copilot にマッピング

利用可能な場合はハーネス固有のブートストラップを使用：

hol-guard hermes bootstrap

Claude Code

ワークスペースに .claude/settings.local.json、.claude/agents、Claudeフック、.mcp.json、またはClaude管理のツール承認画面がある場合に使用します。

hol-guard install claude-code
hol-guard run claude-code --dry-run
hol-guard run claude-code
hol-guard doctor claude-code --json

Claude Codeは第一級のGuardターゲットです。Claude設定への直接的な手動編集よりも、Guardが所有するClaudeフックを優先してください。

Codex

ワークスペースにCodex設定、.codex/hooks.json、Codex MCPサーバー、またはCodex App/CLIツールフローがある場合に使用します。

hol-guard install codex
hol-guard run codex --dry-run
hol-guard run codex
hol-guard doctor codex --json

Codexは、利用可能な場合、Guardが所有する PreToolUse Bashフックおよび同一チャット内のMCP誘発をサポートします。

その他のハーネス

同じGuardフローを次に使用：

• Copilot CLI: hol-guard install copilot
• Cursor: hol-guard install cursor
• Gemini CLI: hol-guard install gemini
• Hermes: hol-guard hermes bootstrap
• OpenClaw: hol-guard install openclaw
• OpenCode: hol-guard install opencode
• Antigravity: hol-guard install antigravity

承認ワーク

Guardが作業をブロックまたはキューに入れた場合：

hol-guard approvals
hol-guard approvals open
hol-guard receipts
hol-guard diff <harness>

端末のみでの解決の場合：

hol-guard approvals approve <request-id>
hol-guard approvals deny <request-id>

リスク理由を読み、要求されたスコープを理解した後にのみ承認してください。

証跡ワーク

ユーザーが証明、監査証跡、または引き継ぎ用アーティファクトを必要とする場合に証跡コマンドを使用：

hol-guard receipts
hol-guard inventory
hol-guard abom --format json
hol-guard events
hol-guard explain <artifact-id>

クラウド同期については、オプションかつユーザー指示ベースで維持：

hol-guard connect
hol-guard connect status
hol-guard connect repair
hol-guard sync

プラグインまたはスキルパッケージのスキャン

Codexプラグイン、Claude Codeプロジェクト画面、.agents マーケットプレイス、スキル、MCPサーバー設定、リリースゲートにはスキャナーモードを使用します。

plugin-scanner lint .
plugin-scanner verify .

特定のパッケージをスキャンする場合：

plugin-scanner lint <path>
plugin-scanner verify <path>

ターゲットが .agents/plugins/marketplace.json を含むCodexマーケットプレイスルートの場合は、リポジトリルートをスキャンしてローカルプラグインエントリを検出できるようにします。

スキャナー対象ガイダンス：

• Codexプラグイン：.codex-plugin/plugin.json を含むリポジトリルートまたはプラグインフォルダをスキャン。
• Codexマーケットプレイス：.agents/plugins/marketplace.json を含むリポジトリルートをスキャン。
• Claude Codeプロジェクト：.claude/、.mcp.json、フック、またはエージェントフォルダを含むワークスペースルートをスキャン。
• MCPサーバーパッケージ：サーバー設定とパッケージメタデータを含むパッケージルートをスキャン。
• スキルパッケージ：SKILL.md を含むフォルダをスキャン。
• 混在エージェントワークスペース：ローカルプラグイン、スキル、MCP、ハーネス設定画面が一緒に検出されるよう、リポジトリルートをスキャン。

一般的なデバッグコマンド

hol-guard doctor
hol-guard doctor <harness> --json
hol-guard detect --json
hol-guard settings show
hol-guard explain install-connect
plugin-scanner verify . --json

応答パターン

Guardを使用する場合は、次を報告：

• 実行したコマンド。
• Guardが検出した内容。
• ブロックまたはリスクが残っている内容。
• 存在する証明。
• ユーザーが行動する必要がある場合の正確な次のコマンド。

コマンド出力で証明されていない限り、保護、承認、またはリリース準備完了を主張しないでください。