메뉴
WSS-iOS-V2 프로젝트에서, 작업 중 발견한 함정·교훈·주의사항을 가장 가까운 CLAUDE.md의 "주의사항" 절에 누적해 문서를 살아있게 유지할 때 사용한다. "방금 배운 거 기록해줘", "이건 함정이었어", "이 주의사항 문서에 남겨줘", 또는 "/learn" 같은 요청에 트리거. 코드만 봐선 모르는 것(숨은 의존·함정·예외·왜)만 기록한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
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]
| name | learn |
| description | WSS-iOS-V2 프로젝트에서, 작업 중 발견한 함정·교훈·주의사항을 가장 가까운 CLAUDE.md의 "주의사항" 절에 누적해 문서를 살아있게 유지할 때 사용한다. "방금 배운 거 기록해줘", "이건 함정이었어", "이 주의사항 문서에 남겨줘", 또는 "/learn" 같은 요청에 트리거. 코드만 봐선 모르는 것(숨은 의존·함정·예외·왜)만 기록한다. |
| metadata | {"short-description":"작업 중 얻은 함정·교훈을 가장 가까운 CLAUDE.md 주의사항에 누적"} |
방금 작업에서 얻은 교훈/함정을 문서에 누적한다. 목적은 문서를 살아있게 유지하는 것.
기록할 내용: 스킬 인자로 전달된 설명이 있으면 그것을 쓴다(없으면 아래 1번 절차로 후보를 제시해 확인받는다).
무엇을 배웠는지 한 줄로 정리. 코드만 봐도 아는 사실은 적지 말 것 — "코드만 봐선 모르는 것"(숨은 의존, 함정, 예외, 왜)만.
어디에 적을지 결정 (가장 좁은 범위 우선):
Projects/<Layer>/<Module>/CLAUDE.mdProjects/<Layer>/CLAUDE.mddocs/TESTING.md, docs/CONVENTIONS.md, docs/GLOSSARY.md, docs/WORKFLOW.md)CLAUDE.md해당 문서의 "주의사항 (작업 중 발견 시 누적)" 절에 한 줄 추가. 절이 없으면 만든다. 중복이면 기존 항목을 보강한다.
무엇을 어디에 적었는지 한 줄로 보고. (커밋은 사용자가 지시할 때만)