Back to Details

08-wrap

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

작업 마무리

工作收尾

개요

概述

구현이 끝나면 깔끔하게 마무리하세요.
마무리 없이 끝내면:
  • 변경사항이 흩어짐
  • 다음에 어디까지 했는지 모름
  • 불필요한 파일이 남음
  • 배운 것이 사라짐
시작할 때 알림: "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: 삭제       → 확인 후 강제 삭제
  ═══════════════════════════════════════════════════════════════════
完成开发后，请妥善收尾工作。
若不进行收尾：
  • 变更内容分散杂乱
  • 下次无法知晓工作进度
  • 残留不必要的文件
  • 学到的内容会丢失
启动提示："将使用wrap技能来收尾工作。"
┌──────────────────────────────────────────────────────────────────────┐
│                    Wrap 工作流 (Enhanced)                         │
└──────────────────────────────────────────────────────────────────────┘

  ┌─────────────────┐
  │ 开发完成       │
  └────────┬────────┘
           │
           ▼
  ┌─────────────────┐
  │ 1. 测试确认  │  npm test / pytest
  └────────┬────────┘
           │
     ┌─────┴─────┐
     │           │
     ▼           ▼
  ┌──────┐   ┌──────┐
  │ PASS │   │ FAIL │──▶ 先修复测试！
  └──┬───┘   └──────┘
     │
     ▼
  ┌─────────────────┐
  │ 2. 状态确认    │  git status / branch
  └────────┬────────┘
           │
           ▼
  ┌─────────────────────────────────────────────────────────────────┐
  │                    3. 提取会话洞察                          │
  │  ┌──────────────────────────────────────────────────────────┐   │
  │  │              阶段1: 并行分析                           │   │
  │  │  ┌──────────────┐ ┌──────────────┐ ┌──────────────┐      │   │
  │  │  │ doc-updater  │ │ automation-  │ │ learning-    │      │   │
  │  │  │              │ │ scout        │ │ extractor    │      │   │
  │  │  └──────┬───────┘ └──────┬───────┘ └──────┬───────┘      │   │
  │  │         │                │                │               │   │
  │  │         └────────────────┼────────────────┘               │   │
  │  │                          ▼                                │   │
  │  │              阶段2: 顺序验证                           │   │
  │  │         ┌────────────────────────────────┐               │   │
  │  │         │     duplicate-checker          │               │   │
  │  │         └────────────────┬───────────────┘               │   │
  │  │                          │                                │   │
  │  │                          ▼                                │   │
  │  │         ┌────────────────────────────────┐               │   │
  │  │         │     followup-suggester         │               │   │
  │  │         └────────────────────────────────┘               │   │
  │  └──────────────────────────────────────────────────────────┘   │
  └────────────────────────┬────────────────────────────────────────┘
                           │
                           ▼
  ┌─────────────────┐
  │ 4. 选择选项    │
  └────────┬────────┘
           │
  ┌────────┼────────┬────────┐
  │        │        │        │
  ▼        ▼        ▼        ▼
┌────┐  ┌────┐  ┌────┐  ┌────┐
│ 1  │  │ 2  │  │ 3  │  │ 4  │
│本地│  │ PR │  │保留│  │删除│
│合并│  │创建│  │    │  │    │
└─┬──┘  └─┬──┘  └─┬──┘  └─┬──┘
  │       │       │       │
  ▼       ▼       │       ▼
┌─────┐ ┌─────┐   │    ┌─────┐
│main │ │push │   │    │确认 │
│合并 │ │+PR  │   │    │后   │
│     │ │     │   │    │删除 │
└──┬──┘ └──┬──┘   │    └──┬──┘
   │       │      │       │
   └───────┴──────┴───────┘
           │
           ▼
  ┌─────────────────┐
  │ 5. Worktree     │  (若使用过)
  │    清理         │
  └────────┬────────┘
           │
           ▼
  ┌─────────────────┐
  │    完成！🎉     │
  └─────────────────┘

  ═══════════════════════════════════════════════════════════════════
  选项1: 本地合并  → merge + 删除分支 + 清理worktree
  选项2: 创建PR    → push + gh pr create + 清理worktree
  选项3: 保留       → 保持原样（后续处理）
  选项4: 删除       → 确认后强制删除
  ═══════════════════════════════════════════════════════════════════

전문 에이전트 (2-Phase Pipeline)

专业Agent（两阶段流水线）

세션 인사이트 추출을 위해 5개의 전문 에이전트가 협력합니다.
通过5个专业Agent协作提取会话洞察。

Phase 1: 병렬 분석 (동시 실행)

阶段1: 并行分析（同时执行）

에이전트역할모델
doc-updaterCLAUDE.md, context.md, decision-record 업데이트 분석sonnet
automation-scout반복 작업을 skill/command/agent로 자동화할 기회 탐지sonnet
learning-extractor세션에서 배운 것, 실수, 새 발견 추출sonnet
Agent职责模型
doc-updater分析CLAUDE.md、context.md、决策记录的更新需求sonnet
automation-scout检测可通过skill/command/agent自动化的重复工作机会sonnet
learning-extractor提取会话中学到的内容、失误、新发现sonnet

Phase 2: 순차 검증

阶段2: 顺序验证

에이전트역할모델
duplicate-checkerPhase 1 제안의 중복 여부 검증haiku
followup-suggester미완성 작업, 개선 포인트, 다음 세션 작업 정리opus
Agent职责模型
duplicate-checker验证阶段1提案是否存在重复haiku
followup-suggester整理未完成工作、改进点、下次会话任务opus

에이전트 실행 방법

Agent执行方法

bash
undefined
bash
undefined

Phase 1: 병렬 실행 (Task tool로 동시 호출)

Phase 1: 并行执行（通过Task工具同时调用）

Task(subagent_type="general-purpose", prompt="doc-updater 에이전트 실행...") Task(subagent_type="general-purpose", prompt="automation-scout 에이전트 실행...") Task(subagent_type="general-purpose", prompt="learning-extractor 에이전트 실행...")
Task(subagent_type="general-purpose", prompt="执行doc-updater Agent...") Task(subagent_type="general-purpose", prompt="执行automation-scout Agent...") Task(subagent_type="general-purpose", prompt="执行learning-extractor Agent...")

Phase 2: Phase 1 결과를 입력으로 순차 실행

Phase 2: 以阶段1结果为输入顺序执行

Task(subagent_type="general-purpose", prompt="duplicate-checker: Phase 1 결과 검증...") Task(subagent_type="general-purpose", prompt="followup-suggester: 후속 작업 정리...")
undefined
Task(subagent_type="general-purpose", prompt="duplicate-checker: 验证阶段1结果...") Task(subagent_type="general-purpose", prompt="followup-suggester: 整理后续工作...")
undefined

에이전트 상세

Agent详情

각 에이전트의 상세 프롬프트는 
references/
폴더에 있습니다:
references/
├── automation-scout.md    # 자동화 기회 탐지
├── doc-updater.md         # 문서 업데이트 분석
├── duplicate-checker.md   # 중복 검증 (Phase 2)
├── followup-suggester.md  # 후속 작업 제안
└── learning-extractor.md  # 학습 포인트 추출
各Agent的详细提示词位于
references/
文件夹中：
references/
├── automation-scout.md    # 自动化机会检测
├── doc-updater.md         # 文档更新分析
├── duplicate-checker.md   # 重复验证（阶段2）
├── followup-suggester.md  # 后续工作提案
└── learning-extractor.md  # 学习要点提取

절차

步骤

1단계: 테스트 확인

步骤1: 测试检查

마무리 전에 테스트가 통과해야 합니다.
bash
undefined
收尾前必须确保测试通过。
bash
undefined

프로젝트에 맞는 테스트 명령어

适配项目的测试命令

npm test
npm test

또는

或者

pytest
pytest

또는

或者

go test ./...

**테스트 실패 시**:
테스트 실패:
  • 실패: 2개
  • 통과: 45개
[실패 내용 표시]
테스트를 먼저 수정해야 합니다. 마무리를 진행할 수 없습니다.

**테스트 통과 시**: 2단계로 진행
go test ./...

**测试失败时**:
测试失败:
  • 失败: 2个
  • 通过: 45个
[显示失败内容]
必须先修复测试。无法继续收尾工作。

**测试通过时**: 进入步骤2

2단계: 현재 상태 확인

步骤2: 检查当前状态

bash
undefined
bash
undefined

어떤 브랜치에 있는지

查看当前所在分支

git branch --show-current
git branch --show-current

변경사항 확인

查看变更内容

git status --short
git status --short

worktree인지 확인

检查是否为worktree

git worktree list
undefined
git worktree list
undefined

3단계: 옵션 선택

步骤3: 选择选项

사용자에게 4가지 옵션을 제시합니다:
작업이 완료되었습니다. 어떻게 마무리할까요?

1. 로컬에서 main에 머지
2. PR 생성
3. 브랜치 유지 (나중에 처리)
4. 작업 취소 (삭제)

어떤 옵션을 선택하시겠습니까?
向用户提供4种选项：
工作已完成。请选择收尾方式：

1. 本地合并至main
2. 创建PR
3. 保留分支（后续处理）
4. 取消工作（删除）

您选择哪个选项？

4단계: 선택에 따른 실행

步骤4: 根据选择执行操作

옵션 1: 로컬 머지

选项1: 本地合并

bash
undefined
bash
undefined

메인 브랜치로 이동

切换至main分支

git checkout main
git checkout main

최신 상태로 업데이트

更新至最新状态

git pull
git pull

기능 브랜치 머지

合并功能分支

git merge feature/my-feature
git merge feature/my-feature

테스트 재확인

重新运行测试

npm test
npm test

브랜치 삭제

删除分支

git branch -d feature/my-feature
undefined
git branch -d feature/my-feature
undefined

옵션 2: PR 생성

选项2: 创建PR

bash
undefined
bash
undefined

원격에 푸시

推送至远程仓库

git push -u origin feature/my-feature
git push -u origin feature/my-feature

PR 생성

创建PR

gh pr create --title "기능 제목" --body "$(cat <<'EOF'
gh pr create --title "功能标题" --body "$(cat <<'EOF'

요약

摘要

  • 변경 내용 1
  • 변경 내용 2
  • 变更内容1
  • 变更内容2

테스트

测试

  • 확인 사항 1
  • 확인 사항 2 EOF )"

PR URL을 사용자에게 알려줍니다.
  • 检查事项1
  • 检查事项2 EOF )"

将PR URL告知用户。

옵션 3: 브랜치 유지

选项3: 保留分支

브랜치 feature/my-feature를 유지합니다.
다음에 이어서 작업하거나 마무리할 수 있습니다.
워크트리도 그대로 유지합니다.
已保留分支feature/my-feature。
后续可继续工作或进行收尾。
worktree也将保持原样。

옵션 4: 작업 취소

选项4: 取消工作

확인을 받습니다:
정말로 삭제하시겠습니까?

삭제될 항목:
- 브랜치: feature/my-feature
- 커밋: abc1234, def5678
- 워크트리: .worktrees/my-feature (있는 경우)

'삭제'를 입력하면 실행됩니다.
확인 후:
bash
git checkout main
git branch -D feature/my-feature
需确认:
确定要删除吗？

将删除的内容:
- 分支: feature/my-feature
- 提交: abc1234, def5678
- worktree: .worktrees/my-feature（若存在）

输入'删除'即可执行。
确认后执行:
bash
git checkout main
git branch -D feature/my-feature

5단계: Worktree 정리

步骤5: 清理Worktree

옵션 1, 2, 4를 선택한 경우 worktree 정리:
bash
undefined
选择选项1、2、4时 清理worktree:
bash
undefined

worktree 목록 확인

查看worktree列表

git worktree list
git worktree list

해당 worktree가 있으면 삭제

若存在对应worktree则删除

git worktree remove .worktrees/my-feature

**옵션 3을 선택한 경우** worktree 유지.
git worktree remove .worktrees/my-feature

**选择选项3时** 保留worktree。

마무리 체크리스트

收尾检查表

  • 테스트 통과 확인
  • 적절한 마무리 옵션 선택
  • 커밋 메시지 명확
  • PR 설명 (옵션 2의 경우)
  • worktree 정리 (해당되는 경우)
  • 确认测试通过
  • 选择合适的收尾选项
  • 提交信息清晰
  • PR说明完整（选项2时）
  • 清理worktree（适用时）

옵션별 요약

选项摘要

옵션머지푸시브랜치 삭제Worktree 정리
1. 로컬 머지O-OO
2. PR 생성-O-O
3. 유지----
4. 삭제--O (강제)O
选项合并推送删除分支清理Worktree
1. 本地合并是-是是
2. 创建PR-是-是
3. 保留----
4. 删除--是（强制）是

주의사항

注意事项

  • 테스트 실패 상태로 머지하지 마세요
  • 삭제는 되돌릴 수 없습니다 - 반드시 확인
  • PR은 리뷰 후 머지하세요
  • 请勿在测试失败时合并
  • 删除操作不可撤销 - 务必确认
  • 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 삭제 완료

마무리가 완료되었습니다!
用户: /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

收尾完成！