gh-pr plugin · 사용 결과

gh-pr:commit

작업 트리의 변경과 (알고 있다면) 이슈 번호를 받아 저장소 스타일의 git 커밋 1개를 생성합니다.

Input 작업 트리의 변경 + 이슈 번호
──▶
Skill /gh-pr:commit
──▶
Output 커밋 1개
Note — 미실행 예시

미실행 예시 — gh-pr 스킬 8개는 모두 live repo 에 쓰므로 문서화 목적으로 실행하지 않았습니다. 명령·게이트·결과는 skills/commit/SKILL.md 인용이며 실행 로그가 아닙니다.

01실행할 명령

범용 형식과, 이 저장소를 대상으로 했을 때의 구체 형식.

범용 형식 이 저장소 대상 · dEitY719/gh-pr-skills · origin

/gh-pr:commit [issue-number] [remote]
/gh-pr:commit                 # 대화에서 이슈 번호 자동 탐지
/gh-pr:commit 42              # Closes #42 강제
/gh-pr:commit -h              # references/help.md 출력 후 중단

02입력

무엇이 입력인지, 그리고 실행 전 충족돼야 하는 선행 조건.

입력

  • 작업 트리의 변경 — git status / git diff 로 읽는 staged + unstaged 변경. Step 1 이 상태를 무조건 조회하므로 사용자에게 "뭘 바꿨나요" 를 되묻지 않는다.
  • 이슈 번호(선택) — 숫자 위치 인자 ──▶ 최근 대화의 #N ──▶ 없으면 푸터 생략.

선행 조건 (게이트)

  • 커밋할 변경이 있어야 한다 — 없으면 "nothing to commit" 으로 중단.
  • [remote] 를 지정했다면 실제로 존재해야 한다 — 없으면 git remote -v 목록과 함께 중단하며, origin 폴백은 없다.
  • 비밀로 보이는 파일(.env, credentials.json, 키)이 diff 에 있으면 중단하고 경고한다.

03결과 (실행 시)

생성되는 산출물이 무엇이고 어디에 남는지 — 검증 가능한 형태로.

커밋 1개

git log -1 로 확인 가능. <type>(<scope>): <summary> 형식의 제목, 왜를 설명하는 본문, 그리고 이슈가 해결됐다면 Closes #N 또는 Fixes #N 푸터와 Co-Authored-By 푸터. --amend 가 아닌 새 커밋이다.

stdout 보고

[OK] Committed <short-hash>: <subject line> — 연결된 이슈가 있으면 [OK] Closes #N 과 [OK] Board sync: ... 줄이 붙고, 마지막 줄은 Next: 힌트다 — 보통 /gh-pr:create, 분할로 커밋되지 않은 변경이 남았으면 /gh-pr:commit. 중단 시에는 [FAIL] <reason> 과 Next: <해소 방법> 이고, 아래 report 마커는 출력되지 않는다.

[step:gh-pr-commit/stage-commit] OK [step:gh-pr-commit/metrics-board-sync] OK [step:gh-pr-commit/report] OK

ai-metrics 코멘트

연결된 이슈 위에 남는다. 이슈 번호가 있고 GH_DISABLE_AI_METRICS=1 이 아닐 때만. 실패해도 커밋을 막지 않는 soft-fail 이다.

프로젝트 보드

커밋 메시지에 Closes|Fixes #N 이 실제로 쓰였을 때만, 그리고 카드의 현재 Status 가 Backlog 일 때만 In progress 로 이동한다.

남지 않는 것

원격 브랜치도 PR 도 생기지 않는다. push 는 /gh-pr:create 의 일이다.