| name | pr-create |
| description | PR 생성 시 사용. PULL_REQUEST_TEMPLATE 기반으로 body를 조립하고 check-pr-body.mjs 로컬 검증 → PASS 시 gh pr create. CI re-push 낭비 차단. |
PR Create
PR body contract(scripts/hooks/check-pr-body.mjs, CI PR Body Contract job)를
push 전에 충족시켜, CI fail → body 재작성 → re-push 사이클을 없앤다.
gh pr create CLI는 .github/PULL_REQUEST_TEMPLATE.md를 자동 적용하지 않으므로,
이 skill이 template을 읽어 채우고 로컬에서 검증한 뒤 생성한다.
Inputs
- 변경 diff(
git diff main...HEAD).
- 실행한 정량 check 결과(test/lint/typecheck).
- sprint contract(있으면
docs/sprints/sprint-<N>/contract.md).
- 관련 active memory/docs.
Steps
- template read —
.github/PULL_REQUEST_TEMPLATE.md(7섹션 SOT). HTML comment
가이드(<!-- ... -->)는 body에서 제거.
- 섹션 채우기:
## Summary — 한두 문장.## Changes — repo-relative path 또는 bullet.## Invariants — 보존할 사용자 동작/data/API/workflow invariant.## Test plan — 실행한 check, 또는 해당 없음 사유.## Smoke impact — Smoke-Test-Plan: 같은 줄에 값. 셋 중 하나:
Added/updated smoke: <path> · Covered by existing smoke: <spec> ·
Not required: <reason>. (check-pr-body.mjs 가 같은 줄 값을 요구.)## Documentation impact — 4 필드 한 줄씩:
- Required: yes|no / - Trigger: <user-facing|contract|workflow|safety|ops|architecture|risk|none>
/ - Updated SOT: <repo-relative path, or n/a> / - Reason: <판단 근거>.## Links — issue/ADR/sprint/CI/관련 PR.
- 로컬 검증 — 조립 body를 임시 파일로:
node scripts/hooks/check-pr-body.mjs --body-file <tmp>.
PASS → 다음 단계.FAIL → 누락 섹션/필드 메시지 읽고 채운 뒤 재검증. 반복.
- 생성 —
gh pr create --body-file <tmp> (title 은 Conventional Commits).
Boundaries
- 로컬 절대경로(
/Users, /tmp, file://, worktrees/) evidence 금지 —
check-pr-body.mjs FAIL 원인. repo-relative path 또는 GitHub URL 만.
- template heading(7섹션 이름) 변경 금지. 값만 채운다.
Documentation impact / Required 가 no 여도 Reason 필수(documentation gate).- 임시 body 파일은 생성 커맨드 뒤 정리.
Related
.github/PULL_REQUEST_TEMPLATE.md — 7섹션 template (SOT)scripts/hooks/check-pr-body.mjs — contract 검증 (SOT, 본 skill 은 중복不)memory/workflow/documentation/memory.md — Documentation impact gatememory/workflow/delivery/memory.md — T3 PR 단계
