[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CAA8CRMPCMJC3CZ2ZCQ8V1":3,"skill-same:01M7CAA8CRMPCMJC3CZ2ZCQ8V1":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M7CAA8CRMPCMJC3CZ2ZCQ8V1","issue",null,"이슈 트래커의 키(local 기본 · jira\u002Fgithub 어댑터 — `HX-a3f8` · `ABC-123` 꼴) 한 건 또는 여러 건의 개발 전 주기를 진행하는 라우터 — 브랜치·상태 JSON(start), 결정 인터뷰(grill), 계획 워크플로와 승인(plan), 구현(implement), Codex+워크플로 리뷰(verify), 컴파일·테스트 게이트(gate), 훅이 판정하는 commit\u002Fpush, 마감(complete: push·wiki·트래커 전이). 사용자가 \"caseworker:issue KEY\", \"KEY 시작\u002F착수\u002F잡아줘\", \"이어서 해줘\", \"계획 세워줘\", \"리뷰 돌려줘\", \"게이트\u002F테스트 돌려줘\", \"커밋해줘\", \"push 해줘\", \"마무리\u002FQA 넘겨줘\u002F완료 처리\" 라고 하거나, 현재 브랜치가 이슈 브랜치(feat\u002FKEY…)이면 반드시 이 스킬을 쓴다. 명시 호출이 없어도 이슈 키가 언급된 개발 요청이면 이 스킬로 지금 어느 단계인지부터 정한다.","bigbulgogiburger\u002Fcaseworker","bigbulgogiburger","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F77317742?v=4","01M7BZH0X5CCS78Q50RHQNKACQ","dohoon pyun","01M7CA9ZXMGYBRB61NDY5V18WQ",0,"MIT","https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger\u002Fcaseworker\u002Fblob\u002Fmain\u002Fcodex-overlay\u002Fskills\u002Fissue\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: issue\ndescription: >-\n  이슈 트래커의 키(local 기본 · jira\u002Fgithub 어댑터 — `HX-a3f8` · `ABC-123` 꼴) 한 건 또는 여러 건의\n  개발 전 주기를 진행하는 라우터 — 브랜치·상태 JSON(start), 결정 인터뷰(grill), 계획 워크플로와 승인(plan),\n  구현(implement), Codex+워크플로 리뷰(verify), 컴파일·테스트 게이트(gate), 훅이 판정하는 commit\u002Fpush,\n  마감(complete: push·wiki·트래커 전이).\n  사용자가 \"caseworker:issue KEY\", \"KEY 시작\u002F착수\u002F잡아줘\", \"이어서 해줘\", \"계획 세워줘\", \"리뷰 돌려줘\",\n  \"게이트\u002F테스트 돌려줘\", \"커밋해줘\", \"push 해줘\", \"마무리\u002FQA 넘겨줘\u002F완료 처리\" 라고 하거나, 현재 브랜치가\n  이슈 브랜치(feat\u002FKEY…)이면 반드시 이 스킬을 쓴다. 명시 호출이 없어도 이슈 키가 언급된 개발 요청이면\n  이 스킬로 지금 어느 단계인지부터 정한다.\n---\n> Codex 질문: `request_user_input`은 해당 도구가 제공되는 Plan 모드에서만 사용한다. 현재 도구 스키마를 따른다. `preview` 필드는 없다. 다른 모드에서는 제공되는 비동기 질문 도구 또는 짧은 일반 질문을 사용한다. 승인과 선호도 질문을 구분하고, 무응답을 승인으로 간주하지 않는다.\n\n\n# caseworker:issue — 이슈 라우터\n\n`caseworker:issue \u003CKEY[,KEY…]> [--adopt] [--stage \u003C단계>] [--unattended]`\n\n## 0. 원칙 (왜 이렇게 나뉘어 있나)\n\n- **이 스킬은 판단만 한다.** 브랜치·상태 JSON·게이트·리뷰 기록은 전부 `scripts\u002F` 가 쓰고, `git commit`\u002F`git push` 는 훅이 판정한다.\n  모델이 상태 JSON 의 `gate`\u002F`review` 를 손으로 쓰면 훅과 어긋나 막히거나, 더 나쁘게는 게이트 없이 통과한다.\n- 기록의 신선도는 **git 트리 id** 로 잰다. \"테스트 돌렸다\" 는 말은 증거가 아니고, 게이트가 본 트리와 커밋될 트리가 같아야 통과다.\n- 사람 결정(승인·human DoD)은 건너뛰지 않는다. 무인 모드에서는 권장안을 택하되 **그렇게 했다고 기록**한다.\n\n## 1. 매 호출 첫 동작 — 지금 어디인가\n\n`\u003CP>` = 플러그인 루트 절대 경로. 이 스킬이 로드될 때 표시되는 `Base directory for this skill` 의 **두 단계 위**다(`skills\u002Fissue` 의 부모의 부모). 아래 모든 명령의 `\u003CP>` 를 그 경로로 치환하고, 프로젝트 루트(또는 그 worktree)에서 실행한다.\n\n```bash\nnode \"\u003CP>\u002Fscripts\u002Fissue-start.mjs\" --status --json\n```\n\n| `code` | 뜻 | 다음 |\n|--------|----|------|\n| `NO_HARNESS` | 이 저장소는 설정 전 | `caseworker:setup` 을 안내하고 멈춘다 |\n| `OUTSIDE_PATTERN` | 이슈 브랜치가 아니다 | 키가 있으면 **start**(기본 브랜치에서 새 브랜치). 현재 브랜치를 그대로 쓰려면 `--adopt` |\n| `NO_STATE` | 이슈 브랜치인데 상태 없음 | **start** (`issue-start.mjs \u003CKEY>` — 브랜치는 그대로 두고 상태만 만든다) |\n| `OK` | 진행 중 | 출력의 `stage`·`next` 대로 §2 의 그 단계부터. `--stage` 가 있으면 그 단계로 점프(뒤로 가는 재계획도 허용) |\n\n사용자의 말이 `next` 보다 우선이다 — \"커밋해줘\" 는 stage 와 무관하게 **gate → commit** 이다.\n\n## 2. 단계 표 — 각 행의 절차는 [references\u002Fstages.md](references\u002Fstages.md) 의 같은 이름 절을 읽고 따른다\n\n트래커는 어댑터 하나다(기본 `local` — 파일, 의존성 0). 어댑터별로 라우터가 무엇을 더 해야 하는지·키 형식은 [references\u002Ftrackers.md](references\u002Ftrackers.md).\n\n| stage | 한 줄 | 주체 · 수단 | 끝나면 |\n|-------|------|------------|--------|\n| start | 브랜치 채택\u002F생성 · 상태 JSON · 트래커 착수(전이·댓글·본문 읽기) | `issue-start.mjs` + 트래커 op(출력 `tracker.ops` — direct 면 이미 실행됨, router 면 라우터가 MCP 로 수행) | grill (키 3개+ 또는 범위 불명이면 먼저 recon) |\n| recon | 결정 분기점만 찾는 정찰(선택) | 메인 또는 허용된 `spawn_agent` (recon 계약: references\u002Fstages.md) (sonnet) | grill |\n| grill | 분기점을 **한 번에 하나씩** 묻고 확정 | `caseworker:grilling` 을 그 자리에서 따른다 | `issue-set.mjs --decision` · `--stage plan` |\n| plan | dev-guide 초안 + 레인·DoD 설계 → **사용자 승인** | 메인 또는 허용된 `spawn_agent` (plan 계약: references\u002Fstages.md) → `issue-set.mjs --merge --from plan` → request_user_input | 승인 시 `.draft` 확정 · `wiki-row.mjs` forecast · `--stage implement` |\n| implement | 코드 작성 — 레인 1개면 메인 직접. 2개+ 는 **Herdr 안 + `herdr.lanes` 가 `implement`\u002F`all`** 이면 레인마다 worktree + kind(claude·codex·grok) pane 이 driver 옆에서 고치고 메인이 패치를 회수·적용, Herdr 밖이면 메인 순차(또는 허용된 `spawn_agent`) | 직접 \u002F `herdr-lanes.mjs implement`([herdr-lanes.md](references\u002Fherdr-lanes.md) §implement) \u002F `spawn_agent` (implement 계약: references\u002Fstages.md) | verify |\n| verify | **Codex 판정** → (Codex 가 못 채운 자리에만) 워크플로 ≤4레인 → **메인이 확정\u002F기각** → 기록 | `codex-review.sh` → `lanes-codex.mjs verify` → `issue-set.mjs --review` | gate |\n| gate | 커밋 전 경량(컴파일·린트) \u002F push 전 — `gate.push_level` 이 `related` 면 **관련 테스트**(DoD 프로브 → 바뀐 스택의 컴파일·린트·관련 테스트), `full`(기본)이면 전량(빌드·전체 테스트·extra까지) | `gate.mjs --commit` \u002F `gate.mjs --related` 또는 `--full` | commit \u002F push |\n| commit·push | 평소처럼 `git commit` \u002F `git push` — 훅이 판정 | 훅 (`hooks\u002Fhooks.json`) · 무인은 `safe-commit.mjs` | 다음 구현 또는 complete |\n| complete | push 전 게이트·리뷰 신선 확인 → push → 상태 아카이브 → wiki closure → 트래커 전이·댓글 | `issue-complete.mjs` → `wiki-row.mjs` → `wiki-lint.mjs` → 트래커 op(출력 `tracker.ops` — direct 면 이미 실행됨, router 면 라우터가 MCP 로 수행) | 사람 머지 대기 (자동 머지 금지) |\n| main 배치 | (`push_level=related`) 여러 이슈를 기본 브랜치에 머지한 **뒤 한 번** — 전 스택 빌드·전체 테스트·extra. 이슈마다 돌리지 않는다 | `gate.mjs --main` (`--status` = 마지막 PASS 이후 커밋 수) | 배포·릴리즈 전 PASS 확인. FAIL 이면 용의 커밋부터 |\n\n## 3. 훅이 막았을 때 — 사유 코드는 stderr 의 `[caseworker] git \u003Cop>: \u003CCODE> — …` 한 줄\n\n| 코드 | 뜻 | 조치 |\n|------|----|------|\n| `BRANCH_PATTERN` | 이슈 브랜치가 아니고 상태도 없다 | `issue-start.mjs \u003CKEY> --adopt`(이 브랜치를 채택) 또는 기본 브랜치로 가서 start |\n| `NO_STATE` | 이슈가 시작되지 않았다 | `issue-start.mjs \u003CKEY>` |\n| `COMPLETED` | complete 가 상태를 아카이브한 브랜치에 **코드** 커밋 | closure 문서(CHANGELOG·wiki)는 docs-only 로 통과한다. 코드를 더 바꾸려면 `issue-start.mjs \u003CKEY> --adopt` 로 다시 시작 |\n| `DIRTY_TREE` | 게이트가 본 트리 ≠ 커밋될 트리(unstaged·untracked) | 전부 `git add -A` 하거나 `gate.mjs --commit --stage-all` |\n| `NO_GATE` `GATE_STALE` `GATE_FAIL` `GATE_LOG_*` | 게이트 미실행·낡음·실패·로그 불일치 | `gate.mjs --commit` (push 면 사유에 적힌 `--related`\u002F`--full`) 재실행 |\n| `GATE_LEVEL` | push 인데 그 단계 게이트 기록이 없다(경량뿐 · 또는 `push_level=full` 인데 관련 테스트 기록) | 사유에 적힌 명령 — `push_level=related` 면 `gate.mjs --related`, 아니면 `gate.mjs --full` |\n| `NO_REVIEW` `REVIEW_STALE` | 리뷰 없음 · 리뷰 이후 코드 변경 | verify — 이미 한 번 했으면 **델타 패스**만 |\n| `REVIEW_BLOCKERS` | 확정 blocker 미해결 | 수정 → 델타 패스 |\n| `BAD_STATE` | 상태 JSON 이 스키마에 안 맞는다(손으로 고친 흔적) | `issue-set.mjs` 로 값을 고치거나 `issue-start.mjs \u003CKEY>` 로 다시 만든다 |\n| `BAD_CONFIG` `HOOK_ERROR` | harness.json 이 스키마에 안 맞거나 판정 중 예외(fail-closed). 명령의 `cd`\u002F`-C` 가 없는 경로를 가리켜도 여기다 | 코드 문제가 아니다 — `caseworker:setup` 으로 설정을 고친다(우회 금지). \"판정할 디렉토리가 없다\" 면 `cd` 를 변수·`~` 가 아닌 실제 경로로 |\n\n`issue-complete.mjs` 는 같은 사다리에 `CLAUDE_MD_TOO_LONG`·`PUSH_FAILED` 를 더한다(stages.md §complete). `DOCS_ONLY`·`MODE_OFF`·suggest 경고는 통과다. docs-only 는 `git add … && git commit` · `commit -a` 처럼 한 명령이 스테이징까지 하면 스테이징 *예정* 파일(staged+unstaged+untracked)로 판정한다 — 훅은 명령 실행 *전*에 보므로 그때 인덱스는 비어 있다. 훅을 우회하려고 `--no-verify` 나 상태 JSON 편집을 쓰지 않는다 — 막힌 이유를 고치는 것이 항상 더 짧다.\n\n## 4. 변형\n\n- **`--unattended`(무인)**: request_user_input 을 부르지 않고 권장안을 택한다(결정·승인에 `(unattended)` 표기). 사람 게이트(human DoD·머지)에 닿으면 멈추고 보고. 커밋은 `node \"\u003CP>\u002Fscripts\u002Fsafe-commit.mjs\" -m \"\u003C메시지>\" [--push]` — 훅과 같은 판정을 스크립트가 하고 통과할 때만 커밋한다(훅이 발화하지 않는 헤드리스 경로에서도 같은 규율).\n- **Codex 위임**: 역할 원고는 `subagents\u002F*.toml`의 `developer_instructions`다. 위임이 허용되면 `spawn_agent`에 원고와 범위·입출력 계약을 전달하고, 아니면 메인이 순차 수행한다. 검증 레인은 `scripts\u002Flanes-codex.mjs verify`가 `{findings, lanes, dropped, delta}`를 반환한다. 실패 레인은 검증 완료로 세지 않는다. **구현 레인은 Herdr 안이면 `scripts\u002Fherdr-lanes.mjs implement`** 가 레인마다 worktree + kind pane 을 띄우고 패치를 회수한다(Node 스크립트라 Codex 에서도 그대로 돈다) — Herdr 밖이면 메인이 순차 구현한다.\n- **트래커가 router 인데 MCP 가 없는 세션**: 코드 진행은 그대로 한다. `tracker.ops`(전이·댓글)를 수행하지 못했다는 사실을 보고에 \"트래커 미반영: `\u003CKEY>` transition(…) — MCP 도구 없음\" 으로 남기고, 사람이 직접 처리하거나 MCP 연결 후 재실행하게 한다. 수행하지 못한 op 를 \"완료\" 로 적지 않는다.\n- **다중 키** `HX-a3f8,HX-b2c1`(jira 면 `ABC-696,ABC-940`): 브랜치 `feat\u002FHX-a3f8-b2c1` 하나, dev-guide 한 장, 상태 JSON 하나. 트래커 op 는 키마다 만들어진다.\n- **worktree**: 어느 worktree 에서 실행해도 상태·로그는 메인 저장소의 runtime 에 쓰인다 — 같은 브랜치의 게이트 기록을 worktree 와 메인이 공유한다.\n- `harness.json` 의 게이트 명령이 틀렸으면 이 스킬에서 고치지 않는다 — `caseworker:setup` 의 일이다.\n\n## 5. 멈출 때마다 보고 (5줄 이내)\n\n`stage` · 방금 한 것 · 훅\u002F게이트\u002F리뷰 결과 코드와 분모(테스트 N건, blocker N건) · 다음 한 수 · 사용자 결정이 필요한지.\n","> Codex 질문: `request_user_input`은 해당 도구가 제공되는 Plan 모드에서만 사용한다. 현재 도구 스키마를 따른다. `preview` 필드는 없다. 다른 모드에서는 제공되는 비동기 질문 도구 또는 짧은 일반 질문을 사용한다. 승인과 선호도 질문을 구분하고, 무응답을 승인으로 간주하지 않는다.\n\n\n# caseworker:issue — 이슈 라우터\n\n`caseworker:issue \u003CKEY[,KEY…]> [--adopt] [--stage \u003C단계>] [--unattended]`\n\n## 0. 원칙 (왜 이렇게 나뉘어 있나)\n\n- **이 스킬은 판단만 한다.** 브랜치·상태 JSON·게이트·리뷰 기록은 전부 `scripts\u002F` 가 쓰고, `git commit`\u002F`git push` 는 훅이 판정한다.\n  모델이 상태 JSON 의 `gate`\u002F`review` 를 손으로 쓰면 훅과 어긋나 막히거나, 더 나쁘게는 게이트 없이 통과한다.\n- 기록의 신선도는 **git 트리 id** 로 잰다. \"테스트 돌렸다\" 는 말은 증거가 아니고, 게이트가 본 트리와 커밋될 트리가 같아야 통과다.\n- 사람 결정(승인·human DoD)은 건너뛰지 않는다. 무인 모드에서는 권장안을 택하되 **그렇게 했다고 기록**한다.\n\n## 1. 매 호출 첫 동작 — 지금 어디인가\n\n`\u003CP>` = 플러그인 루트 절대 경로. 이 스킬이 로드될 때 표시되는 `Base directory for this skill` 의 **두 단계 위**다(`skills\u002Fissue` 의 부모의 부모). 아래 모든 명령의 `\u003CP>` 를 그 경로로 치환하고, 프로젝트 루트(또는 그 worktree)에서 실행한다.\n\n```bash\nnode \"\u003CP>\u002Fscripts\u002Fissue-start.mjs\" --status --json\n```\n\n| `code` | 뜻 | 다음 |\n|--------|----|------|\n| `NO_HARNESS` | 이 저장소는 설정 전 | `caseworker:setup` 을 안내하고 멈춘다 |\n| `OUTSIDE_PATTERN` | 이슈 브랜치가 아니다 | 키가 있으면 **start**(기본 브랜치에서 새 브랜치). 현재 브랜치를 그대로 쓰려면 `--adopt` |\n| `NO_STATE` | 이슈 브랜치인데 상태 없음 | **start** (`issue-start.mjs \u003CKEY>` — 브랜치는 그대로 두고 상태만 만든다) |\n| `OK` | 진행 중 | 출력의 `stage`·`next` 대로 §2 의 그 단계부터. `--stage` 가 있으면 그 단계로 점프(뒤로 가는 재계획도 허용) |\n\n사용자의 말이 `next` 보다 우선이다 — \"커밋해줘\" 는 stage 와 무관하게 **gate → commit** 이다.\n\n## 2. 단계 표 — 각 행의 절차는 [references\u002Fstages.md](references\u002Fstages.md) 의 같은 이름 절을 읽고 따른다\n\n트래커는 어댑터 하나다(기본 `local` — 파일, 의존성 0). 어댑터별로 라우터가 무엇을 더 해야 하는지·키 형식은 [references\u002Ftrackers.md](references\u002Ftrackers.md).\n\n| stage | 한 줄 | 주체 · 수단 | 끝나면 |\n|-------|------|------------|--------|\n| start | 브랜치 채택\u002F생성 · 상태 JSON · 트래커 착수(전이·댓글·본문 읽기) | `issue-start.mjs` + 트래커 op(출력 `tracker.ops` — direct 면 이미 실행됨, router 면 라우터가 MCP 로 수행) | grill (키 3개+ 또는 범위 불명이면 먼저 recon) |\n| recon | 결정 분기점만 찾는 정찰(선택) | 메인 또는 허용된 `spawn_agent` (recon 계약: references\u002Fstages.md) (sonnet) | grill |\n| grill | 분기점을 **한 번에 하나씩** 묻고 확정 | `caseworker:grilling` 을 그 자리에서 따른다 | `issue-set.mjs --decision` · `--stage plan` |\n| plan | dev-guide 초안 + 레인·DoD 설계 → **사용자 승인** | 메인 또는 허용된 `spawn_agent` (plan 계약: references\u002Fstages.md) → `issue-set.mjs --merge --from plan` → request_user_input | 승인 시 `.draft` 확정 · `wiki-row.mjs` forecast · `--stage implement` |\n| implement | 코드 작성 — 레인 1개면 메인 직접. 2개+ 는 **Herdr 안 + `herdr.lanes` 가 `implement`\u002F`all`** 이면 레인마다 worktree + kind(claude·codex·grok) pane 이 driver 옆에서 고치고 메인이 패치를 회수·적용, Herdr 밖이면 메인 순차(또는 허용된 `spawn_agent`) | 직접 \u002F `herdr-lanes.mjs implement`([herdr-lanes.md](references\u002Fherdr-lanes.md) §implement) \u002F `spawn_agent` (implement 계약: references\u002Fstages.md) | verify |\n| verify | **Codex 판정** → (Codex 가 못 채운 자리에만) 워크플로 ≤4레인 → **메인이 확정\u002F기각** → 기록 | `codex-review.sh` → `lanes-codex.mjs verify` → `issue-set.mjs --review` | gate |\n| gate | 커밋 전 경량(컴파일·린트) \u002F push 전 — `gate.push_level` 이 `related` 면 **관련 테스트**(DoD 프로브 → 바뀐 스택의 컴파일·린트·관련 테스트), `full`(기본)이면 전량(빌드·전체 테스트·extra까지) | `gate.mjs --commit` \u002F `gate.mjs --related` 또는 `--full` | commit \u002F push |\n| commit·push | 평소처럼 `git commit` \u002F `git push` — 훅이 판정 | 훅 (`hooks\u002Fhooks.json`) · 무인은 `safe-commit.mjs` | 다음 구현 또는 complete |\n| complete | push 전 게이트·리뷰 신선 확인 → push → 상태 아카이브 → wiki closure → 트래커 전이·댓글 | `issue-complete.mjs` → `wiki-row.mjs` → `wiki-lint.mjs` → 트래커 op(출력 `tracker.ops` — direct 면 이미 실행됨, router 면 라우터가 MCP 로 수행) | 사람 머지 대기 (자동 머지 금지) |\n| main 배치 | (`push_level=related`) 여러 이슈를 기본 브랜치에 머지한 **뒤 한 번** — 전 스택 빌드·전체 테스트·extra. 이슈마다 돌리지 않는다 | `gate.mjs --main` (`--status` = 마지막 PASS 이후 커밋 수) | 배포·릴리즈 전 PASS 확인. FAIL 이면 용의 커밋부터 |\n\n## 3. 훅이 막았을 때 — 사유 코드는 stderr 의 `[caseworker] git \u003Cop>: \u003CCODE> — …` 한 줄\n\n| 코드 | 뜻 | 조치 |\n|------|----|------|\n| `BRANCH_PATTERN` | 이슈 브랜치가 아니고 상태도 없다 | `issue-start.mjs \u003CKEY> --adopt`(이 브랜치를 채택) 또는 기본 브랜치로 가서 start |\n| `NO_STATE` | 이슈가 시작되지 않았다 | `issue-start.mjs \u003CKEY>` |\n| `COMPLETED` | complete 가 상태를 아카이브한 브랜치에 **코드** 커밋 | closure 문서(CHANGELOG·wiki)는 docs-only 로 통과한다. 코드를 더 바꾸려면 `issue-start.mjs \u003CKEY> --adopt` 로 다시 시작 |\n| `DIRTY_TREE` | 게이트가 본 트리 ≠ 커밋될 트리(unstaged·untracked) | 전부 `git add -A` 하거나 `gate.mjs --commit --stage-all` |\n| `NO_GATE` `GATE_STALE` `GATE_FAIL` `GATE_LOG_*` | 게이트 미실행·낡음·실패·로그 불일치 | `gate.mjs --commit` (push 면 사유에 적힌 `--related`\u002F`--full`) 재실행 |\n| `GATE_LEVEL` | push 인데 그 단계 게이트 기록이 없다(경량뿐 · 또는 `push_level=full` 인데 관련 테스트 기록) | 사유에 적힌 명령 — `push_level=related` 면 `gate.mjs --related`, 아니면 `gate.mjs --full` |\n| `NO_REVIEW` `REVIEW_STALE` | 리뷰 없음 · 리뷰 이후 코드 변경 | verify — 이미 한 번 했으면 **델타 패스**만 |\n| `REVIEW_BLOCKERS` | 확정 blocker 미해결 | 수정 → 델타 패스 |\n| `BAD_STATE` | 상태 JSON 이 스키마에 안 맞는다(손으로 고친 흔적) | `issue-set.mjs` 로 값을 고치거나 `issue-start.mjs \u003CKEY>` 로 다시 만든다 |\n| `BAD_CONFIG` `HOOK_ERROR` | harness.json 이 스키마에 안 맞거나 판정 중 예외(fail-closed). 명령의 `cd`\u002F`-C` 가 없는 경로를 가리켜도 여기다 | 코드 문제가 아니다 — `caseworker:setup` 으로 설정을 고친다(우회 금지). \"판정할 디렉토리가 없다\" 면 `cd` 를 변수·`~` 가 아닌 실제 경로로 |\n\n`issue-complete.mjs` 는 같은 사다리에 `CLAUDE_MD_TOO_LONG`·`PUSH_FAILED` 를 더한다(stages.md §complete). `DOCS_ONLY`·`MODE_OFF`·suggest 경고는 통과다. docs-only 는 `git add … && git commit` · `commit -a` 처럼 한 명령이 스테이징까지 하면 스테이징 *예정* 파일(staged+unstaged+untracked)로 판정한다 — 훅은 명령 실행 *전*에 보므로 그때 인덱스는 비어 있다. 훅을 우회하려고 `--no-verify` 나 상태 JSON 편집을 쓰지 않는다 — 막힌 이유를 고치는 것이 항상 더 짧다.\n\n## 4. 변형\n\n- **`--unattended`(무인)**: request_user_input 을 부르지 않고 권장안을 택한다(결정·승인에 `(unattended)` 표기). 사람 게이트(human DoD·머지)에 닿으면 멈추고 보고. 커밋은 `node \"\u003CP>\u002Fscripts\u002Fsafe-commit.mjs\" -m \"\u003C메시지>\" [--push]` — 훅과 같은 판정을 스크립트가 하고 통과할 때만 커밋한다(훅이 발화하지 않는 헤드리스 경로에서도 같은 규율).\n- **Codex 위임**: 역할 원고는 `subagents\u002F*.toml`의 `developer_instructions`다. 위임이 허용되면 `spawn_agent`에 원고와 범위·입출력 계약을 전달하고, 아니면 메인이 순차 수행한다. 검증 레인은 `scripts\u002Flanes-codex.mjs verify`가 `{findings, lanes, dropped, delta}`를 반환한다. 실패 레인은 검증 완료로 세지 않는다. **구현 레인은 Herdr 안이면 `scripts\u002Fherdr-lanes.mjs implement`** 가 레인마다 worktree + kind pane 을 띄우고 패치를 회수한다(Node 스크립트라 Codex 에서도 그대로 돈다) — Herdr 밖이면 메인이 순차 구현한다.\n- **트래커가 router 인데 MCP 가 없는 세션**: 코드 진행은 그대로 한다. `tracker.ops`(전이·댓글)를 수행하지 못했다는 사실을 보고에 \"트래커 미반영: `\u003CKEY>` transition(…) — MCP 도구 없음\" 으로 남기고, 사람이 직접 처리하거나 MCP 연결 후 재실행하게 한다. 수행하지 못한 op 를 \"완료\" 로 적지 않는다.\n- **다중 키** `HX-a3f8,HX-b2c1`(jira 면 `ABC-696,ABC-940`): 브랜치 `feat\u002FHX-a3f8-b2c1` 하나, dev-guide 한 장, 상태 JSON 하나. 트래커 op 는 키마다 만들어진다.\n- **worktree**: 어느 worktree 에서 실행해도 상태·로그는 메인 저장소의 runtime 에 쓰인다 — 같은 브랜치의 게이트 기록을 worktree 와 메인이 공유한다.\n- `harness.json` 의 게이트 명령이 틀렸으면 이 스킬에서 고치지 않는다 — `caseworker:setup` 의 일이다.\n\n## 5. 멈출 때마다 보고 (5줄 이내)\n\n`stage` · 방금 한 것 · 훅\u002F게이트\u002F리뷰 결과 코드와 분모(테스트 N건, blocker N건) · 다음 한 수 · 사용자 결정이 필요한지.\n",{"name":5,"description":7},"main","48dfccc7d94787d915eed6ea6ac4a5d432077a02","codex-overlay\u002Fskills\u002Fissue","https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger\u002Fcaseworker","https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger","But Big-Mac is my favorite","2026-11-02 12:17:40",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add bigbulgogiburger\u002Fcaseworker --skill issue",{"tool":37,"command":38},"bunx","bunx skills add bigbulgogiburger\u002Fcaseworker --skill issue",{"tool":40,"command":41},"pnpm","pnpm dlx skills add bigbulgogiburger\u002Fcaseworker --skill issue","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger\u002Fcaseworker\u002Fblob\u002Fmain\u002Fcodex-overlay\u002Fskills\u002Fissue\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"references\u002Fstages.md","REFERENCE","参考文档",25499,"https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger\u002Fcaseworker\u002Fblob\u002Fmain\u002Fcodex-overlay\u002Fskills\u002Fissue\u002Freferences\u002Fstages.md",[52,59,66,73,80,86],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M7CABQTHV28VVSS1Q14S7D08","setup","프로젝트에 caseworker 를 설치·점검·업그레이드하는 스킬 — 스택 자동 감지 → 트래커 선택(기본 local, 의존성 0) → harness.json 작성(멱등) → 마켓플레이스\u002F플러그인 등록 → 전제 체크리스트 → 위반 주입 6종으로 게이트가 실제로 작동하는지 실측 확인까지 한 번에 진행한다. 사용자가 \"하네스 설치\", \"하네스 설정\", \"하네스 셋업\", \"이 프로젝트에 caseworker 붙여줘\", \"게이트 설정해줘\", \"harness.json 만들어줘\", \"트래커 바꿔줘\", \"v2 에서 올려줘\", \"jira-harness 에서 옮겨줘\", \"업그레이드 해줘\", \"harness 점검\", \"harness check\" 라고 하면 **반드시** 이 스킬을 쓴다. `.claude\u002Fharness.json` 이 없어 `\u002Fcaseworker:issue` 가 `NO_HARNESS` 를 보고할 때도 이 스킬로 보낸다.","https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger\u002Fcaseworker\u002Fblob\u002Fmain\u002Fskills\u002Fsetup\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7CABKJMFFE9T1K8TFFN4MVD","new","이슈 생성 — 자연어 한 줄 또는 문서(계획서·RFC·주차 계획)를 읽어 트래커에 이슈를 만든다. local 트래커면 `cases.mjs` 로 즉시, jira 면 MCP 로. 문서 기반이면 에픽→이슈→하위이슈 계층(parent-child 링크)으로 일괄 등록한다. '이슈 만들어줘', '이슈 등록', '이슈 생성', '에픽 만들어줘', '스토리 추가', '백로그에 추가', '이 문서 보고 이슈 등록해줘', '계획 문서를 이슈로 옮겨줘', '지라 이슈 등록해줘', '\u002Fcaseworker:new' 등의 요청에 반드시 이 스킬을 사용하세요. 워크플로의 시작점으로, `\u002Fcaseworker:issue` 착수 이전에 사용합니다.","https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger\u002Fcaseworker\u002Fblob\u002Fmain\u002Fskills\u002Fnew\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7CABB9JGYXGJ7WHQ76DG5SQ","loop","완성도 루프 엔진 — 임의의 코드 프로젝트에 까는 재사용 loop engineering 프레임워크 (Addy Osmani \"Build the loop, stay the engineer\"). \"잘됨\"을 계산 가능한 0~100 score 로 정의하고 score→triage→fix→verify→rescore 사이클을 돌려 숫자를 올리되, 모든 상승은 실환경 신호(DB 불변식·200+실데이터· 비-권한 403·벤치)에 결박한다(anti-gaming). 단일 진입점에서 4모드를 의도 추론으로 분기: init(코드베이스 스캔+인터뷰→.loop\u002F 생성) · score(재채점) · run N(N=1 attended 1바퀴+게이트, N≥2 무인 드라이버) · status(현황). **반드시 사용**: '루프 셋업', '루프 시작', 'loop init', '재채점', '완성도 몇 점', 're-score', '루프 N라운드 돌려', 'loop engineering N라운드', '다음 deficit', 'STOP 판정', '루프 현황', '다음 뭐 해야 돼' — 완성도 루프를 셋업·측정·전진·조회하려는 모든 맥락. 코드 프로젝트 전용(probe\u002Ffix=local 범위만, auto-merge 금지, maker≠verifier). 단순 단일 버그수정·일반 구현 요청엔 쓰지 말 것(그건 일반 작업 흐름).","https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger\u002Fcaseworker\u002Fblob\u002Fmain\u002Fskills\u002Floop\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7CAB3XVS1KX6HR24HEQCK24","kb-ingest","kb-ingest — Jira 이슈 KEY 가 없는 소스 (회의록, 클라이언트 회신, Mattermost 스레드, 세션 진단·결정 기록, 외부 문서, 구두 전달 정보) 를 코드 프로젝트의 docs\u002F 지식 wiki 에 ingest 합니다. 소스를 읽고 핵심을 추출해 docs\u002Fwiki\u002F\u003C도메인>.md 현재-상태 종합 페이지에 통합하고, INDEX.md 등재 + LOG.md 기록까지 수행합니다 (issue 스킬의 wiki 단계(scripts\u002Fwiki-row.mjs)와 references\u002F_wiki-schema.md SSoT 공유 — 경계는 '소스에 이슈 KEY 가 있느냐' 하나). 사용자가 '이 회의록 ingest 해줘', '클라 회신 wiki 에 반영해줘', '이 문서 wiki 로', '오늘 회의 내용 기록해줘', '이 결정 wiki 에 넣어줘', 'kb ingest', '지식 등록', '세션 기록 wiki 반영' 등을 요청하거나, 회의록·회신·기록 파일을 가리키며 wiki 반영 의도를 보이면 반드시 이 스킬을 사용하세요. 파일 없이 말로만 전달된 결정 사항도 이 스킬로 wiki 에 기록합니다. ⚠ 개인 폴더 (결혼 준비 위키, 회사 업무 폴더 등) 의 파일 배치·정리는 이 스킬이 아니라 anthropic-skills 의 wiki-ingest 담당 — 이 스킬은 docs\u002FINDEX-SCHEMA.md 를 가진 코드 프로젝트 wiki 전용입니다. Jira 이슈의 forecast\u002Fclosure ingest 는 issue 스킬의 wiki 단계(scripts\u002Fwiki-row.mjs) 담당.","https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger\u002Fcaseworker\u002Fblob\u002Fmain\u002Fskills\u002Fkb-ingest\u002FSKILL.md",[],[],{"skillNo":81,"name":5,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7CAAY3P0B0DR8BS573T1DZD","이슈 트래커의 키(local 기본 · jira\u002Fgithub 어댑터 — `HX-a3f8` · `ABC-123` 꼴) 한 건 또는 여러 건의 개발 전 주기를 진행하는 라우터 — 브랜치·상태 JSON(start), 결정 인터뷰(grill), 계획 워크플로와 승인(plan), 구현(implement), Codex+워크플로 리뷰(verify), 컴파일·테스트 게이트(gate), 훅이 판정하는 commit\u002Fpush, 마감(complete: push·wiki·트래커 전이). 사용자가 \"\u002Fcaseworker:issue KEY\", \"KEY 시작\u002F착수\u002F잡아줘\", \"이어서 해줘\", \"계획 세워줘\", \"리뷰 돌려줘\", \"게이트\u002F테스트 돌려줘\", \"커밋해줘\", \"push 해줘\", \"마무리\u002FQA 넘겨줘\u002F완료 처리\" 라고 하거나, 현재 브랜치가 이슈 브랜치(feat\u002FKEY…)이면 반드시 이 스킬을 쓴다. 명시 호출이 없어도 이슈 키가 언급된 개발 요청이면 이 스킬로 지금 어느 단계인지부터 정한다.","https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger\u002Fcaseworker\u002Fblob\u002Fmain\u002Fskills\u002Fissue\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M7CAASJR055Y397NK1MJHNZM","grilling","Grill the user relentlessly about a plan or design until reaching shared understanding. Use when the user wants to stress-test a plan before building, get grilled on their design, or uses any 'grill' trigger phrases ('grill me', '그릴해줘', '계획 점검', '설계 털어줘'). 질문은 한 번에 하나, 선택형은 AskUserQuestion 선택지 UI로 렌더링한다.","https:\u002F\u002Fgithub.com\u002Fbigbulgogiburger\u002Fcaseworker\u002Fblob\u002Fmain\u002Fskills\u002Fgrilling\u002FSKILL.md",[],[]]