IssueOps Sync PR

이 스킬의 일은 이미 publish한 PR/MR의 본문을 지금 변경 사항에 맞게 다시 쓰는 것이다. 새 PR/MR을 만들거나, 구현하거나, 완료를 기록하지 않는다.

• PR/MR publication: issueops-create-pr
• Issue·child 본문 최신화: issueops-sync-issue
• 완료 기록·generation 반납: issueops-complete
• 원격 쓰기 절차: issueops-remote-write
• provider 세부 규칙: remote-issue.md

시작 전 issueops next --id "$ISSUEOPS_ID" --json으로 현재 단계를 확인한다. 본문 동기화는 어느 단계에서든 할 수 있다.

GitHub PR과 GitLab MR은 같은 계약을 쓴다. CLI의 canonical 동사는 remote sync-pr 하나이며 sync-mr alias는 없다.

언제 쓰는가

draft를 올린 뒤에도 커밋은 쌓인다. 다음 중 하나가 사실이면 본문이 낡은 것이다.

신호	본문에서 낡은 부분
리뷰 피드백을 반영해 구현이 바뀌었다	## 변경 내용, ## 리뷰 포인트
검증 명령·결과가 달라졌다	## 확인한 것
target branch를 retarget했다	## 위험과 되돌리기, base 설명
breaking change 판단이 바뀌었다	## 요약, ## 호환성과 마이그레이션
문서·마이그레이션을 추가했다	## 변경 내용, ## 호환성과 마이그레이션

머지되거나 닫힌 artifact의 본문은 다시 쓰지 않는다. 하네스가 state readback으로 거부한다.

시작 게이트

다음 하나라도 없으면 실행하지 않는다.

• record의 검증된 remote_artifact(URL과 kind). 없으면 issueops-create-pr이 먼저다.
• 현재 Execution의 generation과 native holder. --expected-generation은 현재 lease와 같아야 한다.
• canonical worktree에서의 실행. --cwd는 실제 프로세스 cwd와 같아야 한다.
• 원격 본문을 읽은 뒤 확정한 새 본문. preview 없이 본문을 고정하지 않는다.

--url로 다른 PR/MR을 가리키지 않는다. 이 스킬은 이 사이클이 검증한 artifact 하나만 다룬다.

drift를 읽는 법

issueops remote sync-pr \
  --id "$ISSUEOPS_ID" --expected-generation "$GENERATION" \
  --body-file "$BODY_FILE" --json

drift	뜻	다음 행동
in_sync	제안 본문이 원격과 같다	쓰지 않는다
stale	원격은 하네스가 마지막에 쓴 그대로다	그대로 confirm
remote_edited	리뷰어나 봇이 본문을 고쳤다	그 편집을 새 본문에 반영한 뒤 --accept-remote-edits

PR/MR은 리뷰어가 본문에 체크리스트나 메모를 직접 추가하는 일이 잦다. remote_edited를 "덮어써도 되는 잡음"으로 취급하지 않는다.

Body 형식

골격은 issueops remote render-template --kind pr --template pull_request, 절을 채우는 방법은 references/readable-body.md를 따른다. 최신화는 본문 전체 교체이므로, 지금 사실이 아닌 문장은 남기지 않는다. 특히 ## 확인한 것에 실행하지 않은 확인을 남겨 두지 않는다. 옛 13절 형식을 동기화할 때는 요약, 변경 내용, 확인한 것, 리뷰 포인트로 다시 쓴다.

## 확인한 것을 다시 쓰기 전에 .issueops/AGENT_WORKFLOW.md의 Verify·Finish 절을 읽는다. 그 절이 요구하는 검증 결과와 실행하지 못한 검증의 사유를 지금 diff 기준으로 다시 적는다.

원격에 쓰기 전에 fluent-korean 스킬을 Skill 도구로 호출해서 문장을 다듬는다. 이 호출을 건너뛴 body로는 --confirm을 붙이지 않는다.

preview 응답의 readability는 제안 본문 판정이고 critical이 있으면 confirm이 거부된다. live_readability는 원격의 현재 본문 판정이며 warning만 담는다. 거기 나온 문제가 새 본문에서 사라졌는지 확인한다.

나쁜 예

나쁜 입력	왜 나쁜가
낡은 확인한 것 절을 그대로 둔 채 문단만 추가	본문이 통째로 교체되어 거짓 근거가 남는다
--expected-generation 생략	lease 밖 write가 된다. 거부된다
머지된 PR 본문 재작성 시도	완료된 기록을 흔든다. 거부된다
리뷰어가 쓴 체크리스트를 지우고 confirm	리뷰 맥락이 사라진다
gh pr edit / glab mr update 직접 실행	lease·readback·기록을 우회한다
preview 결과와 다른 body-file로 confirm	검토한 본문과 다른 것이 올라간다

Canonical sync

issueops remote sync-pr \
  --id "$ISSUEOPS_ID" --expected-generation "$GENERATION" \
  --provider "$PROVIDER" --body-file "$BODY_FILE" \
  --expected-body-sha256 "$EXPECTED_BODY_SHA256" \
  --host "$HOST" --session-id "$SESSION_ID" --agent-id "$AGENT_ID" \
  --cwd "$WORKER_PATH" --confirm --json

$EXPECTED_BODY_SHA256은 같은 --body-file로 돌린 preview 응답의 expected_body_sha256을 그대로 쓴다. 이 값은 새 본문이 아니라 preview가 읽은 원격 현재 본문의 digest다(그 사이 원격이 바뀌면 confirm이 거부되는 compare-and-swap 값). body-file을 shasum으로 해시해 넣지 않는다.

confirm 결과의 updated, remote_body_sha256, drift를 확인하고 실제 artifact를 readback한다. 본문 최신화는 완료 기록이 아니다. 완료 증거 봉인과 generation 반납은 issueops-complete가 소유한다.

품질·성능 게이트

• 품질: generation-CAS, native actor, artifact 수명 상태, drift 판정 기록, readability.critical 0과 warning 처리, 원격 write 전 fluent-korean 호출, compare-and-swap sha 일치, secret redaction, live readback.
• 성능: 최신화 단계에서만 이 스킬을 로드한다. issue 생성·완료 reference를 함께 중복 로드하지 않는다.
• 검증:

python3 scripts/validate-skill.py skills/issueops-sync-pr
python3 scripts/verify-skill-shell.py skills/issueops-sync-pr
wc -c skills/issueops-sync-pr/SKILL.md

generation, actor, artifact 상태, 리뷰어 편집 반영 여부, body 완성도, 또는 live readback이 모호하면 쓰지 않는다.