[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7FCFP4D2WNZRN8G2F9AJC2W":3,"skill-same:01M7FCFP4D2WNZRN8G2F9AJC2W":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7FCFP4D2WNZRN8G2F9AJC2W","ship",null,"Prevue를 릴리즈한다. 버전 커밋을 develop에 올려 develop → main PR 하나를 열고, CI와 스킬 평가가 나란히 통과하면 머지(=배포)하고, 태그·GitHub Release를 남긴다. 사용자가 릴리즈·배포를 지시할 때만 쓴다(\u002Fship, \u002Fship 0.11.0). 멈춘 자리부터 이어 간다.","kakao\u002Fprevue","kakao","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1267113?v=4","01M7FCF1H0YFGBTTV1CSBBQTTX","01M7FCF1HJM66W3S4SM08Z9X0Q",118,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fship\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: ship\ndescription: Prevue를 릴리즈한다. 버전 커밋을 develop에 올려 develop → main PR 하나를 열고, CI와 스킬 평가가 나란히 통과하면 머지(=배포)하고, 태그·GitHub Release를 남긴다. 사용자가 릴리즈·배포를 지시할 때만 쓴다(\u002Fship, \u002Fship 0.11.0). 멈춘 자리부터 이어 간다.\n---\n\u003C!-- 생성물이다. dev-skills-src\u002Fship\u002FSKILL.md 를 고치고 tools\u002Fgen-agents.sh 로 만든다 -->\n\n# ship — Prevue 릴리즈\n\n릴리즈는 **사용자가 지시할 때만** 한다. 이 스킬이 불렸다는 것이 그 지시다. 규칙(왜 PR이 하나인가 · merge commit · 직접 푸시 예외)은 `AGENTS.md`의 \"릴리즈\" 절이 갖는다 — 여기는 절차만 갖는다.\n\n- 인자: 버전(`0.11.0`)을 주면 그 값을 쓴다. 없으면 제안한다.\n- **사람에게 묻는 곳은 한 번이다** — 2단계의 확인. 승인 뒤에는 끝까지 가고, 실패하면 그 자리에서 멈춰 보고한다.\n- 상태는 git · GitHub에서 읽는다. 따로 적어 두는 파일이 없다 — 다시 불리면 1단계가 멈춘 자리를 찾는다.\n\n## 0. 전제\n\n베이스 체크아웃에서 돈다(워크트리가 아니다). 하나라도 어긋나면 이유를 말하고 멈춘다.\n\n```sh\ngit rev-parse --abbrev-ref HEAD          # develop\ngit status --porcelain                    # 비어 있다\ngit fetch -q origin --tags --prune\ngit pull --ff-only origin develop\n```\n\n## 1. 어디서부터인가\n\n```sh\nver() { { git show \"$1:plugin\u002FVERSION\" 2>\u002Fdev\u002Fnull || git show \"$1:VERSION\"; } | tr -d ' \\n'; }   # plugin\u002F 로 옮기기 전 판은 루트에 있다(D-123)\nD=$(ver origin\u002Fdevelop); M=$(ver origin\u002Fmain)\ngit rev-parse -q --verify \"refs\u002Ftags\u002Fv$M\"                       # main 버전의 태그\ngh pr list --base main --head develop --state open --json number,url\n```\n\n위에서부터 처음 맞는 줄로 간다.\n\n| 상태 | 간다 |\n|---|---|\n| `v$M` 태그가 없다 | 5. 기록 |\n| `D` > `M`, 열린 `develop → main` PR이 있다 | 4. 기다리고 머지 — 스킬 평가를 실은 판인데 PR head에 `스킬 평가` 상태가 없으면 3단계의 \"상태가 없는 head\"부터 |\n| `D` > `M`, PR이 없다 | 3단계의 PR 열기부터 |\n| `D` = `M` | 2. 새 릴리즈 |\n\n이어 가는 경우(`D` > `M`)는 2단계에서 이미 승인받은 버전이라 다시 묻지 않는다. 단, 그 사이 `[Unreleased]`에 새 항목이 들어왔으면 이 버전의 절로 옮길지 **한 번** 묻는다 — 옮기면 그 항목도 `release-notes.md`의 멘션 점검과 \"이어 가는 릴리즈에 늦게 들어온 줄\"(어느 절에 넣고 요약 · Thanks를 고치나)을 거치고, 그 커밋을 develop에 밀고(3단계와 같은 방식) 이어 간다.\n\n## 2. 새 릴리즈 — 확인 한 번\n\n실을 것이 없으면 멈춘다: `git log --oneline origin\u002Fmain..origin\u002Fdevelop`이 비었거나 `CHANGELOG.md`의 `## [Unreleased]` 아래에 `- ` 줄이 없다.\n\n**버전.** 인자가 있으면 그것. 없으면 `[Unreleased]`를 읽고 제안한다 — 새 기능·동작 변화가 하나라도 있으면 마이너(`0.10.0 → 0.11.0`), 고친 것뿐이면 패치(`0.10.0 → 0.10.1`). 메이저는 사람이 적을 때만 올린다. `M`보다 높아야 하고 `v\u003C버전>` 태그가 없어야 한다 — 머지(=배포) 전에 이것을 보는 곳은 여기뿐이다.\n\n**CHANGELOG 정리.** `dev-skills-src\u002Frelease-notes.md`의 \"릴리즈 정리\"대로 한다 — **외부 기여자 · 제보자 멘션 점검**과 **판의 모양**(히어로 그림 · 요약 문단 · 주제별 절 · Thanks)까지. 이 절이 그대로 GitHub Release 본문이 되므로 여기서 빠지면 끝이다. 아직 파일에 쓰지 않는다.\n히어로 그림은 `git cat-file -e origin\u002Fdevelop:assets\u002Frelease-\u003C버전>.png`로 있는지만 본다 — 없으면 그림 없이 가고, 확인 화면에 그렇다고 한 줄 적는다.\n\n**실린 작업.** `git log --first-parent --format='%s' v$M..origin\u002Fdevelop` — squash 커밋 제목의 `(#N)`이 PR이다. 확인 화면의 \"실리는 PR\"이 된다.\n\n**스킬 평가.** `git diff --name-only v$M origin\u002Fdevelop -- skills-src plugin\u002Fcli\u002Fhelp plugin\u002Fbin\u002Fhelp bin\u002Fhelp tests\u002Fevals tools\u002Fskill-eval.sh tools\u002Fskill-eval-codex.py`가 비어 있지 않으면 스킬 · 도움말이 바뀐 판이다 — 3단계에서 **PR을 연 뒤 CI와 나란히 두 스킬 평가를 돌린다.** 평가는 모델 호출이라 CI에 없다 — 배포 전에 여기서 한 번 잰다. 확인 화면에 한 줄로 싣고, 사용자가 빼라고 하면 뺀다. 바뀐 것이 없으면 싣지 않는다.\n\n이것을 한 화면으로 보이고 승인을 받는다.\n\n```\n0.10.0 → 0.11.0   (새 기능: 헤더 워드마크 · 파일 빠른 열기 …)\n── CHANGELOG [0.11.0] (정리본) ──\n히어로 assets\u002Frelease-0.11.0.png | 없음 — 그림 없이\n요약 …\n### \u003C주제> — 항목 머리 줄 …\n### Fixes — …\n### Thanks — @… | 없음\n── 외부 기여 ──  @Dwite #29 수정 · @sergei-lapin #30 제보 · #31 수정 (정리본에 멘션함) | 없음\n── 실리는 PR ──  #44 … · #45 … · #47 …\n── 스킬 평가 ──  스킬 · 도움말이 바뀌었다(skills-src 3 · cli\u002Fhelp 1) → PR을 연 뒤 CI와 나란히 Claude · Codex 평가를 돌린다(Claude 약 $4 · 5~10분, 빼려면 말씀)\n진행할까요? 버전 커밋 → develop에 밀고 PR → CI ∥ 스킬 평가 → 모두 초록이면 main 머지(배포) → 태그 · Release 순서로 끝까지 갑니다.\n```\n\n고쳐 달라면 고쳐 다시 보인다. 거절하면 아무것도 쓰지 않고 멈춘다.\n\n## 3. 버전 커밋 → PR → CI ∥ 스킬 평가\n\n**로컬 검증은 돌지 않는다.** develop에 코드가 들어오는 길은 `implement` PR뿐이고(그 5단계가 같은 다섯 — 스킬 두 벌 · 고지 사본 · CLI 판정 · 단위 · 린트 — 을 돈다), PR 없이 들어오는 것은 문서 · 주석과 버전 커밋(버전 문자열 여섯 파일)뿐이다. PR끼리 합쳐져 깨지는 것은 릴리즈 PR의 \"빌드 검증\"이 같은 다섯에 빌드 · CLI 계약까지 더해 **머지 전에** 잡는다. 그때 버전 커밋은 이미 develop에 있지만 배포 전이라, 4단계의 실패 경로대로 고침 PR로 이어 간다.\n\n```sh\n# CHANGELOG.md 의 [Unreleased] 를 승인받은 정리본으로 바꾼 뒤\nprintf '%s\\n' 0.11.0 > plugin\u002FVERSION\nsh tools\u002Fsync-version.sh            # 매니페스트 둘 · README 두 벌의 배지 · CHANGELOG 제목([Unreleased] → [0.11.0] — 날짜)\nsh tools\u002Fsync-version.sh --check\ngit diff --stat                     # plugin\u002FVERSION · plugin\u002F.claude-plugin\u002Fplugin.json · plugin\u002F.codex-plugin\u002Fplugin.json · README.md · README.ko.md · CHANGELOG.md 뿐이다\ngit commit -am \"0.11.0 릴리즈 — VERSION · 매니페스트 · 배지, CHANGELOG 정리(\u003C무엇을 합치고 고쳤나>)\"\ngit push origin HEAD:develop        # fast-forward 만\ngh pr create --base main --head develop --title \"0.11.0 릴리즈\" --body \"\u003C본문>\"\n```\n\n이 여섯 파일 밖이 바뀌었으면 밀지 말고 멈춘다 — PR 없이 develop에 바로 가는 예외는 버전 커밋뿐이다. 커밋 끝에는 세션의 공동 저자 줄을 붙인다. 푸시가 거부되면(그 사이 develop이 움직였다) 버전 커밋을 버리고(`git reset --hard origin\u002Fdevelop`) 2단계부터 다시 본다.\n\n본문: 첫 줄 \"`develop` → `main`. **merge commit으로 머지한다**(squash · rebase면 develop과 main이 갈라진다). 머지가 곧 배포다.\" 그다음 `[0.11.0]` 절의 요지 한 문단, 실린 PR 범위(`#44~#47`). 스킬 · 도움말이 바뀐 판이면 \"스킬 평가: CI와 나란히 도는 중 — 결과는 `스킬 평가` 상태와 코멘트\"(사용자가 뺐으면 \"스킬 평가: 뺐다(사용자)\")라고 적는다. 끝에 세션의 PR 서명 줄.\n\n**스킬 평가 — 2단계에서 실었으면 PR을 연 직후 돌린다.** CI(빌드 검증)는 PR을 열면 저절로 돌고, 평가는 그와 나란히 돈다. **먼저 PR head에 `스킬 평가`를 `pending`으로 올린다** — 4단계의 `gh pr checks --watch`는 이미 있는 체크만 기다려서, 상태가 없으면 CI가 끝나는 순간 평가가 돌고 있어도 초록으로 끝난다.\n\n```sh\nH=$(gh pr view \u003CN> --json headRefOid -q .headRefOid)     # 평가할 커밋 — 로컬 HEAD 와 같아야 한다(아니면 2단계부터)\nR=kakao\u002Fprevue\nst() { gh api repos\u002F$R\u002Fstatuses\u002F$H -f context=\"스킬 평가\" -f state=\"$1\" -f description=\"$2\"; }\nst pending \"Claude · Codex 평가 중\"\nsh tools\u002Fskill-eval.sh                       # Claude — tests\u002Fevals\u002Fcases\npython3 tools\u002Fskill-eval-codex.py            # Codex — tests\u002Fevals\u002Fcases + codex-cases. 터미널이 codex 를 감싸면 PREVUE_EVAL_CODEX 로 감싸지 않은 실행 파일을 준다\npython3 tools\u002Fskill-eval-codex.py --clean    # 끝나면 Codex 캐시에 둔 평가 플러그인을 지운다\nst success \"Claude 6\u002F6 · Codex 24\u002F24\"        # 결과대로 — 실패면 failure\ngh pr comment \u003CN> --body \"\u003C에이전트별 통과 수 · 실패한 케이스의 채점기와 이유 · 비용>\"\n```\n\n두 평가는 `run_in_background`로 나란히 띄운다. 4단계의 CI 기다림도 PR에 CI 체크가 붙은 것을 본 뒤 같이 띄운다. 셋 다 끝났다는 알림에 이어 간다.\n- 실패한 케이스는 그 케이스만 한 번 다시 돌린다(`--case \u003C이름>`) — 모델 행동이라 회차마다 흔들린다. 다시 돌려도 실패하면 `failure`로 올리고 **멈춰** 실패한 채점기 · 트레이스 요지를 보고한다. 사람이 그 결과를 보고 진행하라고 하면 그 말을 코멘트에 남기고 `success`(설명 \"사람 승인 — …\")로 올려 4단계로 간다.\n- `claude` · `codex`가 없거나 로그인이 안 됐으면 그 평가를 건너뛰고 `success`로 올리되 설명을 \"건너뜀(…)\"으로 **시작한다** — 평가 때문에 릴리즈를 멈추지 않는 대신 체크 목록에서 보이게 한다. 6단계 보고에도 싣는다.\n- 사용자가 2단계에서 평가를 뺐으면 돌리지 않고 `success`(설명 \"뺐다(사용자)\")를 바로 올린다 — 다시 불렸을 때 1단계가 빠진 평가로 읽지 않게.\n\n**상태가 없는 head.** 평가 도중이나 실패 뒤 고침으로 PR head가 바뀌면(develop이 움직였다) 새 head에는 상태가 없다. 1단계 · 4단계 모두 같은 규칙이다:\n\n```sh\ngit diff --name-only \u003C상태가 있는 앞 head> \u003C새 head> -- skills-src plugin\u002Fcli\u002Fhelp plugin\u002Fbin\u002Fhelp bin\u002Fhelp tests\u002Fevals tools\u002Fskill-eval.sh tools\u002Fskill-eval-codex.py\n```\n\n비었으면 앞 결과를 새 head에 그대로 올리고(설명 끝에 \"· 앞 커밋 \u003C짧은 sha> 결과\"), 아니면 새 head에서 평가를 다시 돌린다. 앞 head는 PR 코멘트의 평가 결과나 `gh api $GHE repos\u002F$R\u002Fcommits\u002F\u003Csha>\u002Fstatus`로 찾는다.\n\n## 4. CI · 평가를 기다리고 머지\n\n```sh\ngh pr checks \u003CN> --watch --fail-fast\n```\n\n\"빌드 검증\"(약 7~10분)이 초록이어야 하고, 스킬 평가를 실은 판이면 PR head의 `스킬 평가` 상태도 `success`여야 한다 — 3단계가 `pending`부터 올려 두어 `gh pr checks`가 둘을 함께 기다린다. 머지 직전에 PR head와 그 상태가 붙은 커밋이 같은지 한 번 더 본다(다르면 3단계의 \"상태가 없는 head\"). 빌드 검증은 CI(Ubuntu)에서 돌아 macOS에서만 통과하는 것도 잡는다. 막 연 PR은 체크가 아직 안 붙어 \"no checks\"로 끝날 수 있다 — 그러면 조금 뒤 다시 본다.\n기다림은 `run_in_background`로 돌리고 끝났다는 알림에 이어 간다(포그라운드 sleep은 막혀 있다).\n\n실패하면 **머지하지 않고 멈추고** 어느 체크 · 어느 스텝이 무엇으로 실패했는지(`gh run view \u003Cid> --log-failed`의 요지 · 평가의 채점기) 보고한다. 고치는 일은 이 스킬 밖이다 — 평소처럼 작업 PR을 develop에 넣고 `\u002Fship`을 다시 치면 PR에 새 커밋이 실려 4단계부터 이어진다. 버전 커밋을 되돌리지 않는다 — 머지 전이라 사용자에게 간 것은 없다. 새 head에는 `스킬 평가` 상태가 없으니 3단계의 \"상태가 없는 head\"대로 한다.\n\n초록이면:\n\n```sh\ngh pr merge \u003CN> --merge             # merge commit. --delete-branch 를 붙이지 않는다 — head 가 develop 이다\n```\n\n이 순간이 배포다. 마켓플레이스 둘이 `main`을 읽는다.\n\n## 5. 기록 — 태그 · GitHub Release\n\n```sh\ngh workflow run 릴리즈 --ref main\ngh run list --workflow 릴리즈 --branch main --limit 1 --json databaseId,status,createdAt   # 방금 뜬 실행인지 createdAt 으로 본다\ngh run watch \u003Cid> --exit-status\ngh release view v0.11.0 --json tagName,url\n```\n\n태그가 이미 있으면 워크플로가 아무것도 하지 않는다 — 다시 돌려도 안전하다. Release를 만들지 못했으면(태그는 나갔다) 실패 스텝을 보고하고 6단계(보고)로 간다 — 설치하는 사람에게 영향이 없다.\n\n## 6. 보고\n\n버전 · PR 링크 · 머지 커밋 · Release 링크 · 스킬 평가 결과(돌렸으면)를 한 덩어리로 말한다. 건너뛰거나 실패한 단계가 있으면 그대로 말한다.\n","\u003C!-- 생성물이다. dev-skills-src\u002Fship\u002FSKILL.md 를 고치고 tools\u002Fgen-agents.sh 로 만든다 -->\n\n# ship — Prevue 릴리즈\n\n릴리즈는 **사용자가 지시할 때만** 한다. 이 스킬이 불렸다는 것이 그 지시다. 규칙(왜 PR이 하나인가 · merge commit · 직접 푸시 예외)은 `AGENTS.md`의 \"릴리즈\" 절이 갖는다 — 여기는 절차만 갖는다.\n\n- 인자: 버전(`0.11.0`)을 주면 그 값을 쓴다. 없으면 제안한다.\n- **사람에게 묻는 곳은 한 번이다** — 2단계의 확인. 승인 뒤에는 끝까지 가고, 실패하면 그 자리에서 멈춰 보고한다.\n- 상태는 git · GitHub에서 읽는다. 따로 적어 두는 파일이 없다 — 다시 불리면 1단계가 멈춘 자리를 찾는다.\n\n## 0. 전제\n\n베이스 체크아웃에서 돈다(워크트리가 아니다). 하나라도 어긋나면 이유를 말하고 멈춘다.\n\n```sh\ngit rev-parse --abbrev-ref HEAD          # develop\ngit status --porcelain                    # 비어 있다\ngit fetch -q origin --tags --prune\ngit pull --ff-only origin develop\n```\n\n## 1. 어디서부터인가\n\n```sh\nver() { { git show \"$1:plugin\u002FVERSION\" 2>\u002Fdev\u002Fnull || git show \"$1:VERSION\"; } | tr -d ' \\n'; }   # plugin\u002F 로 옮기기 전 판은 루트에 있다(D-123)\nD=$(ver origin\u002Fdevelop); M=$(ver origin\u002Fmain)\ngit rev-parse -q --verify \"refs\u002Ftags\u002Fv$M\"                       # main 버전의 태그\ngh pr list --base main --head develop --state open --json number,url\n```\n\n위에서부터 처음 맞는 줄로 간다.\n\n| 상태 | 간다 |\n|---|---|\n| `v$M` 태그가 없다 | 5. 기록 |\n| `D` > `M`, 열린 `develop → main` PR이 있다 | 4. 기다리고 머지 — 스킬 평가를 실은 판인데 PR head에 `스킬 평가` 상태가 없으면 3단계의 \"상태가 없는 head\"부터 |\n| `D` > `M`, PR이 없다 | 3단계의 PR 열기부터 |\n| `D` = `M` | 2. 새 릴리즈 |\n\n이어 가는 경우(`D` > `M`)는 2단계에서 이미 승인받은 버전이라 다시 묻지 않는다. 단, 그 사이 `[Unreleased]`에 새 항목이 들어왔으면 이 버전의 절로 옮길지 **한 번** 묻는다 — 옮기면 그 항목도 `release-notes.md`의 멘션 점검과 \"이어 가는 릴리즈에 늦게 들어온 줄\"(어느 절에 넣고 요약 · Thanks를 고치나)을 거치고, 그 커밋을 develop에 밀고(3단계와 같은 방식) 이어 간다.\n\n## 2. 새 릴리즈 — 확인 한 번\n\n실을 것이 없으면 멈춘다: `git log --oneline origin\u002Fmain..origin\u002Fdevelop`이 비었거나 `CHANGELOG.md`의 `## [Unreleased]` 아래에 `- ` 줄이 없다.\n\n**버전.** 인자가 있으면 그것. 없으면 `[Unreleased]`를 읽고 제안한다 — 새 기능·동작 변화가 하나라도 있으면 마이너(`0.10.0 → 0.11.0`), 고친 것뿐이면 패치(`0.10.0 → 0.10.1`). 메이저는 사람이 적을 때만 올린다. `M`보다 높아야 하고 `v\u003C버전>` 태그가 없어야 한다 — 머지(=배포) 전에 이것을 보는 곳은 여기뿐이다.\n\n**CHANGELOG 정리.** `dev-skills-src\u002Frelease-notes.md`의 \"릴리즈 정리\"대로 한다 — **외부 기여자 · 제보자 멘션 점검**과 **판의 모양**(히어로 그림 · 요약 문단 · 주제별 절 · Thanks)까지. 이 절이 그대로 GitHub Release 본문이 되므로 여기서 빠지면 끝이다. 아직 파일에 쓰지 않는다.\n히어로 그림은 `git cat-file -e origin\u002Fdevelop:assets\u002Frelease-\u003C버전>.png`로 있는지만 본다 — 없으면 그림 없이 가고, 확인 화면에 그렇다고 한 줄 적는다.\n\n**실린 작업.** `git log --first-parent --format='%s' v$M..origin\u002Fdevelop` — squash 커밋 제목의 `(#N)`이 PR이다. 확인 화면의 \"실리는 PR\"이 된다.\n\n**스킬 평가.** `git diff --name-only v$M origin\u002Fdevelop -- skills-src plugin\u002Fcli\u002Fhelp plugin\u002Fbin\u002Fhelp bin\u002Fhelp tests\u002Fevals tools\u002Fskill-eval.sh tools\u002Fskill-eval-codex.py`가 비어 있지 않으면 스킬 · 도움말이 바뀐 판이다 — 3단계에서 **PR을 연 뒤 CI와 나란히 두 스킬 평가를 돌린다.** 평가는 모델 호출이라 CI에 없다 — 배포 전에 여기서 한 번 잰다. 확인 화면에 한 줄로 싣고, 사용자가 빼라고 하면 뺀다. 바뀐 것이 없으면 싣지 않는다.\n\n이것을 한 화면으로 보이고 승인을 받는다.\n\n```\n0.10.0 → 0.11.0   (새 기능: 헤더 워드마크 · 파일 빠른 열기 …)\n── CHANGELOG [0.11.0] (정리본) ──\n히어로 assets\u002Frelease-0.11.0.png | 없음 — 그림 없이\n요약 …\n### \u003C주제> — 항목 머리 줄 …\n### Fixes — …\n### Thanks — @… | 없음\n── 외부 기여 ──  @Dwite #29 수정 · @sergei-lapin #30 제보 · #31 수정 (정리본에 멘션함) | 없음\n── 실리는 PR ──  #44 … · #45 … · #47 …\n── 스킬 평가 ──  스킬 · 도움말이 바뀌었다(skills-src 3 · cli\u002Fhelp 1) → PR을 연 뒤 CI와 나란히 Claude · Codex 평가를 돌린다(Claude 약 $4 · 5~10분, 빼려면 말씀)\n진행할까요? 버전 커밋 → develop에 밀고 PR → CI ∥ 스킬 평가 → 모두 초록이면 main 머지(배포) → 태그 · Release 순서로 끝까지 갑니다.\n```\n\n고쳐 달라면 고쳐 다시 보인다. 거절하면 아무것도 쓰지 않고 멈춘다.\n\n## 3. 버전 커밋 → PR → CI ∥ 스킬 평가\n\n**로컬 검증은 돌지 않는다.** develop에 코드가 들어오는 길은 `implement` PR뿐이고(그 5단계가 같은 다섯 — 스킬 두 벌 · 고지 사본 · CLI 판정 · 단위 · 린트 — 을 돈다), PR 없이 들어오는 것은 문서 · 주석과 버전 커밋(버전 문자열 여섯 파일)뿐이다. PR끼리 합쳐져 깨지는 것은 릴리즈 PR의 \"빌드 검증\"이 같은 다섯에 빌드 · CLI 계약까지 더해 **머지 전에** 잡는다. 그때 버전 커밋은 이미 develop에 있지만 배포 전이라, 4단계의 실패 경로대로 고침 PR로 이어 간다.\n\n```sh\n# CHANGELOG.md 의 [Unreleased] 를 승인받은 정리본으로 바꾼 뒤\nprintf '%s\\n' 0.11.0 > plugin\u002FVERSION\nsh tools\u002Fsync-version.sh            # 매니페스트 둘 · README 두 벌의 배지 · CHANGELOG 제목([Unreleased] → [0.11.0] — 날짜)\nsh tools\u002Fsync-version.sh --check\ngit diff --stat                     # plugin\u002FVERSION · plugin\u002F.claude-plugin\u002Fplugin.json · plugin\u002F.codex-plugin\u002Fplugin.json · README.md · README.ko.md · CHANGELOG.md 뿐이다\ngit commit -am \"0.11.0 릴리즈 — VERSION · 매니페스트 · 배지, CHANGELOG 정리(\u003C무엇을 합치고 고쳤나>)\"\ngit push origin HEAD:develop        # fast-forward 만\ngh pr create --base main --head develop --title \"0.11.0 릴리즈\" --body \"\u003C본문>\"\n```\n\n이 여섯 파일 밖이 바뀌었으면 밀지 말고 멈춘다 — PR 없이 develop에 바로 가는 예외는 버전 커밋뿐이다. 커밋 끝에는 세션의 공동 저자 줄을 붙인다. 푸시가 거부되면(그 사이 develop이 움직였다) 버전 커밋을 버리고(`git reset --hard origin\u002Fdevelop`) 2단계부터 다시 본다.\n\n본문: 첫 줄 \"`develop` → `main`. **merge commit으로 머지한다**(squash · rebase면 develop과 main이 갈라진다). 머지가 곧 배포다.\" 그다음 `[0.11.0]` 절의 요지 한 문단, 실린 PR 범위(`#44~#47`). 스킬 · 도움말이 바뀐 판이면 \"스킬 평가: CI와 나란히 도는 중 — 결과는 `스킬 평가` 상태와 코멘트\"(사용자가 뺐으면 \"스킬 평가: 뺐다(사용자)\")라고 적는다. 끝에 세션의 PR 서명 줄.\n\n**스킬 평가 — 2단계에서 실었으면 PR을 연 직후 돌린다.** CI(빌드 검증)는 PR을 열면 저절로 돌고, 평가는 그와 나란히 돈다. **먼저 PR head에 `스킬 평가`를 `pending`으로 올린다** — 4단계의 `gh pr checks --watch`는 이미 있는 체크만 기다려서, 상태가 없으면 CI가 끝나는 순간 평가가 돌고 있어도 초록으로 끝난다.\n\n```sh\nH=$(gh pr view \u003CN> --json headRefOid -q .headRefOid)     # 평가할 커밋 — 로컬 HEAD 와 같아야 한다(아니면 2단계부터)\nR=kakao\u002Fprevue\nst() { gh api repos\u002F$R\u002Fstatuses\u002F$H -f context=\"스킬 평가\" -f state=\"$1\" -f description=\"$2\"; }\nst pending \"Claude · Codex 평가 중\"\nsh tools\u002Fskill-eval.sh                       # Claude — tests\u002Fevals\u002Fcases\npython3 tools\u002Fskill-eval-codex.py            # Codex — tests\u002Fevals\u002Fcases + codex-cases. 터미널이 codex 를 감싸면 PREVUE_EVAL_CODEX 로 감싸지 않은 실행 파일을 준다\npython3 tools\u002Fskill-eval-codex.py --clean    # 끝나면 Codex 캐시에 둔 평가 플러그인을 지운다\nst success \"Claude 6\u002F6 · Codex 24\u002F24\"        # 결과대로 — 실패면 failure\ngh pr comment \u003CN> --body \"\u003C에이전트별 통과 수 · 실패한 케이스의 채점기와 이유 · 비용>\"\n```\n\n두 평가는 `run_in_background`로 나란히 띄운다. 4단계의 CI 기다림도 PR에 CI 체크가 붙은 것을 본 뒤 같이 띄운다. 셋 다 끝났다는 알림에 이어 간다.\n- 실패한 케이스는 그 케이스만 한 번 다시 돌린다(`--case \u003C이름>`) — 모델 행동이라 회차마다 흔들린다. 다시 돌려도 실패하면 `failure`로 올리고 **멈춰** 실패한 채점기 · 트레이스 요지를 보고한다. 사람이 그 결과를 보고 진행하라고 하면 그 말을 코멘트에 남기고 `success`(설명 \"사람 승인 — …\")로 올려 4단계로 간다.\n- `claude` · `codex`가 없거나 로그인이 안 됐으면 그 평가를 건너뛰고 `success`로 올리되 설명을 \"건너뜀(…)\"으로 **시작한다** — 평가 때문에 릴리즈를 멈추지 않는 대신 체크 목록에서 보이게 한다. 6단계 보고에도 싣는다.\n- 사용자가 2단계에서 평가를 뺐으면 돌리지 않고 `success`(설명 \"뺐다(사용자)\")를 바로 올린다 — 다시 불렸을 때 1단계가 빠진 평가로 읽지 않게.\n\n**상태가 없는 head.** 평가 도중이나 실패 뒤 고침으로 PR head가 바뀌면(develop이 움직였다) 새 head에는 상태가 없다. 1단계 · 4단계 모두 같은 규칙이다:\n\n```sh\ngit diff --name-only \u003C상태가 있는 앞 head> \u003C새 head> -- skills-src plugin\u002Fcli\u002Fhelp plugin\u002Fbin\u002Fhelp bin\u002Fhelp tests\u002Fevals tools\u002Fskill-eval.sh tools\u002Fskill-eval-codex.py\n```\n\n비었으면 앞 결과를 새 head에 그대로 올리고(설명 끝에 \"· 앞 커밋 \u003C짧은 sha> 결과\"), 아니면 새 head에서 평가를 다시 돌린다. 앞 head는 PR 코멘트의 평가 결과나 `gh api $GHE repos\u002F$R\u002Fcommits\u002F\u003Csha>\u002Fstatus`로 찾는다.\n\n## 4. CI · 평가를 기다리고 머지\n\n```sh\ngh pr checks \u003CN> --watch --fail-fast\n```\n\n\"빌드 검증\"(약 7~10분)이 초록이어야 하고, 스킬 평가를 실은 판이면 PR head의 `스킬 평가` 상태도 `success`여야 한다 — 3단계가 `pending`부터 올려 두어 `gh pr checks`가 둘을 함께 기다린다. 머지 직전에 PR head와 그 상태가 붙은 커밋이 같은지 한 번 더 본다(다르면 3단계의 \"상태가 없는 head\"). 빌드 검증은 CI(Ubuntu)에서 돌아 macOS에서만 통과하는 것도 잡는다. 막 연 PR은 체크가 아직 안 붙어 \"no checks\"로 끝날 수 있다 — 그러면 조금 뒤 다시 본다.\n기다림은 `run_in_background`로 돌리고 끝났다는 알림에 이어 간다(포그라운드 sleep은 막혀 있다).\n\n실패하면 **머지하지 않고 멈추고** 어느 체크 · 어느 스텝이 무엇으로 실패했는지(`gh run view \u003Cid> --log-failed`의 요지 · 평가의 채점기) 보고한다. 고치는 일은 이 스킬 밖이다 — 평소처럼 작업 PR을 develop에 넣고 `\u002Fship`을 다시 치면 PR에 새 커밋이 실려 4단계부터 이어진다. 버전 커밋을 되돌리지 않는다 — 머지 전이라 사용자에게 간 것은 없다. 새 head에는 `스킬 평가` 상태가 없으니 3단계의 \"상태가 없는 head\"대로 한다.\n\n초록이면:\n\n```sh\ngh pr merge \u003CN> --merge             # merge commit. --delete-branch 를 붙이지 않는다 — head 가 develop 이다\n```\n\n이 순간이 배포다. 마켓플레이스 둘이 `main`을 읽는다.\n\n## 5. 기록 — 태그 · GitHub Release\n\n```sh\ngh workflow run 릴리즈 --ref main\ngh run list --workflow 릴리즈 --branch main --limit 1 --json databaseId,status,createdAt   # 방금 뜬 실행인지 createdAt 으로 본다\ngh run watch \u003Cid> --exit-status\ngh release view v0.11.0 --json tagName,url\n```\n\n태그가 이미 있으면 워크플로가 아무것도 하지 않는다 — 다시 돌려도 안전하다. Release를 만들지 못했으면(태그는 나갔다) 실패 스텝을 보고하고 6단계(보고)로 간다 — 설치하는 사람에게 영향이 없다.\n\n## 6. 보고\n\n버전 · PR 링크 · 머지 커밋 · Release 링크 · 스킬 평가 결과(돌렸으면)를 한 덩어리로 말한다. 건너뛰거나 실패한 단계가 있으면 그대로 말한다.\n",{"name":5,"description":7},"main","367545866c18ddac4a3e1f9530ba98859ee3c38f",".claude\u002Fskills\u002Fship",5,"https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue","https:\u002F\u002Fgithub.com\u002Fkakao","http:\u002F\u002Ftech.kakao.com\u002F","2026-11-14 00:17:09",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add kakao\u002Fprevue --skill ship",{"tool":37,"command":38},"bunx","bunx skills add kakao\u002Fprevue --skill ship",{"tool":40,"command":41},"pnpm","pnpm dlx skills add kakao\u002Fprevue --skill ship","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fship\u002FSKILL.md",true,[],[46,53,58,63,68,75],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M7FCGENPWS39YTT1D0F5FEP9","prevue","Renders Jetpack Compose @Preview in the browser, lets you edit it and check the result yourself, and reads what a person points at on screen as a file and line. Use it when changing Compose UI or matching it to a mockup or screenshot, when asked \"how does it look\", and when the user points at something on screen with words like \"this\" or \"here\". Also use it when asked whether the preview is ready (\"is the preview ready?\") or told to prepare the preview (read the build settings).","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002Fskills-src\u002Fprevue\u002FSKILL.md",[],[],{"skillNo":54,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M7FCG8E29RWQS0Z3PB1K93RJ","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fcodex\u002Fprevue\u002FSKILL.md",[],[],{"skillNo":59,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":18},"01M7FCG33JZFA79RGK0TFXZCKS","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fclaude\u002Fprevue\u002FSKILL.md",[],[],{"skillNo":64,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7FCFZMPWT3EQZ5Y130QTS23","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002Fdev-skills-src\u002Fship\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7FCFSE4ER2EJ9A47C9FYWZV","implement","Prevue 저장소의 코드를 바꾸는 작업을 그 작업의 워크트리 안에서 계획 합의부터 머지 · 치우기까지 끝까지 간다. PR로 가는 경로(src · bin · viewer · skills-src · dev-skills-src · tools · 워크플로 · 빌드 파일)를 고치거나 기능을 더해 달라는 요청에 쓴다 — 원인 조사 · 질문 · 문서만 고치는 일에는 쓰지 않는다. \u002Fimplement로도 부르고(\u002Fimplement grill이면 grilling으로 계획한다), 멈춘 자리부터 이어 간다.","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002Fdev-skills-src\u002Fimplement\u002FSKILL.md",[],[],{"skillNo":76,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7FCFJ9YVX3VG0D571DRKCS8","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fimplement\u002FSKILL.md",[],[]]