← 스킬 목록으로 돌아가기

agent-loop-guard

v1.0.0 official 6일 전
USK v3 ✅ Verified
⬇ 다운로드
설치 가이드↓
🤖 에이전트용 설치 명령 (curl / MCP / Claude Desktop)
▸ curl 한 줄 다운로드
curl -L -o agent-loop-guard.skill   "https://aiskillstore.io/v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=ClaudeCode"
▸ MCP 도구 호출 (Skill Store MCP 등록 시)
{
  "tool": "download_skill",
  "arguments": {
    "skill_id": "fc3882cd-507c-467d-9828-f639f0879e61",
    "platform": "ClaudeCode"
  }
}
▸ Claude Desktop / Cursor MCP 설정 (1회)
{
  "mcpServers": {
    "skill-store": {
      "url": "https://aiskillstore.io/mcp/"
    }
  }
}
📖 에이전트용 전체 API 가이드: /llms.txt  ·  MCP server card

当用户说『agent卡死了』『一直在重复同样动作』『跑飞了烧光token』『怎么给agent设步数上限』,或 agent 出现无限循环/重复调用/原地打转时使用。把 agent 的运行当『受控进程』:监控步数上限·重复动作·状态无进展,触发即熔断并产出诊断。理论根基:LGD 三律(有籍·有证·有门禁)。触发词:agent卡死、无限循环、重复动作、跑飞、步数上限、loop guard、token烧光、失控循环。

# 失控循环 # loop guard # 步数上限 # agent监控 # token控制 # 熔断 # 可靠性 # AI工程

기본 정보

소유자 👤 Steven Zhao 카테고리 — 등록일 2026-10-16 최종 업데이트 2026-10-17 최신 버전 1.0.0 패키지 날짜 2026-10-17 검증 상태 official 다운로드 수 0회 체크섬 (SHA256) 590d13c0bcd547fac78673ad39bdb3d259564f1ae1ba932adf5e0c13845320f7

⚡ AGENT INFO USK v3

Capabilities
loop_detection trace_analysis safety
Permissions
✗ network
✗ filesystem
✗ subprocess
Interface
type: cli   entry_point: scripts/loop_guard.py   runtime: python3   call_pattern: args
Agent API
# 스킬 스키마 조회 (에이전트가 호출 방법을 파악) GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/schema # 플랫폼별 자동 변환 다운로드 GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=OpenClaw GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=ClaudeCode GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=ClaudeCodeAgentSkill GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=Cursor GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=GeminiCLI GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=CodexCLI GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=CustomAgent

설치 방법

1
openclaw_skill_manager.py로 스킬을 설치합니다.
python openclaw_skill_manager.py --install agent-loop-guard
2
설치 확인
python openclaw_skill_manager.py --list-installed
3
특정 버전 설치 (선택)
python openclaw_skill_manager.py --install agent-loop-guard --version 1.0.0
1
스킬 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/skills/fc3882cd-507c-467d-9828-f639f0879e61/download
2
Claude Code commands 디렉터리에 배치합니다.
unzip agent-loop-guard.skill -d ~/.claude/commands/agent-loop-guard/
3
Claude Code에서 슬래시 커맨드로 사용합니다.
/agent-loop-guard
1
Agent Skills 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=ClaudeCodeAgentSkill
2
Claude Code skills 디렉터리에 압축을 해제합니다.
unzip agent-loop-guard-agent-skill-*.skill -d ~/.claude/skills/agent-loop-guard/
3
Claude Code를 재시작하면 세션 시작 시 자동으로 로드됩니다. 슬래시 커맨드 없이 자연어로 사용 가능합니다.
1
Cursor 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=Cursor
2
압축 해제 후 영구 위치에 저장합니다.
unzip agent-loop-guard-cursor-*.skill -d ~/.cursor/skills/agent-loop-guard/
3
.cursor/mcp.json에 MCP 서버 설정을 추가하고 Cursor를 재시작합니다.
cat ~/.cursor/skills/agent-loop-guard/cursor_mcp_config.json
1
Gemini CLI 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=GeminiCLI
2
압축 해제 후 영구 위치에 저장합니다.
unzip agent-loop-guard-geminicli-*.skill -d ~/.gemini/skills/agent-loop-guard/
3
~/.gemini/settings.json에 MCP 서버 설정을 추가하고 Gemini CLI를 재시작합니다.
cat ~/.gemini/skills/agent-loop-guard/gemini_settings_snippet.json
1
Codex CLI 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=CodexCLI
2
압축 해제 후 영구 위치에 저장합니다.
unzip agent-loop-guard-codexcli-*.skill -d ~/.codex/skills/agent-loop-guard/
3
~/.codex/config.toml에 MCP 서버 설정을 추가하고 Codex CLI를 재시작합니다.
cat ~/.codex/skills/agent-loop-guard/codex_config_snippet.toml
1
REST API로 스킬 패키지를 다운로드합니다.
GET https://aiskillstore.io/v1/skills/fc3882cd-507c-467d-9828-f639f0879e61/download
2
에이전트 플랫폼의 skills 디렉터리에 배치합니다.
cp agent-loop-guard.skill ./skills/
3
설치 가이드 API로 플랫폼별 상세 정보를 조회합니다.
GET https://aiskillstore.io/v1/skills/fc3882cd-507c-467d-9828-f639f0879e61/install-guide?platform=CustomAgent

요구사항

보안 검증 보고서

검증 결과 CAUTION

검사 결과: ["메타데이터 경고: 권장 필드 없음: 'platform_compatibility' (SKILL.md v2 권장)", "USK v3 경고: input_schema.type이 'object'가 아닙니다", "USK v3 경고: output_schema.type이 'object'가 아닙니다", 'USK v3 경고: 이 스킬은 자동 변환 조건을 충족하지 않아 manual_install로 처리됩니다']

✅ 보안 위험 항목이 발견되지 않았습니다.

AI 검수 단계

검수 주체 gemini 위험도 🟡 보통 검수 요약 스킬이 파일 시스템 접근 권한이 없다고 선언했으나, 실제 코드에서 파일 읽기 작업을 수행하며 입력 스키마 설명과도 불일치합니다.

발견된 문제

  • **권한 불일치 (Permission Mismatch):** 메타데이터의 `permissions.filesystem`이 `false`로 선언되었으나, `scripts/loop_guard.py` 코드에서 `pathlib.Path(p).read_text()`를 사용하여 파일 시스템에서 파일을 읽습니다. 이는 선언된 권한과 실제 동작이 일치하지 않습니다.
  • **입력 스키마 불일치 (Input Schema Discrepancy):** `input_schema.trace`는 '실행 궤적 텍스트 (인라인)'로 설명되어 있어 궤적 내용 자체가 입력으로 전달될 것으로 예상되지만, 실제 코드(`parse_trace` 함수)는 이 인자를 파일 경로로 해석하여 파일을 읽습니다. 이로 인해 사용자가 임의의 파일 경로를 입력할 경우, 에이전트가 접근 가능한 시스템 파일을 읽을 수 있는 잠재적인 '임의 파일 읽기(Arbitrary File Read)' 취약점이 발생할 수 있습니다.
판단 근거

스킬의 목적(에이전트 루프 감지)은 유용하고 코드 자체에 명백한 악의적인 의도는 보이지 않습니다. 또한, 네트워크 통신이나 서브프로세스 실행은 선언된 대로 이루어지지 않습니다. 그러나 `filesystem: false`로 명시적으로 선언했음에도 불구하고 파일 시스템에서 파일을 읽는 동작은 보안 정책 위반입니다. 특히, 입력 스키마 설명과 코드의 동작 방식이 달라, 사용자가 파일 경로를 입력할 경우 에이전트가 접근 가능한 임의의 파일을 읽을 수 있는 정보 유출 위험이 있습니다. 이는 'medium' 수준의 보안 위험으로 판단되며, 개발자의 수정 및 재검토가 필요합니다. 개발자는 코드를 수정하여 인라인 텍스트를 직접 처리하거나, 파일 시스템 접근 권한을 `true`로 변경하고 이에 대한 명확한 설명과 위험 완화 방안을 제시해야 합니다.

버전 히스토리

버전 USK v3 검증 상태 패키지 날짜 다운로드 변경사항
v1.0.0 ✓ official 2026-10-17 ⬇ 0 1.0.0: initial upload (USK v3)
v1.0.0 — approved 2026-10-16 ⬇ 0 —

리뷰 & 평점

아직 리뷰가 없습니다. 첫 번째 리뷰를 남겨보세요!

✍️ 리뷰 작성