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 앱/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가 무엇을 발견했는지.
• 여전히 차단되거나 위험한 것은 무엇인지.
• 어떤 증거가 존재하는지.
• 사용자가 조치를 취해야 하는 경우 정확한 다음 명령어.

명령어 출력이 증명하지 않고 보호, 승인, 또는 릴리스 준비 상태를 주장하지 마십시오.