완성된 Sphinx 매뉴얼의 품질을 종합 리뷰합니다. 구조, 내용, 코드, 스타일, 다국어 일관성, 빌드 품질을 6개 카테고리로 검증하고 100점 만점으로 점수를 산출합니다. '문서 리뷰', '매뉴얼 검토', '문서 품질 확인', '매뉴얼 리뷰', '문서 검수', '리뷰해줘' 등의 요청에 자동 적용. Sphinx 문서가 있는 프로젝트에서 문서 품질을 확인하고 싶을 때 이 스킬을 사용하세요.
완성된 Sphinx 매뉴얼의 품질을 종합 리뷰합니다. manual-reviewer 에이전트에 검증을 위임하고, 결과를 사용자에게 보고합니다.
$ARGUMENTS로 전달된 경로에서 conf.py를 찾습니다.
docs/ 디렉토리를 탐색합니다.docs/kr/, docs/en/, docs/jp/)._structure.md가 있으면 원본↔변환 매핑 정보로 활용합니다.manual-reviewer 에이전트에 검증을 위임합니다.
에이전트에게 전달할 정보:
_structure.md 경로 (있으면)에이전트가 6개 카테고리를 검증합니다:
DOCX 원본 경로가 있으면 변환 결과와 비교 검증을 추가로 수행합니다 (표 개수, 이미지 추출, 수식 변환, 각주 보존, OLE/SmartArt 대체 여부, Track Changes 정리 여부).
에이전트의 리뷰 결과를 사용자에게 보고합니다:
## 매뉴얼 리뷰 결과
### 🔴 Critical (즉시 수정 필요)
### 🟠 Major (출시 전 수정 권장)
### 🟡 Minor (개선 권장)
### ✅ 통과 항목
### 점수: XX/100
### 수정 우선순위
점수 기준:
리뷰 결과에서 자동 수정 가능한 이슈가 발견되면, 사용자에게 수정 여부를 질문합니다:
자동 수정 가능한 이슈가 X건 있습니다:
- 코드 블록 언어 미명시: N건
- toctree caption 미번역: N건
- ...
수정할까요? (Y/n)
$ARGUMENTS에 --fix가 포함되어 있으면 질문 없이 바로 수정을 진행합니다 (자동화/스크립트용).
사용자가 승인하면 다음을 수정합니다:
리뷰 결과에서 자동 수정 가능한 이슈를 식별합니다:
수정 전에 수정 계획을 사용자에게 보여주고 승인을 받습니다.
수정 후 다시 빌드하여 경고/에러가 해결되었는지 확인합니다.
수동 수정이 필요한 이슈는 수정 가이드를 제공합니다: