Agent skill

ax-wrap-up

작업 정리 + 테스트 + 커밋 — 문서 업데이트 + Git commit

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/ax-wrap-up

SKILL.md

AX Wrap-up Skill (작업 정리)

SSDD 원칙에 따라 작업 내용을 정리하고, 테스트 검증 후 Git 커밋을 수행합니다. 기본적으로 Confluence Action Log 및 Slack 알림까지 자동 처리합니다. 동기화를 건너뛰려면 --no-sync 옵션을 사용하세요.

트리거

  • /ax:wrap-up 명령
  • "작업 정리" 프롬프트

실행 흐름

1단계: 변경 사항 수집
    ↓
2단계: 문서 업데이트 확인
    ↓
3단계: 테스트 실행
    ↓
4단계: 테스트 결과 처리
    ↓
5단계: Git 커밋
    ↓
6단계: 외부 시스템 동기화 (기본 실행)
    ├─ Confluence Action Log 업데이트 (/ax:confluence 연계)
    └─ Slack 알림 전송 (governance agent 연계)

실행 단계

1단계: 변경 사항 수집

bash
git status
git diff --stat
  • 수정된 파일 목록 확인
  • 스테이징 상태 확인

2단계: 문서 업데이트 확인

SSDD 원칙에 따라 다음 문서들의 업데이트 필요 여부를 확인합니다:

문서 업데이트 조건 체크 항목
changelog.md 기능 추가/변경/수정 시 변경 내역 기록
project-todo.md 작업 완료/추가 시 완료 항목 체크, 새 항목 추가
CLAUDE.md 구조/규칙 변경 시 버전, 기술 스택 정보
docs/specs/*.md 스펙 변경 시 API/모델 스펙

3단계: 테스트 실행

프로젝트 타입에 따라 적절한 테스트를 실행합니다:

Python (백엔드):

bash
# Linting
ruff check backend/

# Type checking
mypy backend/

# Unit tests
pytest tests/ -v --tb=short

TypeScript (프론트엔드):

bash
# Type checking
pnpm typecheck

# Linting
pnpm lint

# Unit tests
pnpm test

4단계: 테스트 결과 처리

결과 동작
✅ 모든 테스트 통과 5단계(커밋)로 진행
❌ 테스트 실패 실패 내용 보고, 수정 제안
⚠️ 경고만 있음 경고 목록 표시 후 사용자 확인

5단계: Git 커밋

테스트 통과 시:

bash
# 변경 파일 스테이징
git add -A

# 커밋 메시지 생성 (Conventional Commits)
git commit -m "<type>: <description>

<body>

Co-Authored-By: Claude Opus 4.5 <[email protected]>"

커밋 타입:

  • feat: 새로운 기능
  • fix: 버그 수정
  • docs: 문서 변경
  • refactor: 리팩토링
  • test: 테스트 추가/수정
  • chore: 빌드/설정 변경

6단계: 외부 시스템 동기화 (기본 실행)

커밋 완료 후 외부 시스템에 작업 내역을 자동으로 동기화합니다. --no-sync 옵션으로 건너뛸 수 있습니다.

6-1. Confluence Action Log 업데이트

/ax:confluence skill을 연계하여 Action Log에 커밋 정보를 기록합니다.

python
# confluence_sync agent 활용
await confluence.append_to_page(
    page_id=CONFLUENCE_ACTION_LOG_PAGE_ID,  # 786433
    append_md=f"""
---

## 📝 [{timestamp}] 작업 완료

**커밋**: [`{commit_hash}`]({github_url}/commit/{commit_hash})

**메시지**: {commit_message}

**변경 파일** ({file_count}개):
{file_list}

**작성자**: Claude Opus 4.5
"""
)

6-2. Slack 알림 전송

governance agent의 알림 기능을 활용하여 Slack에 작업 완료를 알립니다.

python
# SlackMCP 활용 (governance agent 연계)
await slack.send_notification(
    title="🚀 작업 완료 - AX Discovery Portal",
    text=f"""
커밋: {commit_hash}
{commit_message}

📄 Confluence: Action Log 업데이트됨
📁 변경 파일: {file_count}개
✅ 테스트: {test_result}
""",
    color="good"  # green
)

환경 변수 요구사항

변수 용도 예시
CONFLUENCE_ACTION_LOG_PAGE_ID Action Log 페이지 ID 786433
CONFLUENCE_TODO_PAGE_ID Project TODO 페이지 ID 720932
CONFLUENCE_PLAY_DB_PAGE_ID Play DB 페이지 ID 720899
SLACK_WEBHOOK_URL Slack Incoming Webhook https://hooks.slack.com/...

Confluence 페이지 구조

Project TODO (720932) ─────────────── 스프린트 단위 진행현황
    │
    ├── EXT_Desk_D01 ToDo List (753719) ── Play별 세부 작업
    └── ...

Play DB (720899) ──────────────────── 세부 작업 페이지 링크만 포함
Action Log (786433) ───────────────── 작업 이력 기록

동기화 조건

조건 동작
기본 (옵션 없음) Confluence + Slack 모두 실행
--no-sync 옵션 지정 동기화 건너뜀 (로컬 커밋만)
--sync-confluence Confluence만 실행
--sync-slack Slack만 실행
환경 변수 미설정 해당 동기화 건너뜀 (경고 표시)

자동 판단 로직

문서 업데이트 필요 여부

  1. changelog.md 업데이트 필요:

    • backend/ 또는 app/ 디렉토리 변경 시
    • 새 기능 추가 또는 버그 수정 시

  2. project-todo.md 업데이트 필요:

    • 기존 TODO 항목 완료 시
    • 새로운 작업 항목 발견 시

  3. CLAUDE.md 업데이트 필요:

    • 버전 변경 시
    • 새로운 에이전트/스킬 추가 시

커밋 메시지 자동 생성

변경 내용을 분석하여 적절한 커밋 메시지를 생성합니다:

변경 파일 분석 → 변경 유형 판단 → 메시지 초안 생성 → 사용자 확인

출력 예시

🔄 작업 정리 시작...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 1. 변경 사항 수집
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

수정된 파일 (3개):
  M backend/api/routes/inbox.py
  M backend/agent_runtime/workflows/wf_01_seminar.py
  A tests/test_wf_01.py

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📝 2. 문서 업데이트 확인
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ changelog.md - 업데이트됨
✅ project-todo.md - 업데이트됨
⏭️ CLAUDE.md - 변경 불필요

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧪 3. 테스트 실행
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[ruff] ✅ 0 errors, 0 warnings
[mypy] ✅ Success: no issues found
[pytest] ✅ 15 passed, 0 failed (2.3s)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💾 4. Git 커밋
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📌 커밋 메시지 (자동 생성):

  feat: WF-01 Seminar Pipeline 워크플로 구현

  - Activity 생성 로직 추가
  - Signal 추출 기능 구현
  - AAR 템플릿 자동 생성
  - 단위 테스트 15개 추가

커밋을 진행할까요? [Y/n]:

✅ 커밋 완료!
   commit abc1234: feat: WF-01 Seminar Pipeline 워크플로 구현

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📤 5. 외부 시스템 동기화
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📄 Confluence Action Log
   ✅ 업데이트 완료
   Page: https://xxx.atlassian.net/wiki/spaces/AB/pages/786433

💬 Slack 알림
   ✅ 전송 완료
   Channel: #ax-bd-alerts

옵션

옵션 설명 기본값
--skip-docs 문서 업데이트 건너뛰기 false
--skip-test 테스트 건너뛰기 (비권장) false
--auto 모든 확인 자동 승인 false
--dry-run 실제 커밋 없이 미리보기 false
--no-sync 동기화 건너뛰기 (로컬 커밋만) false
--sync-confluence Confluence만 동기화 false
--sync-slack Slack만 알림 false

에러 처리

에러 메시지 해결 방법
테스트 실패 "테스트 실패로 커밋이 중단되었습니다" 실패 테스트 수정 후 재실행
충돌 "Git 충돌이 감지되었습니다" 충돌 해결 후 재실행
변경 없음 "커밋할 변경 사항이 없습니다" 작업 확인
Confluence 실패 "Confluence 동기화 실패" 환경 변수 및 네트워크 확인
Slack 실패 "Slack 알림 전송 실패" SLACK_WEBHOOK_URL 확인
환경 변수 미설정 "⚠️ CONFLUENCE_ACTION_LOG_PAGE_ID 미설정" .env 파일 확인

사용법

/ax:wrap-up                    # 기본 실행 (커밋 + Confluence + Slack 동기화)
/ax:wrap-up --no-sync          # 로컬 커밋만 (동기화 건너뛰기)
/ax:wrap-up --sync-confluence  # 커밋 + Confluence만 동기화
/ax:wrap-up --sync-slack       # 커밋 + Slack만 알림
/ax:wrap-up --dry-run          # 미리보기 (커밋 없음)
/ax:wrap-up --skip-docs        # 문서 업데이트 건너뛰기
/ax:wrap-up --auto             # 자동 모드 (모든 확인 자동 승인)

연계 Skill/Agent

Skill/Agent 역할 연계 방식
/ax:confluence Confluence 동기화 Action Log append_to_page
confluence_sync DB/Live doc 업데이트 append_to_page 호출
governance 알림 전송 SlackMCP.send_notification

관련 문서

  • CLAUDE.md - 프로젝트 개발 문서
  • changelog.md - 변경 이력
  • project-todo.md - 작업 추적
  • ax-confluence SKILL.md - Confluence 동기화 Skill
  • confluence_sync.md - Confluence Sync Agent

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results