Agent Skills › postmelee/alhangeul-macos › task-stage-report

task-stage-report

GitHub

用于执行超瀑布任务阶段的结束流程。在明确指令下，运行阶段验证、编写阶段报告、将源码与报告合并提交，并请求进入下一阶段批准。

mydocs/skills/task-stage-report/SKILL.md postmelee/alhangeul-macos

Trigger Scenarios

用户明确要求完成当前阶段或编写阶段报告直接调用此 Skill

Install

npx skills add postmelee/alhangeul-macos --skill task-stage-report -g -y

More Options

Non-standard path

npx skills add https://github.com/postmelee/alhangeul-macos/tree/main/mydocs/skills/task-stage-report -g -y

Use without installing

npx skills use postmelee/alhangeul-macos@task-stage-report

指定 Agent (Claude Code)

npx skills add postmelee/alhangeul-macos --skill task-stage-report -a claude-code -g -y

安装 repo 全部 skill

npx skills add postmelee/alhangeul-macos --all -g -y

预览 repo 内 skill

npx skills add postmelee/alhangeul-macos --list

SKILL.md

Frontmatter

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

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

트리거

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

사전 조건

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

절차

단계별 검증 명령 실행 (구현 계획서의 해당 단계 "검증" 섹션 그대로)
- 결과를 보고서에 인용할 수 있도록 출력 보존
단계 보고서 작성: mydocs/working/task_m{milestone}_{N}_stage{S}.md
- 표준 섹션:
  - 단계 목적
  - 산출물 (파일 목록 + 라인 수 또는 요약)
  - 본문 변경 정도 / 본문 무손실 여부 (해당 시)
  - 검증 결과 (위 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로 처리 권장)
작업지시자에게 단계 보고서 검토와 다음 단계 진입 승인 요청