네트워크 장애 디버깅 방법론

무엇을 해주나

• ECONNRESET, HTTP/2 RST_STREAM, SSE 스트림 중단, 'N초 후 항상 끊김', CDN/프록시/CGNAT 유휴 타임아웃, 인증서 검증 오류 같은 증상이 나오면 Claude가 추측 대신 증거 → 반증 → 결정적 실험 순서로 조사하도록 강제합니다.
• 8단계 워크플로 체크리스트(범위 확정 → 전제 검증 → 홉별 증거 수집 → 가설 3개+반증 조건 → 계층 격리 실험 → 계측 추가 → 반대 검토 → 수정·재검증 → 오답 기록)를 제공합니다.
• Cloudflare 524/522가 '백엔드 느림'이 아니라 본문 업로드 시간 초과인지 판별하는 로그 필드 해석표(duration, bytes_read, Content-Length, status=0)를 담고 있습니다.
• 프록시/VPN/TUN 오라우팅, CNAME 규칙 오버라이드, LAN 기기 식별 실수 등 15가지 인지 함정 목록으로 흔한 오진을 미리 차단합니다.

이런 분께 추천

• 프로덕션 장애를 직접 파고드는 백엔드 개발자, SRE·인프라 엔지니어
• CDN → 리버스 프록시 → 앱 → 업스트림처럼 홉이 여러 개인 스택을 운영하는 팀
• 스트리밍(SSE/롱폴링) API나 대용량 POST 업로드 엔드포인트를 다루는 분
• 장애 회고 문서를 체계적으로 남기고 싶은 팀 리드

활용 예시

1. "SSE 응답이 매번 정확히 130초에 끊긴다" → Claude가 CDN 경유 / 오리진 IP 직접(--resolve) / 서버 루프백 3경로 비교 실험을 설계해 어느 홉의 유휴 타임아웃인지 특정.
2. "6MB 요청에서 Cloudflare 524 발생" → Caddy 액세스 로그의 bytes_read가 Content-Length보다 작고 status=0인지 확인해 백엔드가 아닌 업로드 타임아웃임을 증명.
3. "이 사이트만 브라우저에서 ERR_CONNECTION_CLOSED" → DNS가 198.18.x.x 같은 가짜 IP를 반환하는지, CNAME 접미사 DIRECT 규칙이 명시적 PROXY 규칙을 덮어쓰는지 순서대로 검증.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/debugging-network-issues/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 debugging-network-issues 폴더를 내 ~/.claude/skills/debugging-network-issues/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.