Community코딩 & 개발github.com

avivgerz-hue/vibe-shield

애플리케이션, API, 데이터, AI 에이전트 및 MCP 구성을 변경할 때 여섯 단계의 방어적 보안 검토를 적용합니다. 정적 증거를 사용하고, 동작을 보존하며, 한계를 보고합니다.

vibe-shield란 무엇인가요?

이 스킬은 코드 변경 사항에 대해 체계적인 6단계 방어적 보안 검토를 수행하는 AI 에이전트(예: Claude Code, Cursor, Codex)를 위한 프로토콜입니다. 공격 표면 정찰, 자동화된 정적 스캔 및 스킬 감사, 심층 컨텍스트 위협 모델링, 무결점 회귀 방지 수정, 검증 게이트, 그리고 경영진 보안 승인 단계로 구성됩니다. `@vibefoundry/vibe-shield` npm 패키지를 사용하여 정적 분석을 실행하며, 발견된 취약점을 행동 가능한 증거로 제시하고, 보고서에서 발견되지 않은 항목이나 한계를 정직하게 보고하도록 요구합니다. 이 스킬은 Next.js, Supabase, 일반적인 API 및 AI 에이전트 설정을 포함한 다양한 프로젝트 유형을 지원하며, 코드와 구성을 변경하지 않고 보안 검토를 강화하는 데 중점을 둡니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/avivgerz-hue/vibe-shield/tree/HEAD/.claude/skills/vibe-shield

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

방어적 AppSec 아키텍트 프로토콜

승인된 프로젝트 내에서만 작업하세요. 정적 발견은 검토를 위한 증거일 뿐, 악용 가능성 또는 안전 보장의 증거가 아닙니다. 소스 코드나 비밀을 전송하지 마세요. 프로덕션 서비스를 변경하거나, 자격 증명을 교체하거나, 파괴적인 변경을 하기 전에 문의하세요.

1단계: 공격 표면 정찰

진입점과 신뢰 경계를 매핑합니다: API 메서드, 인증 및 권한 부여, 미들웨어 매처, 데이터베이스 테이블 및 정책, 스토리지, LLM 입력 및 도구, 웹훅, 에이전트/MCP 구성. 배포 구성 및 제외 항목을 확인합니다. 스캐너가 볼 수 없는 것을 식별합니다.

2단계: 자동화된 정적 스캔 및 스킬 감사

npx -y @vibefoundry/vibe-shield scan . --format json
npx -y @vibefoundry/vibe-shield audit-skills . --format json

발견 항목, 인벤토리, 무시된 경로 및 스캔된 파일을 검사합니다. 명시적인 .는 테스트 및 문서 파일을 포함합니다: 픽스처를 맹목적으로 변경하지 말고 예제로 검토하세요. explain <RULE_ID>를 사용하여 규칙을 조사합니다. 이 명령어는 로컬에서 실행됩니다. npx를 통한 첫 설치에는 레지스트리 액세스가 필요합니다.

3단계: 심층 컨텍스트 위협 모델링

신뢰할 수 없는 입력을 인증, 소유권 검사 및 테넌트 경계를 통해 데이터베이스, 파일 시스템, 네트워크, HTML 및 LLM 싱크로 추적합니다. IDOR, 비즈니스 로직 우회, 웹훅 서명 확인 및 비동기 작업을 검사합니다. 교차 파일 가드 및 배포된 데이터베이스 정책을 확인합니다. 정적 발견이 없다고 해서 보호가 보장되는 것은 아닙니다.

4단계: 정밀 무결점 회귀 방지 수정

  • Next.js 변이 라우트에서 서버 측 세션을 인증하고 쓰기 전에 세션 주체에 대해 대상 리소스를 권한 부여합니다. 요청 본문의 ID를 신뢰하지 마세요.
  • Supabase RLS를 활성화하고 인증된 주체를 사용하여 작업별 정책을 작성합니다. 마이그레이션을 배포하기 전에 허용된 테넌트와 거부된 테넌트를 모두 테스트합니다.
  • Zod와 같은 스키마로 경계에서 입력을 검증한 다음 매개변수화된 데이터베이스 쿼리를 사용합니다. LLM 출력을 신뢰할 수 없는 것으로 취급합니다.
  • 명시적인 CORS 허용 목록, 보안 쿠키 플래그 및 애플리케이션에 적합한 CSP를 사용합니다. 로그인, 리디렉션 및 브라우저 동작을 테스트합니다.
  • 노출된 자격 증명을 소유자에게 보고하여 공급자 측에서 교체하도록 합니다. 보고서에 해당 값을 재현하지 마세요. 더 높은 점수를 얻기 위해 발견 사항을 숨기거나 제어를 약화시키지 마세요. 누락된 비즈니스 또는 배포 결정에 대해 문의하세요.

5단계: 검증 게이트

프로젝트 테스트와 두 감사를 다시 실행하세요. 높음 또는 심각한 발견 사항 없이 100/100 A+ 등급을 목표로 하지만, 해결되지 않은 발견 사항, 제외 사항, 오탐 또는 검증 한계를 성공이라고 주장하지 말고 정직하게 보고하세요. 깨끗한 점수를 완전한 보안 평가와 동일시하지 마세요.

npx -y @vibefoundry/vibe-shield scan --fail-on high
npx -y @vibefoundry/vibe-shield audit-skills --fail-on high

6단계: 경영진 보안 승인

범위, 인벤토리, 심각도별로 우선순위가 지정된 위험, 증거, 조치, 테스트 결과 및 남은 불확실성을 포함한 Markdown 또는 HTML 보고서를 생성합니다. 예시 코드는 프로젝트별 패치가 아닙니다. 검토하고 적용하세요. 배포 또는 공급자 측 작업 전에 사람의 승인을 받으세요.

npx -y @vibefoundry/vibe-shield scan --report SECURITY-REPORT.md --patch-prompt PATCH-PROMPT.md
npx -y @vibefoundry/vibe-shield audit-skills --report AGENT-REPORT.html

관련 스킬