메뉴
새 git worktree를 생성하고 해당 디렉토리로 이동하여 작업을 시작한다. "워크트리", "worktree 만들어", "새 워크트리", "/worktree", "worktree 생성", "분리된 브랜치에서 작업", "별도 워크트리에서" 같은 표현이 나오면 반드시 이 스킬을 사용한다. 사용자가 이름을 지정하지 않아도 자동 생성으로 처리할 수 있다.
Modutime 프로젝트의 Spring REST Docs API 테스트 및 AsciiDoc 문서 생성 스킬. 새 컨트롤러 엔드포인트에 대한 @ApiDocsTest 테스트 클래스와 .adoc 문서 파일을 프로젝트 패턴에 맞춰 생성한다. 사용 시점: (1) 새 API 엔드포인트의 REST Docs 테스트 작성, (2) 기존 API의 문서화 누락 보완, (3) 'REST Docs', 'API 문서', 'DocsTest', 'adoc 만들어', 'API 테스트 문서' 키워드 감지 시.
Modutime 프로젝트에서 새/수정된 HTTP 엔드포인트를 실제 부팅된 애플리케이션을 상대로 end-to-end로 검증하는 스킬. 단위/통합 테스트로는 잡히지 않는 응답 헤더(`Set-Cookie`), 실제 SQL 동작, Caffeine 캐시 / Spring Security 필터 같은 런타임 측면을 확인할 때 사용한다. 반드시 트리거: "e2e 테스트", "실제로 띄워서 확인", "엔드포인트 e2e", "직접 띄워서 검증", "수동 검증 계획 세워줘", "API 동작 확인", "런타임 검증", "real run", "live test", "응답 헤더 직접 확인", "쿠키가 실제로 떨어지는지" 등. 엔드포인트를 새로 추가하거나 기존 엔드포인트를 의미 있게 수정한 PR을 검증할 때마다 사용한다 — 사용자가 "테스트는 통과했는데 진짜로 동작하나?"라고 물을 때 또는 그렇게 물을 만한 변경(필터/세션/쿠키/캐시/SQL 부수효과)이 있을 때는 명시적으로 요청하지 않더라도 본 스킬을 적극 제안한다.
에이전트 팀 구성 및 조율 스킬. 여러 Claude Code 인스턴스를 팀으로 구성하여 병렬 작업을 수행한다. 공유 태스크 목록, 에이전트 간 메시징, 파일 소유권 분리, 계획 승인 워크플로우를 지원한다. 사용 시점: (1) "팀 구성", "에이전트 팀", "agent team" 키워드 감지 시, (2) 병렬 코드 리뷰, 멀티 레이어 기능 구현, 경쟁 가설 디버깅 등 독립적 병렬 작업이 필요할 때, (3) 3개 이상의 독립적 작업을 동시에 수행해야 할 때, (4) 팀원들이 서로 토론하고 결과를 공유해야 할 때. subagent와 달리, 팀원 간 직접 통신과 공유 태스크 목록을 통한 자체 조율이 가능하다.
| name | worktree |
| description | 새 git worktree를 생성하고 해당 디렉토리로 이동하여 작업을 시작한다. "워크트리", "worktree 만들어", "새 워크트리", "/worktree", "worktree 생성", "분리된 브랜치에서 작업", "별도 워크트리에서" 같은 표현이 나오면 반드시 이 스킬을 사용한다. 사용자가 이름을 지정하지 않아도 자동 생성으로 처리할 수 있다. |
새로운 git worktree를 만들고 해당 경로로 이동하여 사용자가 바로 작업에 들어갈 수 있게 한다.
워크트리 생성 — EnterWorktree 도구를 호출한다.
/worktree my-feature) → name 파라미터로 그 값을 전달한다.이동 — 생성된 워크트리 경로로 Bash 도구를 사용해 cd 한다. EnterWorktree가 이미 세션 작업 디렉토리를 워크트리로 옮기지만, 셸 컨텍스트가 어긋날 수 있으므로 명시적으로 한 번 더 맞춰준다.
최신 원격 main 동기화 — EnterWorktree는 현재 HEAD를 기준으로 새 브랜치를 만들기 때문에, 로컬 main이 origin/main 보다 뒤처져 있거나 푸시되지 않은 로컬 커밋이 섞여 있으면 PR이 의도치 않은 변경을 포함할 수 있다. 이를 막기 위해 워크트리 생성 직후 Bash 도구로 다음을 실행해 최신 origin/main에 맞춘다.
git fetch origin main && git rebase origin/main
EnterWorktree 도구의 옵션이 아니라 스킬 차원의 사용자 지시 처리).gradle.properties 복사 — modutime 프로젝트라면 메인 저장소의 gradle.properties를 워크트리 루트로 항상 복사한다. 워크트리는 .claude/worktrees/<name>/ 에 생성되므로 저장소 루트는 ../../../ 로 접근한다.
cp ../../../gradle.properties ./gradle.properties \
|| cp ../../../gradle.properties.example ./gradle.properties
gradle.properties 자체는 .gitignore 처리되어 있어 신규 합류 머신에는 없을 수 있다. 그 경우 위 fallback 으로 gradle.properties.example 을 복사하고, 사용자에게 본인 머신의 JDK 17 경로(org.gradle.java.home)를 채워달라고 안내한다.요약 보고 — 사용자에게 다음 세 가지를 알려준다.
fd12e5e..4e808f4)다음 작업 묻기 — "이 워크트리에서 무슨 작업부터 시작할까요?" 같은 짧은 질문으로 사용자의 의도를 확인하고 거기서부터 이어간다.
워크트리는 작업을 격리하는 수단이다. 만들기만 하고 사용자가 직접 cd 하도록 두면 메인 디렉토리에서 실수로 편집할 위험이 생긴다. 그래서 도구가 옮겨주는 위치에 셸도 맞추고, 경로/브랜치를 명시적으로 보여줘서 "지금 어디에 있는지"를 사용자가 인지하게 한다.
EnterWorktree({}) (이름 자동 생성)EnterWorktree({ name: "fix-login" })EnterWorktree가 거부한다. 그 경우 새 워크트리는 만들지 말고, 현재 워크트리에서 계속 작업할지 사용자에게 묻는다.EnterWorktree는 git 저장소 안에서만 동작한다. 이 프로젝트(modutime)는 git 저장소이므로 일반적으로 문제없다.