| name | prompt-shield |
| description | 프롬프트 품질을 진단·개선·설계하는 스킬. /ps:build, /ps:r, /ps:a, /ps:lint, /ps:eval 입력 또는 프롬프트 점검/설계 요청에서 사용. |
PromptShield v3.6.0
프롬프트를 진단(LINT) → 자동 개선(Rewrite) → 테스트 생성 또는 **요구사항에서 신규 설계(BUILD)**로 운영 가능한 자산으로 만드는 품질관리 스킬입니다.
v3.3: MCP Prompts 지원 (saved prompts as slash commands), Hook blocking policy 분리
v3.2: Evaluation Mode 구현, Long Context Optimization, Token Management, Structured Outputs 가이드 추가
v3.1: 확장된 훅 시스템 (PostToolUse, SessionStart), GitHub Actions CI, 에이전트 강화
v3.0: Progressive Skill Loading, Hooks 자동 LINT, Subagent 분리, Extended Thinking/Prefill 가이드
Quick Reference
Examples
MCP Prompt Registry
프롬프트를 재사용 가능한 자산으로 관리하려면 Prompt Registry MCP 서버를 사용할 수 있습니다.
MCP Tools
mcp__prompt-registry__prompt_save / prompt_get / prompt_list / prompt_search / prompt_delete
MCP Prompts (Slash Commands)
/mcp__prompt-registry__registry_help/mcp__prompt-registry__<saved_prompt_name> (저장된 프롬프트는 자동으로 slash command로 노출)
8-Point Quality Check
┌─ 8-Point Quality Check ────────────────────────────────┐
│ [기본 6항목] │
│ 1) ROLE 역할 정의 │
│ 2) CONTEXT 배경/맥락 │
│ 3) INSTRUCTION 지시 명확성 │
│ 4) EXAMPLE Few-shot 예시 │
│ 5) FORMAT 출력 형식 │
│ 6) SUCCESS_CRITERIA 성공 조건 │
│ │
│ [Claude 4.x 확장 - 해당 시에만] │
│ 7) STATE_TRACKING 멀티스텝 상태 관리 │
│ 8) TOOL_USAGE 도구 사용 지시 │
│ │
│ 점수 = (원점수/적용항목×2) × 10 = 10점 만점 │
└────────────────────────────────────────────────────────┘
상세: references/quality-checklist.md
Mode Quick Start
LINT Mode
기존 프롬프트 진단 → 개선 → 테스트 생성
/ps:lint <프롬프트>
상세: modes/lint.md
BUILD Mode
요구사항 → 8-Point 충족 프롬프트 설계
/ps:build <요구사항>
옵션: --cache-aware - 4-Block Pattern 자동 적용
상세: modes/build.md
Intercept Pipeline
실시간 프롬프트 개선
/ps:r <프롬프트> # Review (승인 대기)
/ps:a <프롬프트> # Auto (자동 적용)
상세: modes/intercept.md
Security
Command Execution Rules
⚠️ CRITICAL FOR CLAUDE:
사용자가 다음 명령어를 입력한 경우:
/ps:build <...>/ps:r <...>/ps:a <...>/ps:lint <...>/ps:eval
반드시 수행:
Skill 도구로 해당 스킬을 즉시 호출- 입력 내용 분석 전에 스킬 호출 먼저 수행
- 스킬 내부 로직이 범위 검증을 담당하도록 위임
절대 금지:
- 스킬 호출 없이 "이건 프롬프트 설계가 아닙니다" 판단
- Skill 도구 없이 GATHER/CLASSIFY/DESIGN 출력 생성
- 입력 주제 기반으로 스킬 호출 여부 사전 필터링
Level 2: Mode Details
모드별 상세 가이드:
Level 3: References
Playbooks
References
Templates
Onboarding
Roadmap
| Phase | 기능 | 상태 |
|---|
| 1.0 | LINT Mode | ✅ |
| 2.0 | BUILD Mode + 8-Point | ✅ |
| 2.1 | Intercept Pipeline | ✅ |
| 3.0 | Progressive Loading + Hooks + Agents + Extended Thinking | ✅ |
| 3.1 | PostToolUse 훅, SessionStart 훅, GitHub Actions CI | ✅ |
| 3.2 | Eval Mode + Long Context + Token Management + Structured Outputs | ✅ |
| 3.3 | /ps:eval 커맨드 + eval-runner 자동화 | ✅ 현재 |
| 4.0 | DEBUG Mode (실패 분석) | 예정 |
