08-wrap
작업을 마무리하는 스킬. 테스트 확인, 커밋/PR, worktree 정리와 함께 5개의 전문 에이전트로 세션 인사이트를 추출합니다.
How do I install this agent skill?
npx skills add https://github.com/team-attention/workshop-upstage --skill 08-wrapIs this agent skill safe to install?
- Gen Agent Trust Hubpass
A development workflow skill that automates task finalization including testing, git operations, and PR creation. It features a multi-agent analysis pipeline to extract session insights and update documentation with a verification step for quality control.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
6/6 files flagged
What does this agent skill do?
작업 마무리
개요
구현이 끝나면 깔끔하게 마무리하세요.
마무리 없이 끝내면:
- 변경사항이 흩어짐
- 다음에 어디까지 했는지 모름
- 불필요한 파일이 남음
- 배운 것이 사라짐
시작할 때 알림: "wrap 스킬을 사용하여 작업을 마무리하겠습니다."
┌──────────────────────────────────────────────────────────────────────┐
│ Wrap 워크플로우 (Enhanced) │
└──────────────────────────────────────────────────────────────────────┘
┌─────────────────┐
│ 구현 완료 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 1. 테스트 확인 │ npm test / pytest
└────────┬────────┘
│
┌─────┴─────┐
│ │
▼ ▼
┌──────┐ ┌──────┐
│ PASS │ │ FAIL │──▶ 테스트 먼저 수정!
└──┬───┘ └──────┘
│
▼
┌─────────────────┐
│ 2. 상태 확인 │ git status / branch
└────────┬────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. 세션 인사이트 추출 │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Phase 1: 병렬 분석 │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │ doc-updater │ │ automation- │ │ learning- │ │ │
│ │ │ │ │ scout │ │ extractor │ │ │
│ │ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │ │
│ │ │ │ │ │ │
│ │ └────────────────┼────────────────┘ │ │
│ │ ▼ │ │
│ │ Phase 2: 순차 검증 │ │
│ │ ┌────────────────────────────────┐ │ │
│ │ │ duplicate-checker │ │ │
│ │ └────────────────┬───────────────┘ │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ ┌────────────────────────────────┐ │ │
│ │ │ followup-suggester │ │ │
│ │ └────────────────────────────────┘ │ │
│ └──────────────────────────────────────────────────────────┘ │
└────────────────────────┬────────────────────────────────────────┘
│
▼
┌─────────────────┐
│ 4. 옵션 선택 │
└────────┬────────┘
│
┌────────┼────────┬────────┐
│ │ │ │
▼ ▼ ▼ ▼
┌────┐ ┌────┐ ┌────┐ ┌────┐
│ 1 │ │ 2 │ │ 3 │ │ 4 │
│로컬│ │ PR │ │유지│ │삭제│
│머지│ │생성│ │ │ │ │
└─┬──┘ └─┬──┘ └─┬──┘ └─┬──┘
│ │ │ │
▼ ▼ │ ▼
┌─────┐ ┌─────┐ │ ┌─────┐
│main │ │push │ │ │확인 │
│머지 │ │+PR │ │ │후 │
│ │ │ │ │ │삭제 │
└──┬──┘ └──┬──┘ │ └──┬──┘
│ │ │ │
└───────┴──────┴───────┘
│
▼
┌─────────────────┐
│ 5. Worktree │ (사용했다면)
│ 정리 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 완료! 🎉 │
└─────────────────┘
═══════════════════════════════════════════════════════════════════
옵션 1: 로컬 머지 → merge + branch 삭제 + worktree 정리
옵션 2: PR 생성 → push + gh pr create + worktree 정리
옵션 3: 유지 → 그대로 (나중에 처리)
옵션 4: 삭제 → 확인 후 강제 삭제
═══════════════════════════════════════════════════════════════════
전문 에이전트 (2-Phase Pipeline)
세션 인사이트 추출을 위해 5개의 전문 에이전트가 협력합니다.
Phase 1: 병렬 분석 (동시 실행)
| 에이전트 | 역할 | 모델 |
|---|---|---|
| doc-updater | CLAUDE.md, context.md, decision-record 업데이트 분석 | sonnet |
| automation-scout | 반복 작업을 skill/command/agent로 자동화할 기회 탐지 | sonnet |
| learning-extractor | 세션에서 배운 것, 실수, 새 발견 추출 | sonnet |
Phase 2: 순차 검증
| 에이전트 | 역할 | 모델 |
|---|---|---|
| duplicate-checker | Phase 1 제안의 중복 여부 검증 | haiku |
| followup-suggester | 미완성 작업, 개선 포인트, 다음 세션 작업 정리 | opus |
에이전트 실행 방법
# Phase 1: 병렬 실행 (Task tool로 동시 호출)
Task(subagent_type="general-purpose", prompt="doc-updater 에이전트 실행...")
Task(subagent_type="general-purpose", prompt="automation-scout 에이전트 실행...")
Task(subagent_type="general-purpose", prompt="learning-extractor 에이전트 실행...")
# Phase 2: Phase 1 결과를 입력으로 순차 실행
Task(subagent_type="general-purpose", prompt="duplicate-checker: Phase 1 결과 검증...")
Task(subagent_type="general-purpose", prompt="followup-suggester: 후속 작업 정리...")
에이전트 상세
각 에이전트의 상세 프롬프트는 references/ 폴더에 있습니다:
references/
├── automation-scout.md # 자동화 기회 탐지
├── doc-updater.md # 문서 업데이트 분석
├── duplicate-checker.md # 중복 검증 (Phase 2)
├── followup-suggester.md # 후속 작업 제안
└── learning-extractor.md # 학습 포인트 추출
절차
1단계: 테스트 확인
마무리 전에 테스트가 통과해야 합니다.
# 프로젝트에 맞는 테스트 명령어
npm test
# 또는
pytest
# 또는
go test ./...
테스트 실패 시:
테스트 실패:
- 실패: 2개
- 통과: 45개
[실패 내용 표시]
테스트를 먼저 수정해야 합니다. 마무리를 진행할 수 없습니다.
테스트 통과 시: 2단계로 진행
2단계: 현재 상태 확인
# 어떤 브랜치에 있는지
git branch --show-current
# 변경사항 확인
git status --short
# worktree인지 확인
git worktree list
3단계: 옵션 선택
사용자에게 4가지 옵션을 제시합니다:
작업이 완료되었습니다. 어떻게 마무리할까요?
1. 로컬에서 main에 머지
2. PR 생성
3. 브랜치 유지 (나중에 처리)
4. 작업 취소 (삭제)
어떤 옵션을 선택하시겠습니까?
4단계: 선택에 따른 실행
옵션 1: 로컬 머지
# 메인 브랜치로 이동
git checkout main
# 최신 상태로 업데이트
git pull
# 기능 브랜치 머지
git merge feature/my-feature
# 테스트 재확인
npm test
# 브랜치 삭제
git branch -d feature/my-feature
옵션 2: PR 생성
# 원격에 푸시
git push -u origin feature/my-feature
# PR 생성
gh pr create --title "기능 제목" --body "$(cat <<'EOF'
## 요약
- 변경 내용 1
- 변경 내용 2
## 테스트
- [ ] 확인 사항 1
- [ ] 확인 사항 2
EOF
)"
PR URL을 사용자에게 알려줍니다.
옵션 3: 브랜치 유지
브랜치 feature/my-feature를 유지합니다.
다음에 이어서 작업하거나 마무리할 수 있습니다.
워크트리도 그대로 유지합니다.
옵션 4: 작업 취소
확인을 받습니다:
정말로 삭제하시겠습니까?
삭제될 항목:
- 브랜치: feature/my-feature
- 커밋: abc1234, def5678
- 워크트리: .worktrees/my-feature (있는 경우)
'삭제'를 입력하면 실행됩니다.
확인 후:
git checkout main
git branch -D feature/my-feature
5단계: Worktree 정리
옵션 1, 2, 4를 선택한 경우 worktree 정리:
# worktree 목록 확인
git worktree list
# 해당 worktree가 있으면 삭제
git worktree remove .worktrees/my-feature
옵션 3을 선택한 경우 worktree 유지.
마무리 체크리스트
- 테스트 통과 확인
- 적절한 마무리 옵션 선택
- 커밋 메시지 명확
- PR 설명 (옵션 2의 경우)
- worktree 정리 (해당되는 경우)
옵션별 요약
| 옵션 | 머지 | 푸시 | 브랜치 삭제 | Worktree 정리 |
|---|---|---|---|---|
| 1. 로컬 머지 | O | - | O | O |
| 2. PR 생성 | - | O | - | O |
| 3. 유지 | - | - | - | - |
| 4. 삭제 | - | - | O (강제) | O |
주의사항
- 테스트 실패 상태로 머지하지 마세요
- 삭제는 되돌릴 수 없습니다 - 반드시 확인
- PR은 리뷰 후 머지하세요
예시 흐름
사용자: /wrap
Claude: wrap 스킬을 사용하여 작업을 마무리하겠습니다.
[테스트 실행]
npm test
결과: 12개 통과, 0개 실패 ✅
[상태 확인]
브랜치: feature/login
변경사항: 5개 파일, 커밋 3개
[옵션 제시]
작업이 완료되었습니다. 어떻게 마무리할까요?
1. 로컬에서 main에 머지
2. PR 생성
3. 브랜치 유지
4. 작업 취소
사용자: 2
Claude: PR을 생성합니다.
[푸시]
git push -u origin feature/login
[PR 생성]
gh pr create --title "로그인 기능 추가" --body "..."
PR이 생성되었습니다: https://github.com/...
[Worktree 정리]
.worktrees/login 삭제 완료
마무리가 완료되었습니다!
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/team-attention/workshop-upstage/08-wrap">View 08-wrap on skillZs</a>