AgentSkillsCN

worktree

强制执行 Git Worktree/分支初始配置的工作流程。在开始实现之前,用于创建工作树、切换目录并进行相关验证。

SKILL.md
--- frontmatter
name: worktree
description: Git worktree/브랜치 초기 세팅을 강제하는 워크플로우. 구현 시작 전 worktree 생성, 디렉터리 이동, 검증이 필요할 때 사용.
user_invocable: true

/worktree - Set Up Feature Worktree

구현 작업 시작 전에 worktree를 준비합니다.

입력

  • topic: 기능 이름 (예: adr006-approval-flow)
  • prefix: 브랜치 prefix (feat, fix, docs, refactor, chore, test, codex)

기본값:

  • prefix=feat

실행 절차

  1. canonical repo 루트(/Users/study/pii-agent-demo)에서 시작합니다.
  2. 아래 명령으로 worktree 생성 스크립트를 실행합니다.
bash
bash scripts/create-worktree.sh --topic {topic} --prefix {prefix}
  1. 출력된 새 worktree 경로로 이동합니다.
  2. 프로젝트 검증을 실행합니다.
bash
bash scripts/guard-worktree.sh
git rev-parse --show-toplevel
git rev-parse --abbrev-ref HEAD
git worktree list
  1. 의존성 부트스트랩을 실행합니다.
bash
bash scripts/bootstrap-worktree.sh "$(pwd)"
  1. 필요 시 dev 서버를 시작합니다.
bash
bash scripts/dev.sh "$(pwd)"

규칙

  • main/master에서 구현 작업을 시작하지 않습니다.
  • worktree 준비 전에는 코드 변경을 시작하지 않습니다.
  • 신규 브랜치 생성 전 로컬 main을 최신 origin/main으로 반드시 동기화합니다.
  • 신규 브랜치는 동기화된 로컬 main에서만 생성합니다.
  • 모든 후속 작업은 방금 생성한 worktree에서만 수행합니다.
  • next: command not found, eslint: command not found가 발생하면 bash scripts/bootstrap-worktree.sh "$(pwd)"를 먼저 실행합니다.