task-final-report

name	task-final-report
description	하이퍼-워터폴 타스크의 최종 보고와 PR 게시 절차를 적용한다. 최종 결과 보고서(`_report.md`) 작성, 오늘할일 완료 처리, 최종 커밋, publish/task{N} 원격 push, main 대상 Open PR 생성을 수행한다. 모든 단계 완료 후 PR 직전에만 호출.

하이퍼-워터폴 최종 보고와 PR 게시

트리거

• 작업지시자가 "최종 보고서 작성", "PR 준비"를 명시 지시한 경우
• 본 SKILL을 직접 호출한 경우

사전 조건

• 구현 계획서의 모든 단계 종료, 각 단계 보고서 커밋 완료
• 통합 검증(전체 수용 기준) 통과 확인
• local/task{N}에 commit 안 된 변경 없음 또는 본 절차에서 함께 커밋할 것만 남아 있음

절차

1. 통합 검증: 구현 계획서의 "수용 기준" 또는 마지막 단계 "검증" 섹션 명령 실행
2. 최종 보고서 작성: mydocs/report/task_m{milestone}_{N}_report.md
   • 중앙 템플릿 mydocs/_templates/final_report.md를 기준으로 작성한다.
   • 템플릿을 읽을 수 없는 경우에만 다음 최소 섹션을 fallback으로 사용한다:
     • 작업 요약 (이슈 링크, 마일스톤, 단계 수)
     • 변경 파일 목록과 영향 범위
     • 변경 전·후 정량 비교 (라인 수, 토큰, 검증 통과 등 적용 시)
     • 검증 결과 (수용 기준별 OK/MISS)
     • 잔여 위험과 후속 작업
     • 작업지시자 승인 요청
3. 오늘할일 갱신: mydocs/orders/{yyyymmdd}.md의 #{N} 행
   • 출력 형식은 mydocs/_templates/orders.md를 기준으로 한다.
   • 상태 완료로 변경, 비고에 완료: HH:mm 기록
4. 변경 점검

   git status --short
   git diff --check
   git log --oneline main..local/task{N}
   

5. 최종 커밋 (Stage 마지막 + 최종 보고서를 묶을 수도, 보고서만 단일 커밋도 가능)

   git add mydocs/report/task_m{milestone}_{N}_report.md mydocs/orders/{yyyymmdd}.md
   git commit -m "Task #{N} Stage {마지막} + 최종 보고서: {요약}"
   # 또는
   git commit -m "Task #{N}: 최종 보고서 작성과 오늘할일 완료 처리"
   

6. 원격 게시 브랜치 push

   git push origin local/task{N}:publish/task{N}
   

7. main 대상 Open PR 생성

   HEAD_SHA=$(git rev-parse HEAD)
   PR_BODY=/tmp/task{N}-pr-body.md
   # .github/pull_request_template.md를 출발점으로 삼아 최종 보고서와 단계 보고서 기준으로 "$PR_BODY" 작성
   gh pr create --base main --head publish/task{N} \
     --title "Task #{N}: {제목}" \
     --body-file "$PR_BODY"
   

   • PR 본문은 .github/pull_request_template.md를 기준으로 작성한다.
   • 최대 4개 요약 bullet (대상 타스크/왜/무엇/리뷰 포인트), Stage당 1줄 요약, 검증 결과 요약, 남은 리스크를 포함
   • Stage 제목은 단계 보고서 URL로, 옆의 짧은 commit SHA는 commit URL로 링크
   • 작업 문서는 HEAD_SHA 기준 https://github.com/postmelee/codex-usage-analyzer/blob/{HEAD_SHA}/mydocs/... URL로 연결
   • 링크 표시는 raw URL이 아니라 [파일명](URL) 형식으로 작성
   • 상대 링크(mydocs/...)나 blob/publish/task{N}/... 링크는 사용하지 않음
   • PR 본문 검증 섹션은 자동 검증, 수동/시나리오 검증, CI/원격 검증, 검증 한계 하위 섹션을 사용한다.
   • 자동 검증은 주제 / 검증 방법 / 결과 / 근거 표로 적고, 명령 나열이 아니라 어떤 수용 기준을 확인했는지와 핵심 출력·통과 개수·확인 조건을 함께 남긴다.
   • 수동/시나리오 검증은 시나리오 / 확인 절차 / 결과 / 자료 표로 적고, 어떤 화면·파일·산출물에서 무엇을 확인했는지 남긴다.
   • CI/원격 검증은 항목 / 결과 / 근거 표로 적고, GitHub Check 이름, run 링크 또는 확인 시점을 남긴다.
   • 실행하지 않은 검증은 표에 남기지 말고 검증 한계 또는 남은 리스크에 사유를 적는다.
   • 긴 로그는 PR 본문에 붙이지 말고 최종 보고서나 단계 보고서 링크로 넘긴다.
   • 시각적 변경사항이 있을 때만 스크린샷 Before/After 표를 유지
   • 관련 이슈에는 대상 타스크가 아니라 선행, 후속, Epic, upstream, 참고 PR/issue만 작성
8. 작업지시자에게 PR URL 전달과 리뷰·merge 승인 요청

검증

• 모든 단계 보고서 + 최종 보고서 존재
• 최종 보고서가 mydocs/_templates/final_report.md의 필수 섹션을 채움
• git status --short 결과 빈 출력
• gh pr view 결과에 draft가 아닌 PR이 정확한 base/head로 등록
• PR 본문 변경 내역의 Stage별 요약이 단계 보고서 링크와 짧은 commit SHA 링크를 함께 사용
• PR 본문 변경 내역의 작업 문서 항목이 commit SHA 고정 URL과 [파일명](URL) 표시 형식을 사용
• PR 본문 작업 문서 항목에 raw GitHub blob URL, 상대 링크, blob/publish/task{N} 링크 없음
• PR 본문 검증 섹션이 자동 검증, 수동/시나리오 검증, CI/원격 검증, 검증 한계 구조를 따름
• PR 본문에 실행하지 않은 검증 체크리스트가 남아 있지 않고, 미수행 항목은 검증 한계 또는 남은 리스크로 분리됨
• 오늘할일 #{N} 상태 완료 + 완료: HH:mm

절대 하지 말 것

• 통합 검증 실패 상태에서 PR 생성
• local/task{N} 브랜치를 원격에 직접 push (반드시 publish/task{N}로 명명)
• squash merge 강제 옵션 사용 (단계 커밋 의미 보존)
• 작업지시자 명시 지시 없이 Draft PR로 생성하거나 self-merge

호출 방법

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