AgentSkillsCN

Ax Wrap Up

Ax Wrap Up

SKILL.md

AX Wrap-up Skill (작업 정리)

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

트리거

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

실행 흐름

code
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 <noreply@anthropic.com>"

커밋 타입:

  • •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_IDAction Log 페이지 ID786433
CONFLUENCE_TODO_PAGE_IDProject TODO 페이지 ID720932
CONFLUENCE_PLAY_DB_PAGE_IDPlay DB 페이지 ID720899
SLACK_WEBHOOK_URLSlack Incoming Webhookhttps://hooks.slack.com/...

Confluence 페이지 구조

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

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

동기화 조건

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

자동 판단 로직

문서 업데이트 필요 여부

  1. •

    changelog.md 업데이트 필요:

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

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

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

    CLAUDE.md 업데이트 필요:

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

커밋 메시지 자동 생성

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

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

출력 예시

code
🔄 작업 정리 시작...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 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-confluenceConfluence만 동기화false
--sync-slackSlack만 알림false

에러 처리

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

사용법

code
/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:confluenceConfluence 동기화Action Log append_to_page
confluence_syncDB/Live doc 업데이트append_to_page 호출
governance알림 전송SlackMCP.send_notification

관련 문서