Run any Skill in Manus with one click

issue-worktree-plan

Stars0

Forks0

UpdatedFebruary 15, 2026 at 13:07

GitHub 이슈 URL을 인자로 받아 이슈 정보를 확인하고 git worktree 기반 작업 브랜치를 생성한 뒤 이슈 계획 문서를 만든다. 이슈 URL 기준으로 브랜치/worktree/계획 문서 초기화를 요청할 때 사용한다.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

honki12345

honki12345/my-agent-skills

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	issue-worktree-plan
description	GitHub 이슈 URL을 인자로 받아 이슈 정보를 확인하고 git worktree 기반 작업 브랜치를 생성한 뒤 이슈 계획 문서를 만든다. 이슈 URL 기준으로 브랜치/worktree/계획 문서 초기화를 요청할 때 사용한다.
argument-hint	[issue-url]
disable-model-invocation	true

Issue Worktree Plan

GitHub 이슈를 기준으로 작업 준비를 자동화하는 작업형 스킬이다.

핵심 원칙:

URL 검증 우선

$ARGUMENTS가 유효한 GitHub issue URL인지 먼저 확인한다.

worktree 안전성 우선

기존 브랜치/워크트리와 충돌하면 덮어쓰지 않고 중단 후 선택지를 제시한다.

문서 일관성 유지

계획 문서는 항상 docs/plan/ISSUE_{번호}_{slug}.md 형식으로 생성한다.

사용법

호출 예시: /issue-worktree-plan https://github.com/org/repo/issues/123
인자가 없으면 issue URL 입력을 요청하고 중단한다.

실행 워크플로우

1단계: 입력 파싱 및 검증

$ARGUMENTS에서 issue URL을 추출한다.
아래 패턴과 일치하는지 확인한다.

https://github.com/{owner}/{repo}/issues/{number}

owner/repo/issue_number를 파싱한다.
형식이 맞지 않으면 예시를 보여주고 중단한다.

2단계: 이슈 메타데이터 확인

아래 명령으로 이슈 정보를 가져온다.

gh issue view "$ISSUE_URL" --json number,title,body,state,url

검증 항목:

조회 실패: gh auth status 확인 안내 후 중단
state가 OPEN이 아닌 경우: 진행 여부를 사용자에게 확인

3단계: 저장소/기준 브랜치 확인

현재 경로가 git 저장소인지 확인한다.
저장소 루트를 구한다.
기준 브랜치를 아래 우선순위로 결정한다.

origin/HEAD가 가리키는 기본 브랜치
main
master
현재 체크아웃 브랜치

참고 명령:

REPO_ROOT=$(git rev-parse --show-toplevel)
DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD | sed 's@^refs/remotes/origin/@@')

4단계: 브랜치명/워크트리 경로 결정

이슈 제목을 slug로 정규화한다.

branch slug: kebab-case (-)
문서 slug: snake_case (_)

브랜치명을 만든다.

issue-{number}-{branch-slug}

워크트리 경로를 만든다.

${REPO_ROOT}/.worktrees/{branch-name}

5단계: git worktree 생성

기본 명령:

git fetch origin "$DEFAULT_BRANCH"
git worktree add -b "$BRANCH_NAME" "$WORKTREE_PATH" "origin/$DEFAULT_BRANCH"

충돌 처리 규칙:

워크트리 경로가 이미 존재하면 중단하고 다른 경로를 요청한다.
브랜치가 이미 있고 다른 워크트리에 붙어 있으면 중단하고 기존 경로를 안내한다.
브랜치가 이미 있고 워크트리에 붙어 있지 않으면 아래로 연결한다.

git worktree add "$WORKTREE_PATH" "$BRANCH_NAME"

6단계: 계획 문서 생성

${WORKTREE_PATH}/docs/plan 디렉토리를 생성한다.
계획 문서 파일명을 만든다.

docs/plan/ISSUE_{number}_{doc-slug}.md

아래 템플릿으로 문서를 생성한다.

# ISSUE #{번호} {이슈 제목}

## 메타 정보
- Issue URL: {이슈 URL}
- Issue 번호: {번호}
- 기준 브랜치: {기준 브랜치}
- 작업 브랜치: {작업 브랜치}
- Worktree 경로: {worktree 경로}
- 작성일: {YYYY-MM-DD}

## 배경/문제
{이슈 본문 요약 또는 원문 핵심}

## 목표
- [ ] 목표 1
- [ ] 목표 2

## 범위
### 포함
- {구현할 항목}

### 제외
- {이번 작업에서 하지 않을 항목}

## 구현 단계
1. [ ] 분석 및 재현
2. [ ] 구현
3. [ ] 테스트
4. [ ] 문서화/정리

## 리스크 및 확인 필요 사항
- {리스크}
- {확인 질문}

## 검증 계획
- [ ] 단위/통합 테스트
- [ ] 수동 시나리오 검증

이미 같은 파일이 있으면 덮어쓰기 전에 사용자 확인을 받는다.

7단계: 결과 보고

아래 항목을 한 번에 보고한다.

issue URL / 제목 / 번호
기준 브랜치
생성된 작업 브랜치
생성된 worktree 경로
생성된 계획 문서 경로
다음 작업 시작 명령 (cd {worktree})

금지 사항

기존 worktree 디렉토리를 무단 삭제/덮어쓰기
사용자 확인 없이 기존 계획 문서 덮어쓰기
이슈와 무관한 브랜치명/문서명 생성

More from this repository

same repository

pr-merge-conflict

honki12345/my-agent-skills

GitHub PR URL을 인자로 받아 merge conflict(병합 충돌) 유무를 판정하고, 충돌이 없으면 즉시 종료한다. 충돌이 있으면 충돌 파일/원인 커밋을 추적해 어떤 PR/브랜치에서 유입된 변경인지 식별한 뒤, 양쪽 PR/이슈의 plans(또는 docs/plan) 문서를 찾아 의도한 구현을 모두 보존하는 형태로 충돌을 해결하고 commit+push 해서 PR이 다시 mergeable 해질 때까지 확인한다. PR 병합 충돌 해결을 요청받으면 사용한다.

2026-02-250

pr-ci-loop

honki12345/my-agent-skills

GitHub PR URL을 인자로 받아 현재 브랜치가 PR의 head branch와 일치하는지 검증한 뒤, GitHub Actions CI 실패 원인을 분석/수정하고 commit+push 후 CI 성공을 폴링으로 확인하는 복구 루프를 수행한다. CodeRabbit/Copilot 같은 코드리뷰 체크는 제외하고 GitHub Actions run만 대상으로 한다. PR CI 실패 복구를 요청받으면 사용한다.

2026-02-170

ship

honki12345/my-agent-skills

변경사항 커밋/푸시 워크플로우 자동화. 이슈 생성, 브랜치 생성, 원자적 커밋, 검증, push, PR 생성 후 CI 폴링/실패 복구까지 한 번에 진행해 달라는 명시적 요청에서 사용한다.

2026-02-170

debug-loop

honki12345/my-agent-skills

버그 상황과 로그를 받아 재현을 최우선으로 수행하고, git 변경/프로젝트 문서 기반 원인 가설을 반복 검증해 해결한다. 방향 변경이 필요하면 사용자 승인 후 진행한다.

2026-02-150

plan-review

honki12345/my-agent-skills

구현 계획 문서를 6가지 관점으로 순차 리뷰하고, 수동 텍스트 승인 루프로 의견/승인을 받아 즉시 반영한 뒤 반복 루프를 수행한다.

2026-02-150

branch-doc-sync

honki12345/my-agent-skills

Analyze current branch changes against a base branch, identify documentation that should be updated, and directly edit those docs. Use when asked to sync docs with branch changes before merge, release, or PR review.

2026-02-150

name	issue-worktree-plan
description	GitHub 이슈 URL을 인자로 받아 이슈 정보를 확인하고 git worktree 기반 작업 브랜치를 생성한 뒤 이슈 계획 문서를 만든다. 이슈 URL 기준으로 브랜치/worktree/계획 문서 초기화를 요청할 때 사용한다.
argument-hint	[issue-url]
disable-model-invocation	true

Issue Worktree Plan

GitHub 이슈를 기준으로 작업 준비를 자동화하는 작업형 스킬이다.

핵심 원칙:

URL 검증 우선

$ARGUMENTS가 유효한 GitHub issue URL인지 먼저 확인한다.

worktree 안전성 우선

기존 브랜치/워크트리와 충돌하면 덮어쓰지 않고 중단 후 선택지를 제시한다.

문서 일관성 유지

계획 문서는 항상 docs/plan/ISSUE_{번호}_{slug}.md 형식으로 생성한다.

사용법

호출 예시: /issue-worktree-plan https://github.com/org/repo/issues/123
인자가 없으면 issue URL 입력을 요청하고 중단한다.

실행 워크플로우

1단계: 입력 파싱 및 검증

$ARGUMENTS에서 issue URL을 추출한다.
아래 패턴과 일치하는지 확인한다.

https://github.com/{owner}/{repo}/issues/{number}

owner/repo/issue_number를 파싱한다.
형식이 맞지 않으면 예시를 보여주고 중단한다.

2단계: 이슈 메타데이터 확인

아래 명령으로 이슈 정보를 가져온다.

gh issue view "$ISSUE_URL" --json number,title,body,state,url

검증 항목:

조회 실패: gh auth status 확인 안내 후 중단
state가 OPEN이 아닌 경우: 진행 여부를 사용자에게 확인

3단계: 저장소/기준 브랜치 확인

현재 경로가 git 저장소인지 확인한다.
저장소 루트를 구한다.
기준 브랜치를 아래 우선순위로 결정한다.

origin/HEAD가 가리키는 기본 브랜치
main
master
현재 체크아웃 브랜치

참고 명령:

REPO_ROOT=$(git rev-parse --show-toplevel)
DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD | sed 's@^refs/remotes/origin/@@')

4단계: 브랜치명/워크트리 경로 결정

이슈 제목을 slug로 정규화한다.

branch slug: kebab-case (-)
문서 slug: snake_case (_)

브랜치명을 만든다.

issue-{number}-{branch-slug}

워크트리 경로를 만든다.

${REPO_ROOT}/.worktrees/{branch-name}

5단계: git worktree 생성

기본 명령:

git fetch origin "$DEFAULT_BRANCH"
git worktree add -b "$BRANCH_NAME" "$WORKTREE_PATH" "origin/$DEFAULT_BRANCH"

충돌 처리 규칙:

워크트리 경로가 이미 존재하면 중단하고 다른 경로를 요청한다.
브랜치가 이미 있고 다른 워크트리에 붙어 있으면 중단하고 기존 경로를 안내한다.
브랜치가 이미 있고 워크트리에 붙어 있지 않으면 아래로 연결한다.

git worktree add "$WORKTREE_PATH" "$BRANCH_NAME"

6단계: 계획 문서 생성

${WORKTREE_PATH}/docs/plan 디렉토리를 생성한다.
계획 문서 파일명을 만든다.

docs/plan/ISSUE_{number}_{doc-slug}.md

아래 템플릿으로 문서를 생성한다.

# ISSUE #{번호} {이슈 제목}

## 메타 정보
- Issue URL: {이슈 URL}
- Issue 번호: {번호}
- 기준 브랜치: {기준 브랜치}
- 작업 브랜치: {작업 브랜치}
- Worktree 경로: {worktree 경로}
- 작성일: {YYYY-MM-DD}

## 배경/문제
{이슈 본문 요약 또는 원문 핵심}

## 목표
- [ ] 목표 1
- [ ] 목표 2

## 범위
### 포함
- {구현할 항목}

### 제외
- {이번 작업에서 하지 않을 항목}

## 구현 단계
1. [ ] 분석 및 재현
2. [ ] 구현
3. [ ] 테스트
4. [ ] 문서화/정리

## 리스크 및 확인 필요 사항
- {리스크}
- {확인 질문}

## 검증 계획
- [ ] 단위/통합 테스트
- [ ] 수동 시나리오 검증

이미 같은 파일이 있으면 덮어쓰기 전에 사용자 확인을 받는다.

7단계: 결과 보고

아래 항목을 한 번에 보고한다.

issue URL / 제목 / 번호
기준 브랜치
생성된 작업 브랜치
생성된 worktree 경로
생성된 계획 문서 경로
다음 작업 시작 명령 (cd {worktree})

금지 사항

기존 worktree 디렉토리를 무단 삭제/덮어쓰기
사용자 확인 없이 기존 계획 문서 덮어쓰기
이슈와 무관한 브랜치명/문서명 생성