system-integration-validator
배포 전 시스템 통합 검증
통합 실패는 배포 지연과 프로덕션 인시던트를 야기합니다. 이 스킬은 포트, 데이터베이스, API 및 데이터 흐름에 대한 단계별 검증을 제공하여 문제를 조기에 발견합니다.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "system-integration-validator". 배포 전 내 시스템 통합을 검증해줘
النتيجة المتوقعة:
- 포트 확인: 필요한 모든 포트(3000, 3001, 5432, 6379, 8080)가 비어있음
- 데이터베이스: PostgreSQL 및 Redis 연결 확인됨
- API 계약: 프론트엔드 엔드포인트가 백엔드 정의와 일치
- 데이터 흐름: 데드 엔드나 순환 종속성 감지되지 않음
- 배포 준비 완료
استخدام "system-integration-validator". PostgreSQL용 포트 5432가 사용 가능한지 확인해줘
النتيجة المتوقعة:
- 실행: lsof -i :5432
- 점유 시: 'sudo lsof -i :5432'로 프로세스 식별
- 포트 해제: 충돌 프로세스 중지 또는 PostgreSQL을 다른 포트 사용으로 구성
- 확인: lsof -i :5432가 아무 출력 없이 반환되어야 함
استخدام "system-integration-validator". 내 API 요청이 멈추는 이유를 디버깅해줘
النتيجة المتوقعة:
- 포트 가용성 확인: 포트 3000, 3001이 차단되거나 사용 중일 수 있음
- 데이터베이스 연결 테스트: pg_isready 및 redis-cli ping
- 제한시간 추가: fetch 호출에 5초 제한으로 AbortController 사용
- 데이터 흐름 검토: 순환 종속성이나 데드 엔드 찾기
التدقيق الأمني
آمنPure documentation-only skill providing validation guidance. No executable code, network operations, file access, or external commands. Static findings are false positives from misidentified documentation patterns and JSON field names.
عوامل الخطر
🌐 الوصول إلى الشبكة (3)
📁 الوصول إلى نظام الملفات (2)
⚙️ الأوامر الخارجية (5)
درجة الجودة
ماذا يمكنك بناءه
배포 전 검증
스테이징 또는 프로덕션 환경에 배포하기 전에 포트, 데이터베이스 및 API 검사를 실행합니다.
멈춘 워크플로 디버깅
워크플로가 멈추거나 조용히 실패하는 원인이 되는 순환 종속성과 데이터 흐름 문제를 식별합니다.
API 계약 검증
프론트엔드와 백엔드 API 엔드포인트가 일치하여 통합 버그를 방지합니다.
جرّب هذه الموجهات
로컬 머신에서 포트 3000, 3001, 5432, 6379, 8080이 사용 가능한지 확인해줘.
localhost에서 PostgreSQL 및 Redis 연결이 작동하는지 확인해줘. 각각을 테스트하는 명령어를 보여줘.
내 프론트엔드 API 호출이 백엔드 엔드포인트와 일치하는지 검증하는 걸 도와줘. 무엇을 확인해야 할까?
데이터 흐름에서 데드 엔드, 고아 입력, 병목 지점 및 순환 종속성을 분석해줘.
أفضل الممارسات
- 서비스 시작 전 포트 확인을 실행하여 충돌 방지
- 소켓 테스트만 말고 실제 쿼리 또는 ping 명령어로 데이터베이스 연결 테스트
- 모든 네트워크 작업에 제한시간을 설정하여 멈춤 방지
تجنب
- 포트 확인을 건너뛰고 배포 시점에 충돌 발견
- 데이터베이스 연결 성공이 데이터베이스가 완전히 기능한다는 의미라고 가정
- 사용자가 손상된 워크플로를 보고할 때까지 데이터 흐름 문제 무시