메뉴
WSS-iOS-V2 프로젝트에서, 새 작업을 시작할 때 GitHub 이슈를 만들고 base(기본 develop) 기준 Type/#이슈 브랜치로 분기·이동·push 후 tuist generate까지 한 번에 처리할 때 사용한다. "이슈 따고 시작하자", "새 작업/이슈 시작", 또는 "/new-issue <작업 설명>" 같은 요청에 트리거. ⚠️ 이슈 생성·push는 외부로 나가는 비가역 작업 → 실행 전 반드시 사용자 승인을 받는다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
| name | new-issue |
| description | WSS-iOS-V2 프로젝트에서, 새 작업을 시작할 때 GitHub 이슈를 만들고 base(기본 develop) 기준 Type/#이슈 브랜치로 분기·이동·push 후 tuist generate까지 한 번에 처리할 때 사용한다. "이슈 따고 시작하자", "새 작업/이슈 시작", 또는 "/new-issue <작업 설명>" 같은 요청에 트리거. ⚠️ 이슈 생성·push는 외부로 나가는 비가역 작업 → 실행 전 반드시 사용자 승인을 받는다. |
| metadata | {"short-description":"GitHub 이슈 생성 + Type/#이슈 브랜치 분기·push + tuist generate"} |
작업 하나를 시작한다. 인자: 작업 설명(비면 사용자에게 묻는다).
GitHub 이슈 생성 → Type/#이슈 브랜치 분기·이동·push → tuist generate를 한 번에 처리한다.
판단(설명·Type·본문·승인·dirty 선택·보고)은 이 스킬이, 기계적·비가역 구간은 .claude/scripts/new-issue.sh 가 맡는다.
⚠️ 이 스킬은 자연어로 자동 발동될 수 있다. 그러나 이슈 생성·push 같은 외부로 나가는 비가역 작업은 언제나 사용자 승인 후에만 실행한다(아래 3단계 게이트). 승인 없이
run을 호출하지 않는다.
이 스킬은 repo에 커밋되어 팀원이 각자 쓴다. 특정 gh 계정/소유자/레포를 박지 말 것 — 담당자는
@me(실행한 본인), 레포는 현재 디렉토리로 자동 감지된다. 외부로 나가는 작업(이슈 생성·push)은 사용자 승인 후 실행한다.
Type 어휘는 ../commit-types.md 가 단일 진실 소스다 — 여기 복제하지 않으니 그 파일을 읽어 고른다.
이슈 제목/브랜치명에서는 대괄호 없이 쓴다(Feat, Docs …). 그 목록에 없는 Type은 만들지 않는다.
⚙️ 실제 강제는 스크립트(
.claude/scripts/new-issue.sh)가 하지만, 그 화이트리스트(ALLOWED_TYPES)는commit-types.md를 런타임에 파싱해 만든다 → Type을 바꿀 땐commit-types.md만 고치면 스크립트도 자동 반영된다.
../commit-types.md)의 Type 하나를 추론한다. 애매하면 사용자에게 확인한다.<Type>/#<번호> — 슬래시(/)와 #이 둘 다 반드시 있어야 한다. 예: Feat/#149, Docs/#130.Feat#92(슬래시·# 누락), 소문자 chore/refactor 같은 위반 사례가 섞여 있다. 절대 따라가지 말 것 — 항상 대문자 Type + / + # + 번호.[Type] <한글 설명>..github/ISSUE_TEMPLATE/feature_request.md를 읽어 그 섹션 구조 그대로(frontmatter 제거) 채운다 —
## Issue Title에 한 줄 요약, ## Issue Content에 작업 항목(- [ ] 체크리스트). 템플릿 파일이 없으면 이 2섹션 골격으로 폴백.@me.develop을 기본으로 제시하되, 다른 base를 원하는지 사용자에게 묻는다.⚙️ 4·5단계의 기계적·비가역 구간은
.claude/scripts/new-issue.sh가 결정론적으로 강제한다.--no-track·#따옴표·번호 파싱·Type 정규형 같은 반복 함정을 손으로 재구성하지 말고 스크립트를 호출한다.
bash .claude/scripts/new-issue.sh preflight <base>
gh auth status(미인증이면 비정상 종료) + git fetch origin <base>(base 최신화·존재 확인) + 워킹트리 상태 출력을 모두 수행한다.gh auth login 안내).WORKTREE=DIRTY면 새 브랜치로 변경사항이 따라가므로 알리고 선택받는다:
(a) 그대로 가져가기 (b) --stash 사용(5단계에서 --stash 전달) (c) 취소. CLEAN이면 그대로 진행.3단계에서 작성·승인된 본문을 스크래치패드 임시 파일에 먼저 기록한다(멀티라인 인자 회피). 그 뒤 한 번 호출:
bash .claude/scripts/new-issue.sh run \
--type <Type> --base <base> \
--title "[Type] 한글 설명" --body-file <스크래치패드_본문_경로> \
[--stash] # 4단계에서 (b)를 골랐을 때만
git stash → gh issue create --assignee @me(현재 레포 자동) + URL에서 번호 파싱 → git checkout -b "<Type>/#<번호>" --no-track origin/<base>(--no-track·# 따옴표를 영구 보장 — IDE Push가 base로 새는 사고 방지) → (선택)git stash pop → git push -u(upstream을 자기 브랜치로) → tuist generate.--type은 위 Type 집합에 정확히 대문자 매칭해야 통과한다 (chore/Feat#92 류는 거부됨).--title/--body-file 대신 --num <번호>.ISSUE_NUMBER / ISSUE_URL / BRANCH 요약 블록이 출력된다. tuist generate 실패 등은 출력 그대로 보고(에셋/Derived 문제면 안내).@me + 현재 레포 자동 감지(스크립트가 처리)./# + 번호)·# 따옴표·--no-track·번호 파싱은 스크립트(run)가 강제한다 — 손으로 git 명령을 재구성하지 말 것.Feat#92, 소문자 chore 등)를 따라가지 말 것 — 스크립트가 정규형만 통과시킨다.SOC 직업 분류 기준
WSS-iOS-V2 프로젝트에서, 작업을 마치고 PR을 올릴 때 사용한다. ① wss-pr-reviewer로 변경 전체를 통합 리뷰→수정을 Blocker·Warning이 0이 될 때까지 수렴 → ② 이번 변경과 관련된 CLAUDE.md/docs 갱신 필요를 메인이 직접 판정해 필요한 것만 방향성과 함께 제시·반영 → ③ 문서 변경 커밋 → ④ 프로젝트 PR 템플릿대로 본문 작성·사용자 검토 → ⑤ 승인 후 gh로 GitHub PR 생성, 까지 단계별 게이트로 진행한다. "작업 마무리하자", "PR 올리자", 또는 "/make-PR" 같은 요청에 트리거. ⚠️ push·PR 생성은 외부로 나가는 비가역 작업 → 승인 후에만 실행한다. (머지 직전 rebase·force push·merge는 이 스킬 범위 밖.)
WSS-iOS-V2 프로젝트에서, 새 Feature 화면을 처음부터 구현할 때 사용한다. 모듈명을 받아 ① new-module 스킬로 Feature 모듈 생성 → ② View/ViewModel·Factory 골격 작성 → ③ Figma URL을 받아 WSS 디자인 시스템으로 UI 구현 → ④ wss-feature-reviewer로 리뷰→수정을 Blocker·Warning이 0이 될 때까지 수렴, 까지 단계별 게이트로 진행한다. "새 화면 만들자", "Feature 구현 시작", 또는 "/new-feature <ModuleName> [FigmaURL]" 같은 요청에 트리거.
WSS-iOS-V2 프로젝트에서, 새 Tuist 모듈을 생성할 때 사용한다. 레이어(domain|data|core|ui|feature)와 모듈명을 받아 ModuleType.swift 등록 → 의존성 자동 추론 → Project.swift 생성 → tuist generate → 모듈 가이드까지 수행한다. "새 모듈 만들어줘", "도메인/데이터/Feature 모듈 추가", 또는 "/new-module <layer> <ModuleName>" 같은 요청에 트리거.
WSS-iOS-V2를 클론한 뒤 개발 환경을 처음 셋업할 때 사용한다. mise install → tuist install → tuist generate → git 훅 활성화(core.hooksPath) → Config 비밀값 확인 → .mcp.json 신뢰 승인까지 단계별로 점검·실행·안내한다. "초기 셋업", "환경 세팅", "처음 클론했어", 또는 "/setup" 같은 요청에 트리거. 실제 Config 비밀키 값·MCP 신뢰 승인 클릭·머신 설치(Xcode/Node)는 사람만 할 수 있어 스킬은 그 지점을 정확히 안내하고 멈춘다.
WSS-iOS-V2 프로젝트에서, 현재 Git 변경 전부를 스테이징해 커밋할 때 사용한다. 선택적으로 사용자가 지정한 개수만큼 개념 단위로 나눠 커밋할 수 있다. "전부 커밋", "다 커밋해줘", "/commit-all", "/commit-all 3" 같은 요청에 트리거. 커밋 양식은 `[Type]
WSS-iOS-V2 프로젝트에서, 이번 Claude Code 세션에 Edit/Write로 만지거나 새로 만든 파일만 골라 커밋할 때 사용한다. commit-all(전부 스테이징)·commit-staged(이미 스테이징된 것만)와 달리 세션이 건드린 파일만 선택적으로 스테이징한다. "방금 바꾼 거 커밋", "세션 변경분 커밋", 또는 "/commit" 같은 요청에 트리거. 커밋 양식은 `[Type]
