postmelee/codex-usage-analyzer/task-stage-report

하이퍼-워터폴 단계 종료 보고

트리거

• 작업지시자가 "Stage {N} 마무리", "단계 보고서 작성"을 명시 지시한 경우
• 본 SKILL을 직접 호출한 경우

사전 조건

• 구현 계획서(task_m{milestone}_{N}_impl.md)가 존재하고 작업지시자 승인됨
• 현재 단계의 작업 항목이 모두 코드/문서에 반영됨
• 작업 브랜치는 local/task{N}

절차

1. 단계별 검증 명령 실행 (구현 계획서의 해당 단계 "검증" 섹션 그대로)

• 결과를 보고서에 인용할 수 있도록 출력 보존

1. 단계 보고서 작성: mydocs/working/task_m{milestone}_{N}_stage{S}.md

• 중앙 템플릿 mydocs/_templates/stage_report.md를 기준으로 작성한다.
• 템플릿을 읽을 수 없는 경우에만 다음 최소 섹션을 fallback으로 사용한다:
• 단계 목적
• 산출물 (파일 목록 + 라인 수 또는 요약)
• 본문 변경 정도 / 본문 무손실 여부 (해당 시)
• 검증 결과 (위 1번 출력 인용)
• 잔여 위험
• 다음 단계 영향
• 승인 요청 (다음 단계 진입 또는 PR 단계)

1. 변경 점검

``bash git status --short git diff --check ``

1. 단계 소스 + 보고서 묶음 커밋

``bash git add {단계 산출 파일들} mydocs/working/task_m{milestone}_{N}_stage{S}.md git commit -m "Task #{N} Stage {S}: {핵심 내용 요약}" ``

• 하위 단계: Task #{N} [Stage {S.M}]: 내용
• 최종 단계 + 최종 보고서 묶음: Task #{N} Stage {S} + 최종 보고서: 내용 (이 경우 별도 SKILL task-final-report로 처리 권장)

1. 작업지시자에게 단계 보고서 검토와 다음 단계 진입 승인 요청

검증

• git log --oneline -1이 단계 커밋 메시지 표준 형식 충족
• mydocs/working/task_m{milestone}_{N}_stage{S}.md 존재
• 단계 보고서가 mydocs/_templates/stage_report.md의 필수 섹션을 채움
• 단계별 검증 명령이 실패 없이 통과 (실패 시 단계 미완료로 처리하고 보고서 작성 보류)

절대 하지 말 것

• 검증 실패 상태로 보고서 작성·커밋
• 단계 산출물과 보고서를 분리해 별도 커밋 (한 단계는 한 커밋 원칙)
• 작업지시자 승인 없이 다음 단계 진입

호출 방법

• Codex: $task-stage-report 또는 /skills 메뉴
• Claude Code: /task-stage-report