Question 1

systemd 사용자 서비스가 자동으로 재시작되지 않을 때 서버 재부팅 후 발생하는 Cloudflare 530 및 대시보드 502 오류를 해결하는 방법

Accepted Answer

이 장애는 로컬 프록시는 정상이지만 cloudflared 터널과 옵저버빌리티/대시보드 서비스가 재부팅 후에도 계속 다운된 상태로 남아 있을 때 발생한다. `Restart=on-failure`는 정상 재부팅/SIGTERM 이후에 서비스를 재시작하지 않으며, 배포 cron은 프록시만 재시작했다.

gpu01에서 서비스 사용자로 수행하는 즉시 복구:
```
systemctl --user start k-skill-proxy-tunnel k-skill-proxy-grafana k-skill-proxy-loki k-skill-proxy-promtail
systemctl --user is-active k-skill-proxy-tunnel k-skill-proxy-grafana k-skill-proxy-loki k-skill-proxy-promtail
curl -fsS http://127.0.0.1:8080/health
```
그런 다음 퍼블릭 프록시가 200/302를 반환하고 대시보드가 더 이상 502를 반환하지 않는지 확인한다.

영구적인 수정:
1. 누락된 터널 유닛을 리포지토리에 커밋하고 NFS 부팅 레이스 의존성을 포함한다:
   ```ini
   [Unit]
   StartLimitIntervalSec=0
   RequiresMountsFor=/data/...

[Service]
   Restart=always
   ```
2. `infra/k-skill-proxy-dashboard/systemd/*.service` 아래의 모든 유닛을 `Restart=on-failure`에서 `Restart=always`로 변경한다.
3. 업데이트된 유닛을 다시 로드하고 활성화한다:
   ```
   systemctl --user daemon-reload
   systemctl --user enable --now k-skill-proxy-tunnel k-skill-proxy-grafana k-skill-proxy-loki k-skill-proxy-promtail
   ```
4. 배포된 SHA가 변경되지 않은 경우에도 다운된 서비스가 시작되도록 5분 배포 cron에 워치독을 추가한다:
   ```bash
   systemctl --user is-active --quiet \
     k-skill-proxy-tunnel k-skill-proxy-grafana k-skill-proxy-loki k-skill-proxy-promtail \
     || systemctl --user start \
     k-skill-proxy-tunnel k-skill-proxy-grafana k-skill-proxy-loki k-skill-proxy-promtail
   ```
5. `deployed-sha`와 관계없이 매번 cron 실행 시 퍼블릭 `/health` 스모크 테스트를 실행하고, 실패 시 알림을 보내거나 인시던트 이슈를 생성한다.
6. 추가 하드닝으로, `0.0.0.0` 대신 `KSKILL_PROXY_HOST=127.0.0.1`로 설정하고 cloudflared를 `2026.6.1`에서 `2026.8.2`로 업그레이드한다.

검증: gpu01을 재부팅한 다음, 다섯 개 서비스 모두 `active`를 반환하고 `https://k-skill-proxy.nomadamas.org`와 `https://k-skill-proxy-dashboard.nomadamas.org`가 모두 수동 개입 없이 200/302를 반환하는지 확인한다.

Question 2

MOLIT가 resultCode 22 할당량 초과와 함께 HTTP 200을 반환하여 발생하는 k-skill-proxy real-estate 502 오류는 어떻게 해결하나요?

Accepted Answer

이러한 502 오류는 재시도 가능한 전송 계층 실패가 아닌 의미론적 업스트림 오류입니다. MOLIT는 `resultCode != 000`인 XML 오류 본문을 포함한 HTTP 200을 반환하고, `molit.js`는 이를 `molit_api_<code>`로 변환하며, `server.js`는 이러한 모든 결과를 502로 매핑합니다. `fetchWithRetry`는 HTTP 429/5xx만 재시도하므로 resultCode 22(`LIMITED NUMBER OF SERVICE REQUESTS EXCEEDS`)는 재시도해도 성공하지 않습니다. PR #621의 수정 사항을 배포하거나 동일한 매핑을 적용하세요: resultCode 22를 `503 upstream_quota_exceeded`로 분류하고 `Retry-After: 3600`을 포함하며 재시도하지 않고, 20, 30, 31과 같은 키/애플리케이션 오류는 별도로 분류하여 error 수준으로 로깅하며, 502는 진정한 일시적 업스트림 실패에만 유지하세요. real-estate 및 krx-stock 라우트에서는 502를 반환하기 전에 `request.log.warn({ route, upstreamError: result.error, message })`를 추가하세요. resultCode 22에 대한 `server.test.js` 시나리오를 추가하고 테스트 스위트를 실행하세요. 배포 후에는 할당량 실패가 익명의 502 대신 원인을 특정할 수 있는 503 응답으로 표시됩니다.

Question 3

korean-privacy-terms에서 한글 이용약관 템플릿이 0바이트라 약관이 생성되지 않을 때 어떻게 해결하나요?

Accepted Answer

원인은 고정된 업스트림 커밋 `e390f7b9feb825e368c26726363ea5ce11a34083`에서 한국어 이용약관 템플릿 2개가 빈 파일로 포함된 것입니다.

먼저 빈 템플릿을 확인하세요:
```bash
find ~/.claude/skills/korean-privacy-terms -name '*.tmpl' -size 0
```

임시 해결 방법은 영문 템플릿을 구조 참고용으로 사용해 한국어 약관을 직접 작성하는 것입니다:
```bash
base=~/.claude/skills/korean-privacy-terms/upstream

# 필요한 경로에 한국어 약관 파일을 직접 생성
vi "$base/jurisdictions/kr-pipa/terms-of-service.ko.mdx.tmpl"
vi "$base/templates/terms-of-service.mdx.tmpl"
```
작성 시 같은 디렉터리의 `terms-of-service.en.mdx.tmpl` 또는 `templates/terms-of-service.en.mdx.tmpl`의 변수와 레이아웃은 유지하고, 법률 문구는 한국어로 검토해 교체해야 합니다. 작성 후 스킬 렌더링을 다시 실행하세요. 개인정보처리방침 템플릿은 정상이므로 해당 산출물에는 영향이 없습니다.

병합된 `d7f45d4`는 `install.sh`에 0바이트 템플릿 경고와 문서화를 추가했을 뿐, 빈 한국어 템플릿 자체를 채우지는 않습니다. 근본 해결은 업스트림 `kimlawtech/korean-privacy-terms`에 한국어 템플릿이 추가된 뒤 `scripts/upstream.pin`을 해당 커밋으로 올려야 합니다.

Question 4

korean-movie-search에서 CGV 봇 차단 오류 또는 '503 CGV_UPSTREAM_UNAVAILABLE' 오류를 해결하는 방법은?

Accepted Answer

이는 잘못된 스킬이나 CLI 입력이 아닌 CGV의 업스트림 봇 탐지/접근 제한으로 인해 발생하는 문제입니다. 먼저 `npx --yes daiso health`로 서비스를 확인하세요. 헬스 상태가 정상인데도 CGV 엔드포인트가 `503 CGV_UPSTREAM_UNAVAILABLE`을 반환하는 경우, 잠시 기다렸다가 나중에 다시 시도하세요. CAPTCHA, 브라우저 인증 또는 접근 제어를 우회하지 마세요. 프록시, user-agent 스푸핑, 자동화된 CAPTCHA 해결은 지원되지 않습니다. 다른 오류가 발생하면 영화/극장 식별자와 CLI 구문을 다시 확인하세요. 지속적으로 실패하는 경우 CGV가 제한을 해제할 때까지 기다려야 합니다.

Question 5

MCP를 통해 한국에서 특정 동물용 의약품을 판매하는 동물약국을 어떻게 검색할 수 있나요?

Accepted Answer

`https://hkmedi.co.kr/pharmacy-mcp`에서 Streamable HTTP MCP 서버를 사용할 수 있으며, 이 서버는 K-Skill 리포지토리에 `animal-pharmacy-search` 스킬로도 패키징되어 있습니다(PR #630을 통해 병합됨). 이 도구는 다음 기능을 지원합니다:
1. 한국 동물약국의 지역별 목록 탐색,
2. 키워드 또는 효능별 수의 의약품 검색,
3. 더 높은 신뢰도를 위해 지난 6개월 이내 대상 제품의 구매 기록이 있는 약국만으로 결과 필터링.

참고: 이 데이터는 공식적인 정부 공개 데이터가 아닌 민간 상업 유통업체인 Hongik Medicare에서 제공됩니다. 실시간 재고 상태나 전국 단위의 완전한 정보를 보장하지 않으며, 전문 수의사의 진단이나 처방을 대체할 수 없습니다. 방문 전에 반드시 약국에 전화하여 제품 보유 여부를 확인하세요.

k-skill

개요

README 미리보기

FAQ (5)

同类型项目

tensorflow

superpowers

everything-claude-code

flutter