AI 에이전트 워크플로우 (Workflow & Productivity)

When to use this skill

• 일상적인 AI 에이전트 작업 최적화
• Git/GitHub 워크플로우 통합
• MCP 서버 활용
• 세션 관리 및 복구
• 생산성 향상 기법 적용

1. 에이전트별 주요 명령어

Claude Code 명령어

Gemini CLI 명령어

Codex CLI 명령어

2. 키보드 단축키 (Claude Code)

필수 단축키

에디터 편집 단축키

3. 세션 관리

Claude Code 세션

# 마지막 대화 이어서 시작
claude --continue

# 특정 세션 재개
claude --resume <session-name>

# 대화 중 이름 지정
/rename stripe-integration

권장 별칭 설정

# ~/.zshrc 또는 ~/.bashrc
alias c='claude'
alias cc='claude --continue'
alias cr='claude --resume'
alias g='gemini'
alias cx='codex'

4. Git 워크플로우

자동 커밋 메시지 생성

"변경 사항을 분석하고 적절한 커밋 메시지를 작성한 후 커밋해줘"

Draft PR 자동 생성

"현재 브랜치의 변경 사항으로 draft PR을 만들어줘.
제목은 변경 내용을 요약하고, 본문에는 주요 변경 사항을 리스트로 작성해줘."

Git Worktrees 활용

# 여러 브랜치 동시 작업
git worktree add ../myapp-feature-auth feature/auth
git worktree add ../myapp-hotfix hotfix/critical-bug

# 각 worktree에서 독립적 AI 세션
탭 1: ~/myapp-feature-auth → 새 기능 개발
탭 2: ~/myapp-hotfix → 긴급 버그 수정
탭 3: ~/myapp (main) → 메인 브랜치 유지

PR 리뷰 워크플로우

1. "gh pr checkout 123을 실행하고 이 PR의 변경 사항을 요약해줘"
2. "src/auth/middleware.ts 파일의 변경점을 분석해줘. 보안 이슈나 성능 문제가 있는지 확인해줘"
3. "이 로직을 더 효율적으로 바꿀 방법이 있을까?"
4. "네가 제안한 개선 사항을 적용하고 테스트를 실행해줘"

5. MCP 서버 활용 (Multi-Agent)

주요 MCP 서버

MCP 활용 예시

# Gemini: 대용량 분석
> ask-gemini "@src/ 전체 코드베이스 구조 분석해줘"

# Codex: 명령 실행
> shell "docker-compose up -d"
> shell "npm test && npm run build"

MCP 최적화

# 사용하지 않는 MCP 비활성화
/mcp

# 권장 수치
# - MCP 서버: 10개 미만
# - 활성 도구: 80개 미만

6. Multi-Agent 워크플로우 패턴

오케스트레이션 패턴

[Claude] 계획 수립 → [Gemini] 분석/리서치 → [Claude] 코드 작성 → [Codex] 실행/테스트 → [Claude] 결과 종합

실전 예시: API 설계 + 구현 + 테스트

1. [Claude] 스킬 기반 API 스펙 설계
2. [Gemini] ask-gemini "@src/ 기존 API 패턴 분석" - 대용량 코드베이스 분석
3. [Claude] 분석 결과 기반 코드 구현
4. [Codex] shell "npm test && npm run build" - 테스트 및 빌드
5. [Claude] 최종 리포트 생성

TDD 워크플로우

"TDD 방식으로 작업해줘. 먼저 실패하는 테스트를 작성하고,
그 테스트를 통과시키는 코드를 작성해줘."

# AI가:
# 1. 실패하는 테스트 작성
# 2. git commit -m "Add failing test for user auth"
# 3. 테스트를 통과시키는 최소한의 코드 작성
# 4. 테스트 실행 → 통과 확인
# 5. git commit -m "Implement user auth to pass test"

7. 컨테이너 워크플로우

Docker 컨테이너 설정

FROM ubuntu:22.04
RUN apt-get update && apt-get install -y \
    curl git tmux vim nodejs npm python3 python3-pip
RUN curl -fsSL https://claude.ai/install.sh | sh
WORKDIR /workspace
CMD ["/bin/bash"]

안전한 실험 환경

# 컨테이너 빌드 및 실행
docker build -t ai-sandbox .
docker run -it --rm \
  -v $(pwd):/workspace \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  ai-sandbox

# 컨테이너 안에서 실험적 작업 수행

8. 문제 해결

컨텍스트 과다 시

/context  # 사용량 확인
/clear    # 컨텍스트 초기화

# 또는 HANDOFF.md 생성 후 새 세션

작업 취소

Esc Esc  # 마지막 작업 즉시 취소

성능 저하 시

# MCP/도구 수 확인
/mcp

# 불필요한 MCP 비활성화
# 컨텍스트 초기화

Quick Reference Card

=== 필수 명령어 ===
/clear      컨텍스트 초기화
/context    사용량 확인
/usage      토큰 확인
/init       프로젝트 설명 파일 생성
!command    즉시 실행

=== 단축키 ===
Esc Esc     작업 취소
Ctrl+R      히스토리 검색
Shift+Tab×2 계획 모드
Ctrl+B      백그라운드

=== CLI 플래그 ===
--continue  대화 이어가기
--resume    세션 복구
-p "prompt" Headless 모드

=== Multi-Agent ===
Claude      계획/코드 생성
Gemini      대용량 분석
Codex       명령 실행

=== 문제 해결 ===
컨텍스트 과다 → /clear
작업 취소 → Esc Esc
성능 저하 → /context 확인