3Taste/claude-dual-dev-skill

claude-dual-dev-skill은(는) 무엇을 하나요?

Claude Code Skill — 원클릭으로 이중 창 개발·검토 워크플로우 시작: git worktree 자동 생성, 역할 프롬프트 주입, 신호 파일 기반 모듈별 개발→검토→병합 사이클 실행.

개요

claude-dual-dev-skill은 Claude Code를 위한 스킬로, 개발자와 리뷰어가 동시에 작업할 수 있는 이중 창 워크플로우를 제공합니다. 하나의 명령으로 두 개의 독립적인 git worktree를 생성하고, 각각에 개발자와 리뷰어 역할을 부여하여 모듈 단위로 개발, 검토, 병합을 반복합니다.

주요 기능

• 자동 git worktree 생성: 기존 저장소를 건드리지 않고 격리된 작업 공간을 생성합니다.
• 역할 프롬프트 주입: 각 창에 개발자 또는 리뷰어 역할에 맞는 시스템 프롬프트를 자동으로 설정합니다.
• 신호 파일 기반 워크플로우: 미리 정의된 신호 파일을 통해 개발 완료, 검토 완료, 병합 요청 등의 상태를 관리합니다.
• 모듈 단위 반복: 전체 기능을 작은 모듈로 나누어 순차적으로 개발하고 검토합니다.

사용 방법

1. Claude Code를 열고 다음 명령을 실행합니다:

   claude-dev start --skill dual-dev
   

2. 스킬이 자동으로 두 개의 터미널 창을 생성합니다:

   • 개발 창: 실제 코드를 작성하는 창
   • 검토 창: 작성된 코드를 검토하고 피드백을 제공하는 창

3. 신호 파일을 통해 워크플로우를 제어합니다:

   • SIGNAL_DEV_COMPLETE - 개발 완료 신호
   • SIGNAL_REVIEW_READY - 검토 준비 신호
   • SIGNAL_MERGE_REQUEST - 병합 요청 신호

요구 사항

• Claude Code CLI (claude)가 설치되어 있어야 합니다.
• Git 저장소가 초기화되어 있어야 합니다.
• git worktree 명령어를 사용할 수 있는 환경이어야 합니다.

설정

스킬 설정은 config.yaml 파일에서 관리할 수 있습니다:

worktree:
  base_dir: .worktrees
  dev_branch: feature/dev
  review_branch: feature/review

roles:
  developer:
    prompt: "당신은 숙련된 소프트웨어 개발자입니다..."
  reviewer:
    prompt: "당신은 엄격한 코드 리뷰어입니다..."

signals:
  dev_complete: SIGNAL_DEV_COMPLETE
  review_ready: SIGNAL_REVIEW_READY
  merge_request: SIGNAL_MERGE_REQUEST

워크플로우 예시

1. claude-dev start --skill dual-dev 실행
2. 개발 창에서 첫 번째 모듈 코딩
3. SIGNAL_DEV_COMPLETE 파일 생성
4. 검토 창에서 자동으로 코드 검토 시작
5. SIGNAL_MERGE_REQUEST 파일 생성 시 병합 수행
6. 다음 모듈로 반복

참고 사항

• 모든 변경 사항은 git worktree 내에서 이루어지므로 원본 저장소는 안전합니다.
• 병합 전 충돌이 발생할 경우 git merge 도구를 사용하여 수동으로 해결합니다.
• 이 스킬은 Claude Code의 확장 기능으로, 별도의 설치가 필요할 수 있습니다.

라이선스

MIT