# GUARDiA 하네스 스킬 빠른 참조

> 새 세션에서 각 스킬을 트리거하는 키워드 모음

---

## GUARDiA ITSM (C:\GUARDiA\itsm)

| 스킬 | 트리거 키워드 |
|------|------------|
| `guardia-orchestrator` | SR 처리, 배포 진행, 코드 리뷰, SLA 현황, 인시던트, RCA, 보안 패치, Jira 연동, 다시 실행 |
| `deploy-pipeline` | 배포, 빌드, 릴리즈, Jenkins, VibeSession |
| `sr-lifecycle` | SR 접수, SR 조회, 티켓 관리 |

---

## GUARDiA Manager (C:\GUARDiA\manager)

| 스킬 | 트리거 키워드 |
|------|------------|
| `manager-orchestrator` | 관리자 화면, M-01~M-08, 대시보드 수정, 서버 관리, 배포 관리, 가이드 작성, 다시 실행 |
| `manager-ui` | 화면 구현, 컴포넌트, NCloud 스타일, 대시보드 차트 |
| `manager-api` | FastAPI 백엔드, 시스템 API, 서비스 제어 |
| `manager-integration` | GUARDiA API 연동, Gitea 연동, Ollama 조회 |
| `manager-security` | JWT 인증, Route Guard, API Key 보안 |
| `manager-deploy` | Nginx 설정, systemd, 배포 파이프라인 |

---

## GUARDiA Messenger (C:\GUARDiA\app)

| 스킬 | 트리거 키워드 |
|------|------------|
| `messenger-orchestrator` | 화면 추가, 기능 구현, EAS 빌드, APK, Play Store, App Store, 가이드 작성, 다시 실행 |
| `rn-screen-dev` | 화면 구현, 컴포넌트, UI 수정, API 연동 |
| `eas-build-deploy` | EAS 빌드, APK 빌드, Gradle 오류, 빌드 실패 |
| `store-publish` | Play Store, App Store, 스크린샷, Privacy Policy |
| `doc-generator` | 가이드 작성, PDF 생성, PPTX 생성, 문서화 |

---

## 홈페이지 (C:\GUARDiA\workspace\zioinfo-web)

| 스킬 | 트리거 키워드 |
|------|------------|
| `workspace-analyzer` | 소스 분석, 개발환경 가이드, 하네스 적용, workspace |

---

## 주요 빠른 명령

```bash
# GUARDiA ITSM 재시작
ssh root@zioinfo.co.kr "systemctl restart guardia"

# EAS Android 빌드 (C:\GUARDiA\app에서)
npx eas-cli build --platform android --profile preview

# Gitea Push (홈페이지)
cd C:\GUARDiA\workspace\zioinfo-web
git push gitea main:main

# 서버 전체 상태 확인
ssh root@zioinfo.co.kr "for s in nginx zioinfo guardia guardia-manager gitea jenkins postgresql; do printf '%-22s %s\n' $s $(systemctl is-active $s); done"
```

---

## ⚠️ 자주 발생하는 오류와 해결

| 오류 | 원인 | 해결 |
|------|------|------|
| GUARDiA 500 시작 실패 | DATABASE_URL의 @를 %40으로 인코딩 안함 | .env에서 G@urd1a → G%40urd1a%21 |
| EAS Gradle 실패 | android/ 폴더가 업로드됨 | .easignore에 android/, ios/ 추가 |
| EAS packageReleaseResources 실패 | PIL PNG + AAPT2 충돌 | plugins/withGradleProps.js 확인 |
| Gmail 피싱 경고 | 본문에 IP 직접 링크 포함 | http://zioinfo.co.kr:8001 URL 제거 |
| Gmail 스팸 분류 | PTR 레코드 없음, DMARC 없음 | NCloud PTR 신청, 가비아 DMARC 등록 |
| Nginx IPv6 오류 | NCloud가 IPv4 only | sed로 [::]:80 제거 후 nginx -t |
| Dovecot 시작 실패 | IPv6 listen 시도 | dovecot.conf에 listen = 0.0.0.0 |

*GUARDiA 프로젝트 | 2026-05-31*