wiki-health
Installation
SKILL.md
wiki-health
위키 환경의 건강 상태를 일괄 점검하는 스킬이다.
사전 요구
이 스킬은 /wiki 스킬로 구성된 위키 환경이 필요합니다.
- CWD에
.wiki심볼릭 링크가 존재하는지 확인 .wiki/wiki-manifest.yaml이 존재하는지 확인- 둘 중 하나라도 없으면: "
/wiki스킬로 위키 환경을 먼저 구성해주세요.npx skills add dev-goraebap/agent-wiki-hub --all -g로 전체 설치할 수 있습니다" 안내 후 중단
검사 항목
| # | 항목 | 검사 방법 | 결과 |
|---|---|---|---|
| 1 | 심볼릭 링크 | .wiki 링크가 유효한 대상을 가리키는지 |
OK / BROKEN |
| 2 | 매니페스트 존재 | .wiki/wiki-manifest.yaml 파일 존재 여부 |
OK / MISSING |
| 3 | 매니페스트 파싱 | YAML이 정상 파싱되는지 | OK / ERROR + 메시지 |
| 4 | 스키마 검증 | 매니페스트가 JSON Schema v2를 만족하는지 | OK / WARN + 위반 목록 |
| 5 | 고아 문서 | documents의 각 path가 실제 파일로 존재하는지 |
OK / ORPHAN + 목록 |
| 6 | 미등록 문서 | .wiki/ 하위 파일 중 매니페스트에 등록되지 않은 것 |
OK / UNTRACKED + 목록 |
| 7 | 프로파일 커버리지 | profiles의 load-order에 있는 타입이 documents에 1개 이상 존재하는지 |
OK / EMPTY + 비어있는 타입 목록 |
| 8 | extends 검증 | extends가 존재하는 프로파일을 참조하는지, 순환 참조가 없는지 |
OK / ERROR + 상세 |
| 9 | SDLC 커버리지 | wiki 스킬의 references/well-known-types.md를 참조하여, 각 SDLC 범주(계획/설계/구현/테스트/배포/유지보수)에 문서가 1개 이상 존재하는지 확인. well-known에 없는 커스텀 타입은 "미분류"로 표시 |
범주별 문서 수 + 비어있는 범주 경고 |
출력 형식
## Wiki Health Report
| 항목 | 상태 | 상세 |
|------|------|------|
| 심볼릭 링크 | ✅ OK | → /path/to/wiki |
| 매니페스트 | ✅ OK | |
| YAML 파싱 | ✅ OK | |
| 스키마 검증 | ✅ OK | v2 |
| 고아 문서 | ❌ ORPHAN | design/deleted.mmd |
| 미등록 문서 | ⚠ UNTRACKED | design/new-api.md |
| 프로파일 커버리지 | ⚠ EMPTY | api-spec (implementation) |
| extends 검증 | ✅ OK | |
### SDLC 커버리지
| SDLC | 문서 수 | 상태 |
|------|--------|------|
| 계획 | 2 | ✅ PRD, 사용자 조사 |
| 설계 | 3 | ✅ ERD, 사이트맵, API 명세 |
| 구현 | 1 | ⚠ 태스크만 있음 (컨벤션 없음) |
| 테스트 | 0 | ❌ 테스트 전략 없음 |
| 배포 | 0 | ❌ 배포 가이드 없음 |
| 유지보수 | 1 | ✅ ADR |
| 미분류 | 0 | — |
### 권장 조치
1. 고아 문서 `design/deleted.mmd`를 매니페스트에서 제거하세요
2. `design/new-api.md`를 매니페스트에 등록하세요 (`/wiki-manifest-add` 사용)
3. api-spec 타입 문서를 추가하면 implementation 프로파일이 더 완전해집니다
4. 테스트 전략, 배포 가이드 문서를 추가하면 SDLC 커버리지가 개선됩니다
5. 프로젝트에 미등록 문서가 있을 수 있습니다 — `/wiki-discover`로 확인해보세요
Related skills