Task stage report

Skill postmelee/hyper-waterfall/templates/locales/ko/mydocs/skills/task-stage-report

A human-governed AI coding workflow that distills ephemeral session context into persistent project memory—making work traceable, reviewable, and resumable.

Install

npx -y skills add postmelee/hyper-waterfall --skill task-stage-report

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

하이퍼-워터폴 타스크의 단계 종료 절차를 적용한다. 단계별 완료 보고서(`_stage{N}.md`) 작성, 단계 소스와 보고서 묶음 커밋, 단계 검증 명령 실행을 수행한다. 한 단계가 끝나고 다음 단계 진입 직전에 호출.

SKILL.md

2.7 KB, as published. Nobody here has run it

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

트리거

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

사전 조건

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

절차

단계별 검증 명령 실행 (구현 계획서의 해당 단계 "검증" 섹션 그대로)
- 결과를 보고서에 인용할 수 있도록 출력 보존
단계 보고서 작성: mydocs/working/task_m{milestone}_{N}_stage{S}.md
- 중앙 템플릿 mydocs/_templates/stage_report.md를 기준으로 작성한다.
- 템플릿을 읽을 수 없는 경우에만 다음 최소 섹션을 fallback으로 사용한다:
  - 단계 목적
  - 산출물 (파일 목록 + 라인 수 또는 요약)
  - 본문 변경 정도 / 본문 무손실 여부 (해당 시)
  - 검증 결과 (위 1번 출력 인용)
  - 잔여 위험
  - 다음 단계 영향
  - 승인 요청 (다음 단계 진입 또는 PR 단계)
변경 점검
```
git status --short
git diff --check
```
단계 소스 + 보고서 묶음 커밋
```
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로 처리 권장)
작업지시자에게 단계 보고서 검토와 다음 단계 진입 승인 요청

검증

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