القائمة
마일스톤 다음 단계 실행. milestone.md의 미완료 Phase를 기준 문서와 코드베이스 컨텍스트 기반으로 구현한다. "다음 작업", "마일스톤 실행", "Phase 진행" 등의 요청 시 사용
استنادا إلى تصنيف SOC المهني
React 코드 품질 분석. git diff 기반으로 변경된 코드의 클린 코드 점수 평가. "코드 리뷰", "품질 검사" 등의 요청 시 사용
AI 코드 생성 후 불필요한 코드 정리 스킬. git diff로 변경된 TS/JS 파일을 분석하여 사용되지 않는 코드를 자동 제거한다. 트리거: unused 코드 정리, 불필요한 코드 삭제, dead code 제거, 코드 클린업, AI 작업 후 정리 요청 시
컨벤셔널 커밋 메시지 생성. "커밋해줘", "커밋", "변경사항 저장" 등의 요청 시 사용
순환 복잡도(Cyclomatic Complexity)가 높은 함수를 인간의 논리적 사고 흐름에 맞게 재구성하는 스킬. "복잡한 함수 정리해줘", "이 함수 읽기 어려워", "순환 복잡도 낮춰줘", "리팩토링 해줘" 등의 요청에 사용. 단순 코드 추출이 아닌 논리적 재구성을 수행하며, 성능보다 가독성과 수정 용이성을 우선시함.
Story 파일에서 컴포넌트 스크린샷 캡처. "/screenshot", "스크린샷 캡처" 등의 요청 시 사용
Deep reasoning skill using Codex's Agent Teams. Spawns multiple personas with enforced minimum depth, includes a challenge round where teammates critique each other, and iterates on low-confidence answers. Use when the user prefixes with "deep think", "딥씽크", "깊게 생각해", or requests thorough analysis. Best for complex architecture, debugging, algorithmic, or multi-domain problems. NOT for simple lookups. Requires: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
| name | milestone-execute |
| description | 마일스톤 다음 단계 실행. milestone.md의 미완료 Phase를 기준 문서와 코드베이스 컨텍스트 기반으로 구현한다. "다음 작업", "마일스톤 실행", "Phase 진행" 등의 요청 시 사용 |
목표: milestone.md에서 다음 미완료 Phase를 식별하고, 해당 Phase와 연결된 기준 문서 및 코드베이스를 참고하여 실제 코드를 구현합니다.
프로젝트 루트에서 다음 정보를 읽습니다:
milestone.md — 작업 목록 및 진행 상태 (필수)milestone.md 상단의 기반 문서 목록 (선택)milestone 스킬을 먼저 실행하도록 안내합니다.milestone.md에서 첫 번째 미완료([ ]) 항목이 포함된 Phase를 자동 선택합니다.선택된 Phase와 포함된 작업 항목들을 사용자에게 보여주고 진행 여부를 확인합니다.
해당 Phase의 미완료 체크박스 항목들을 내부 태스크 리스트로 등록합니다.
이미 완료([x])된 항목은 건너뜁니다.
Phase의 모든 미완료 태스크를 검토하여 실행 그래프(Layer)를 생성합니다.
의존 관계 판정 기준:
| 관계 | 판정 | 근거 |
|---|---|---|
| 같은 파일 수정 | 순차 | 동시 수정 시 충돌 |
| export → import 관계 | 순차 | 선행 타입/함수가 있어야 후행 구현 가능 |
| 다른 디렉토리, 독립 기능 | 병렬 | 충돌 없음 |
| 공통 컨텍스트만 참조 (읽기 전용) | 병렬 | 충돌 없음 |
Layer 생성 예시:
Layer 1: [Task A, Task B] ← 독립적, 병렬 실행
Layer 2: [Task C] ← Task A의 export를 import
Layer 3: [Task D, Task E] ← Task C 완료 후 독립적, 병렬 실행
각 태스크에 선행/후행 관계를 명시하여 의존성을 기록합니다.
각 태스크의 성격에 따라 적절한 관점으로 실행합니다:
| 태스크 성격 | 권장 전문성 | 판단 기준 |
|---|---|---|
| React 컴포넌트 UI 구현 | 프런트엔드 구현 관점 | JSX, 스타일, 이벤트 핸들링 |
| 타입 정의, 제네릭, 유틸리티 타입 | TypeScript 설계 관점 | type, interface, 제네릭 제약 |
| API 로직, 비즈니스 로직, 훅 | 애플리케이션 로직 관점 | 데이터 처리, 상태 관리 |
| 복잡한 아키텍처 결정 포함 | 아키텍처 리뷰 관점 | 설계 판단이 필요한 경우 |
| 보일러플레이트, 설정 파일 | 실용적 구현 관점 | 단순 반복 작업 |
Layer별로 실행합니다:
Layer 내 (병렬):
AGENTS.md 패턴, FSD 원칙, 기존 코드 컨벤션)Layer 간 (순차):
pnpm typecheck
단일 태스크 또는 순차 의존만 있는 경우:
각 태스크 완료 시 내부 태스크 리스트에서 상태를 completed로 갱신합니다.
AGENTS.md의 아키텍처 패턴 및 디렉토리 구조를 따릅니다.각 작업 항목의 "검증" 기준을 우선 적용해 검증을 수행합니다.
pnpm run typecheck — 타입 검사pnpm run lint — 린트 검사pnpm run test:unit — 관련 단위 테스트 실행 (테스트가 있는 경우)검증 실패 시:
모든 작업이 완료되면 milestone-update 스킬을 호출하여:
[x]로 업데이트합니다.실행 결과를 사용자에게 보고합니다: