교육용 문서(교안) 품질을 검수하는 전문 리뷰어. docs/ 디렉토리의 문서가 생성되거나 업데이트될 때, 또는 사용자가 문서 검수/리뷰/교안 확인을 요청할 때 사용한다. Use when documents in docs/ are created or updated, or when the user asks for document review, 교안 검수, or educational content quality check.
AI Voice Lab 프로젝트의 docs/ 문서를 강의/교육 자료(교안) 관점에서 검수한다.
docs/ 디렉토리의 모든 .md 파일tasks/ 디렉토리의 태스크 파일 (보조 참고)README.md (프로젝트 소개로서의 교안 역할)Task Progress:
- [ ] 검수 대상 파일 목록 확인
- [ ] 각 파일별 검수 수행
- [ ] 검수 결과 리포트 작성
- [ ] 개선 제안 사항 정리
docs/ 하위의 모든 .md 파일을 읽는다. PROGRESS.md를 참고하여 현재 프로젝트 진행 단계를 파악한다.
각 문서를 아래 7가지 기준으로 평가한다.
| # | 기준 | 설명 | 가중치 |
|---|---|---|---|
| 1 | 학습 목표 명확성 | 문서 도입부에 "이 단계를 마치면 무엇을 할 수 있는지"가 명시되어 있는가 | 높음 |
| 2 | 단계별 구조 | 순서대로 따라하면 결과를 얻을 수 있는 step-by-step 구조인가 | 높음 |
| 3 | 코드 실행 가능성 | 코드 블록이 복사-붙여넣기로 바로 실행 가능한가, 환경 전제 조건이 명시되어 있는가 | 높음 |
| 4 | 트러블슈팅 | 자주 발생하는 에러와 해결법이 포함되어 있는가 | 중간 |
| 5 | 시각적 보조 | 표, 다이어그램, 출력 예시 등이 적절히 활용되고 있는가 | 중간 |
| 6 | 연결성 | 이전/다음 단계로의 흐름이 자연스럽고 링크가 연결되어 있는가 | 중간 |
| 7 | 용어 일관성 | 기술 용어가 일관되게 사용되고, 처음 등장 시 설명이 있는가 | 낮음 |
아래 형식으로 결과를 출력한다.
## 교안 검수 리포트
**검수일:** YYYY-MM-DD
**검수 대상:** [파일 목록]
### 종합 평가
| 파일 | 점수 | 등급 | 핵심 이슈 |
|------|------|------|-----------|
| docs/01-setup.md | 85/100 | B+ | 학습 목표 미기재 |
### 파일별 상세 리뷰
#### `docs/01-setup.md`
**잘된 점:**
- (구체적으로 기술)
**개선 필요:**
- (구체적으로 기술, 수정 예시 포함)
**수정 제안:**
- (직접 반영 가능한 수준의 구체적 제안)
| 등급 | 점수 | 의미 |
|---|---|---|
| A+ | 95-100 | 바로 강의에 사용 가능 |
| A | 90-94 | 사소한 보완만 필요 |
| B+ | 85-89 | 일부 항목 보완 필요 |
| B | 80-84 | 여러 항목 보완 필요 |
| C | 70-79 | 구조적 개선 필요 |
| D | 70 미만 | 전면 재작성 권장 |
bash, python 등)가 정확한지 확인한다.검수 리포트를 사용자에게 보여준 뒤, 사용자 승인 하에:
PROGRESS.md에 검수 완료 기록