원클릭으로 Manus에서 모든 스킬 실행

pr

스타2

포크0

업데이트2026년 7월 10일 02:05

사용자가 "PR 올려줘", "풀 리퀘스트 생성" 등 현재 브랜치를 GitHub Pull Request 로 올리길 요청할 때 사용한다. base branch 는 state·config· 공통 config 순으로 자동 결정하며 사용자 명시 입력 시 state 에 저장한다. 제목·본문 컨벤션은 `skills/context/shared/pr.md` 를 따른다.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

radiostart

radiostart/claude-plugins

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

/pilot:pr

현재 git 브랜치의 변경을 PR 로 올린다.

대상 브랜치: 현재 checkout 된 head. (다른 브랜치 push 는 지원하지 않음 — 먼저 git checkout)

사전 확인

preamble.md 의 P-1, P1 수행. ({PROJECT} 획득)

PR 컨벤션 로드 (PR 템플릿은 레포지터리 단위 — 워크스페이스 공통):

워크스페이스 override: workspace/context/pr.md 가 존재하면 우선 Read.
부재 시 fallback: ${CLAUDE_PLUGIN_ROOT}/skills/context/shared/pr.md Read.
둘 다 부재면 아래 최소 본문 규칙 으로 진행 (label·Q-템플릿 없는 default 본문).

최소 본문 규칙 (fallback)

팀·플러그인 pr.md 가 모두 부재할 때 사용하는 default 본문 구조. 라벨·Q1~Q6 템플릿 없이 두 섹션만 채운다.

## Summary

- <변경 요점 1>
- <변경 요점 2>

## Test plan

- [ ] <검증 항목 1>
- [ ] <검증 항목 2>

제목: 첫 커밋의 메시지 한 줄 (50자 이내). 여러 커밋이면 가장 의미 있는 한 줄을 선택.
Summary: git log <base>..HEAD --oneline 결과를 bullet 으로 재구성 (1~5 항목).
Test plan: 변경 영역을 검증할 수동 체크 항목. 자동 생성 못 하면 - [ ] 동작 확인 한 줄.
추가 섹션·라벨·assignee 미설정.

pr_default_base 키 결정 — workspace/context/config.md 에 정의되어 있으면 그 값, 없으면 workspace/context/config.md, 둘 다 없으면 하드 fallback develop. (orchestrate-load 의 toolchain merge 와 동일 우선순위.)

Base branch 결정

state 파일: workspace/projects/{PROJECT}/.agent-state.yml

pr_base_branch 키 존재?
├─ Yes → "타겟: <X> (저장됨). Enter=유지 / 새 입력=변경" 질의
│         ├─ Enter        → base = X. state 변경 없음
│         └─ 새 값 입력    → base = 입력값. state 의 pr_base_branch 갱신
└─ No  → "타겟 브랜치? (Enter=<pr_default_base>)" 질의
          ├─ Enter        → base = pr_default_base. state 미저장
          └─ 새 값 입력    → base = 입력값. state 에 pr_base_branch 신규 기록

remote 존재 검증 (필수)

base 결정 후 PR 생성 전 검증:

git ls-remote --exit-code origin <base>

종료 코드 0 → 진행
비 0 → "타겟 브랜치 <base> 가 origin 에 없습니다. 다시 입력하세요" 출력 후 재질의 루프

수행 절차

변경 확인 — git status, git log <base>..HEAD --oneline, git diff <base>...HEAD --stat 으로 PR 에 포함될 변경 범위 확인.
uncommitted 차단 — staged·unstaged 변경이 있으면 "/pilot:commit 으로 먼저 커밋하세요" 안내 후 종료.
광역 회귀 (soft gate) — workspace/context/config.md 의 regression_command 가 설정돼 있으면 PR 생성 전 1회 실행한다.
- 통과 → 다음 단계 진행.
- 실패 → 실패 결과 요약을 사용자에게 보여주고 PR 생성 진행 여부를 확인받는다 (soft gate — 자동 차단하지 않음).
- 미설정 → skip. INFO 1줄: "레거시 원거리 회귀 감지는 config.md 의 regression_command 설정을 권장합니다."
upstream push — 현재 브랜치가 origin 에 없거나 ahead 면 git push -u origin <branch>.
PR 본문 초안 — pr.md (팀/플러그인) 의 본문 구조에 따라 작성.
- 변경 요약은 git log <base>..HEAD 의 커밋 메시지를 1차 재료로 사용.
- 프로젝트 컨텍스트 주입: project.md 의 목표·완료 체크리스트 → Summary, features/*.md 링크 → Notes, docs/ Confluence URL → Why.
- Q1~Q6 형식이 팀 pr.md 에 있으면 그 형식 사용.
사용자 확인 — 제목·본문·base·head 를 보여주고 승인 받음. 수정 요청 시 한 라운드 반영.
PR 생성 — gh pr create --base <base> --head <branch> --title <title> --body <body> (HEREDOC 사용).
state 갱신 — base 가 명시 입력이면 pr_base_branch 를 .agent-state.yml 에 기록 (Enter=default 면 미저장).
Slack 알림 — .slack.env 활성 + SLACK_EVENTS 에 pr 포함 (default: 포함) 시 PR URL 을 채널로 전송. 호출:
```
python3 ${CLAUDE_PLUGIN_ROOT}/tools/slack-notify.py \
  --event pr --workspace workspace \
  --message "<title> — <pr_url>"
```
--no-slack 플래그 시 skip. 전송 실패는 PR 생성을 차단하지 않음 (slack-notify 는 항상 exit 0).
완료 안내 — PR URL 을 사용자에게 출력.

옵션 (인자)

$ARGUMENTS 파싱:

인자	동작
(없음)	위 절차 그대로
`--draft`	`gh pr create --draft`
`--base <branch>`	base 질의 skip, 입력값 사용. state 에는 기록 (명시 입력 취급)
`--no-slack`	Slack 알림 skip
`--title "..."`	제목 자동 생성 skip, 입력값 사용

예시 흐름

첫 실행 (state 부재)

$ /pilot:pr
타겟 브랜치? (Enter=develop): release/4.5
✓ origin/release/4.5 확인
✓ 현재 브랜치 feature/foo push (3 commits ahead)

제목: feat: foo 기능 추가
base: release/4.5  head: feature/foo

본문 미리보기:
  ## Summary
  ...
  
승인? (y/n): y
✓ PR 생성: https://github.com/org/repo/pull/123
✓ .agent-state.yml 갱신: pr_base_branch=release/4.5
✓ Slack 알림 전송 (#myproject)

재실행 (state 존재)

$ /pilot:pr
타겟: release/4.5 (저장됨). Enter=유지 / 새 입력=변경: ⏎
✓ origin/release/4.5 확인
...

제약

현재 브랜치가 base 와 동일하면 종료 ("base 와 head 가 동일").
gh CLI 미인증 시 gh auth login 안내 후 종료.
--no-verify / hook 우회 사용 금지 (PR 자체엔 hook 없지만 push 단계 hook 우회 안 함).
base 질의 루프는 최대 3회. 3회 모두 stale 면 종료.

참조

PR 컨벤션 (default): shared/pr.md
state 스키마 (pr_base_branch): lifecycle/state-schema.md
커밋 선행: /pilot:commit

이 저장소의 다른 Skills

같은 저장소

review

radiostart/claude-plugins

프로젝트 진행 중 작성된 코드를 PR 이전에 품질 관점에서 리뷰한다. 변경분(git diff)을 대상으로 pilot-code-review 에이전트를 호출하며, 결함마다 severity 와 재진입 라우팅(feature/planner/generator)을 제시한다. evaluator 의 요구사항·게이트 판정과는 별개 축이다.

2026-07-102

analyze

radiostart/claude-plugins

이미 저장된 docs/ 기획서를 features/ 기능 명세로 분할·구조화할 때 사용한다. PM 작성 표 중심 기획서를 기능 단위 문서로 변환하고 project.md 의 목표 섹션 과 prompts/ 파일(planner·generator·evaluator)을 자동 갱신한다. 기획서 fetch 는 `/pilot:confl`, 프롬프트 기반 단일 기능 추가는 `/pilot:create-feature` 를 사용한다.

2026-07-102

commit

radiostart/claude-plugins

사용자가 "커밋해줘", "변경 묶어서 커밋" 등 git 커밋 작성을 요청할 때 사용한다. 변경 파일을 확인하고 `skills/context/shared/commit.md` 규칙(scope 표기, 한국어 본문, 50자 이내 요약)에 맞춰 메시지를 작성해 커밋한다. unstaged 파일이 있으면 포함 여부를 사용자에게 확인한다.

2026-07-102

confl

radiostart/claude-plugins

Confluence 기획서를 프로젝트 docs/ 폴더에 fetch 하거나 저장된 docs/ 를 search·all·search+action 모드로 조회할 때 사용한다. 저장된 docs/ 를 features/ 로 가공하는 작업은 `/pilot:analyze` 가 담당한다.

2026-07-102

create-feature

radiostart/claude-plugins

활성 프로젝트에 사용자 프롬프트 한 줄로 단일 feature 명세를 추가할 때 사용한다. features/NN-{slug}.md 를 prompt-origin 템플릿으로 생성하고 `/pilot:analyze` 와 동일하게 project.md (목표·관련 파일) 와 prompts/* (planner·generator·evaluator) 를 함께 동기화한다. 기획서(docs/) 기반 다건 분할은 `/pilot:analyze` 를 사용한다. 실행은 @pilot-planner 호출로 시작 — 자동 파이프라인 아님.

2026-07-102

doctor

radiostart/claude-plugins

pilot 워크스페이스·프로젝트의 정합성을 검사한다. 상태 이상·드리프트· 부분 설정이 의심될 때, 또는 정기 점검·진단을 원할 때 사용한다. STATE.md·MANIFEST.md·config.md 존재 여부, `.agent-state.yml` 스키마, `analyzed`·`tdd` 플래그가 실제 파일 상태와 일치하는지 검사해 STATE corrupt 같은 조용한 문제를 조기 감지한다.

2026-07-102

name	pr
description	사용자가 "PR 올려줘", "풀 리퀘스트 생성" 등 현재 브랜치를 GitHub Pull Request 로 올리길 요청할 때 사용한다. base branch 는 state·config· 공통 config 순으로 자동 결정하며 사용자 명시 입력 시 state 에 저장한다. 제목·본문 컨벤션은 `skills/context/shared/pr.md` 를 따른다.

/pilot:pr

현재 git 브랜치의 변경을 PR 로 올린다.

대상 브랜치: 현재 checkout 된 head. (다른 브랜치 push 는 지원하지 않음 — 먼저 git checkout)

사전 확인

preamble.md 의 P-1, P1 수행. ({PROJECT} 획득)

PR 컨벤션 로드 (PR 템플릿은 레포지터리 단위 — 워크스페이스 공통):

워크스페이스 override: workspace/context/pr.md 가 존재하면 우선 Read.
부재 시 fallback: ${CLAUDE_PLUGIN_ROOT}/skills/context/shared/pr.md Read.
둘 다 부재면 아래 최소 본문 규칙 으로 진행 (label·Q-템플릿 없는 default 본문).

최소 본문 규칙 (fallback)

팀·플러그인 pr.md 가 모두 부재할 때 사용하는 default 본문 구조. 라벨·Q1~Q6 템플릿 없이 두 섹션만 채운다.

## Summary

- <변경 요점 1>
- <변경 요점 2>

## Test plan

- [ ] <검증 항목 1>
- [ ] <검증 항목 2>

제목: 첫 커밋의 메시지 한 줄 (50자 이내). 여러 커밋이면 가장 의미 있는 한 줄을 선택.
Summary: git log <base>..HEAD --oneline 결과를 bullet 으로 재구성 (1~5 항목).
Test plan: 변경 영역을 검증할 수동 체크 항목. 자동 생성 못 하면 - [ ] 동작 확인 한 줄.
추가 섹션·라벨·assignee 미설정.

Base branch 결정

state 파일: workspace/projects/{PROJECT}/.agent-state.yml

pr_base_branch 키 존재?
├─ Yes → "타겟: <X> (저장됨). Enter=유지 / 새 입력=변경" 질의
│         ├─ Enter        → base = X. state 변경 없음
│         └─ 새 값 입력    → base = 입력값. state 의 pr_base_branch 갱신
└─ No  → "타겟 브랜치? (Enter=<pr_default_base>)" 질의
          ├─ Enter        → base = pr_default_base. state 미저장
          └─ 새 값 입력    → base = 입력값. state 에 pr_base_branch 신규 기록

remote 존재 검증 (필수)

base 결정 후 PR 생성 전 검증:

git ls-remote --exit-code origin <base>

종료 코드 0 → 진행
비 0 → "타겟 브랜치 <base> 가 origin 에 없습니다. 다시 입력하세요" 출력 후 재질의 루프

수행 절차

변경 확인 — git status, git log <base>..HEAD --oneline, git diff <base>...HEAD --stat 으로 PR 에 포함될 변경 범위 확인.
uncommitted 차단 — staged·unstaged 변경이 있으면 "/pilot:commit 으로 먼저 커밋하세요" 안내 후 종료.
광역 회귀 (soft gate) — workspace/context/config.md 의 regression_command 가 설정돼 있으면 PR 생성 전 1회 실행한다.
- 통과 → 다음 단계 진행.
- 실패 → 실패 결과 요약을 사용자에게 보여주고 PR 생성 진행 여부를 확인받는다 (soft gate — 자동 차단하지 않음).
- 미설정 → skip. INFO 1줄: "레거시 원거리 회귀 감지는 config.md 의 regression_command 설정을 권장합니다."
upstream push — 현재 브랜치가 origin 에 없거나 ahead 면 git push -u origin <branch>.
PR 본문 초안 — pr.md (팀/플러그인) 의 본문 구조에 따라 작성.
- 변경 요약은 git log <base>..HEAD 의 커밋 메시지를 1차 재료로 사용.
- 프로젝트 컨텍스트 주입: project.md 의 목표·완료 체크리스트 → Summary, features/*.md 링크 → Notes, docs/ Confluence URL → Why.
- Q1~Q6 형식이 팀 pr.md 에 있으면 그 형식 사용.
사용자 확인 — 제목·본문·base·head 를 보여주고 승인 받음. 수정 요청 시 한 라운드 반영.
PR 생성 — gh pr create --base <base> --head <branch> --title <title> --body <body> (HEREDOC 사용).
state 갱신 — base 가 명시 입력이면 pr_base_branch 를 .agent-state.yml 에 기록 (Enter=default 면 미저장).
Slack 알림 — .slack.env 활성 + SLACK_EVENTS 에 pr 포함 (default: 포함) 시 PR URL 을 채널로 전송. 호출:
```
python3 ${CLAUDE_PLUGIN_ROOT}/tools/slack-notify.py \
  --event pr --workspace workspace \
  --message "<title> — <pr_url>"
```
--no-slack 플래그 시 skip. 전송 실패는 PR 생성을 차단하지 않음 (slack-notify 는 항상 exit 0).
완료 안내 — PR URL 을 사용자에게 출력.

옵션 (인자)

$ARGUMENTS 파싱:

인자	동작
(없음)	위 절차 그대로
`--draft`	`gh pr create --draft`
`--base <branch>`	base 질의 skip, 입력값 사용. state 에는 기록 (명시 입력 취급)
`--no-slack`	Slack 알림 skip
`--title "..."`	제목 자동 생성 skip, 입력값 사용

예시 흐름

첫 실행 (state 부재)

$ /pilot:pr
타겟 브랜치? (Enter=develop): release/4.5
✓ origin/release/4.5 확인
✓ 현재 브랜치 feature/foo push (3 commits ahead)

제목: feat: foo 기능 추가
base: release/4.5  head: feature/foo

본문 미리보기:
  ## Summary
  ...
  
승인? (y/n): y
✓ PR 생성: https://github.com/org/repo/pull/123
✓ .agent-state.yml 갱신: pr_base_branch=release/4.5
✓ Slack 알림 전송 (#myproject)

재실행 (state 존재)

$ /pilot:pr
타겟: release/4.5 (저장됨). Enter=유지 / 새 입력=변경: ⏎
✓ origin/release/4.5 확인
...

제약

현재 브랜치가 base 와 동일하면 종료 ("base 와 head 가 동일").
gh CLI 미인증 시 gh auth login 안내 후 종료.
--no-verify / hook 우회 사용 금지 (PR 자체엔 hook 없지만 push 단계 hook 우회 안 함).
base 질의 루프는 최대 3회. 3회 모두 stale 면 종료.

참조

PR 컨벤션 (default): shared/pr.md
state 스키마 (pr_base_branch): lifecycle/state-schema.md
커밋 선행: /pilot:commit