← 스킬 목록으로 돌아가기

output-schema-guard

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

当用户说『模型返回的JSON又崩了』『字段缺失对不上』『下游解析失败』『怎么强制LLM输出合规结构』,或要把 LLM 的 JSON/结构化输出接进代码(API/数据库/表单)时使用。把模型输出当『不可信外部输入』:用 schema 校验必填字段·类型·枚举,缺则给可执行的修复提示而非裸报错。理论根基:LGD 三律(有籍·有证·有门禁)。触发词:结构化输出、JSON校验、schema guard、输出格式、字段缺失、模型输出解析、function calling、tool output。

# 结构化输出 # schema校验 # JSON guard # function calling # 输出格式 # agent优化 # 可靠性

기본 정보

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

⚡ AGENT INFO USK v3

Capabilities
json schema validation
Permissions
✗ network
✗ filesystem
✗ subprocess
Interface
type: cli   entry_point: scripts/schema_guard.py   runtime: python3   call_pattern: args
Agent API
# 스킬 스키마 조회 (에이전트가 호출 방법을 파악) GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/schema # 플랫폼별 자동 변환 다운로드 GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=OpenClaw GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=ClaudeCode GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=ClaudeCodeAgentSkill GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=Cursor GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=GeminiCLI GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=CodexCLI GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=CustomAgent

설치 방법

호환 플랫폼: windows macos linux

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

요구사항

보안 검증 보고서

검증 결과 CAUTION

검사 결과: ["USK v3 경고: input_schema.type이 'object'가 아닙니다", "USK v3 경고: output_schema.type이 'object'가 아닙니다", 'USK v3 경고: 이 스킬은 자동 변환 조건을 충족하지 않아 manual_install로 처리됩니다']

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

AI 검수 단계

검수 주체 gemini 위험도 🟡 보통 검수 요약 스킬 메타데이터의 파일 시스템 접근 권한 선언이 실제 코드와 불일치합니다.

발견된 문제

  • 메타데이터의 `permissions.filesystem`이 `false`로 선언되었으나, 실제 코드(`scripts/schema_guard.py`)는 `pathlib.Path(...).read_text()`를 사용하여 스키마 파일과 입력 데이터 파일을 읽습니다.
  • 메타데이터의 `risk_rationale`에서 '读写文件'(파일 읽기/쓰기)를 언급하여 파일 시스템 접근 가능성을 시사하지만, `permissions.filesystem: false` 선언과 모순됩니다.
판단 근거

제출된 스킬 'output-schema-guard'의 Python 코드(`scripts/schema_guard.py`)를 분석한 결과, `argparse`를 통해 `--schema` 및 `--file` 인자로 전달된 경로의 파일을 `pathlib.Path(...).read_text()` 함수를 사용하여 읽는 기능이 명확하게 확인되었습니다. 이는 스킬 메타데이터에 `permissions.filesystem: false`로 명시된 선언과 직접적으로 충돌합니다. 스킬의 `risk_rationale`에서 '读写文件' (파일 읽기/쓰기)를 언급하며 'medium' 리스크를 자체 평가한 점은 개발자가 파일 시스템 접근이 있음을 인지하고 있었을 가능성을 시사하지만, `permissions` 필드에 정확하게 반영되지 않았습니다. 코드 자체는 JSON 스키마 유효성 검사라는 명확한 목적을 가지고 있으며, 악의적인 동작(데이터 탈취, 시스템 파괴, 외부 통신, 난독화 등)은 발견되지 않았습니다. 그러나 선언된 권한과 실제 동작 간의 불일치는 보안 검수에서 중요한 문제이며, 사용자에게 잘못된 정보를 제공할 수 있으므로 수정이 필요합니다. 따라서 'pending' 상태로 지정하여 개발자의 수정 또는 관리자의 추가 검토를 요청합니다.

버전 히스토리

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

리뷰 & 평점

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

✍️ 리뷰 작성