القائمة
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해당 문서의 "주의사항 (작업 중 발견 시 누적)" 절에 한 줄 추가. 절이 없으면 만든다. 중복이면 기존 항목을 보강한다.
무엇을 어디에 적었는지 한 줄로 보고. (커밋은 사용자가 지시할 때만)