jinto/SKILL.md

## SKILL.md

      
    Raw
  

              SKILL.md
            
          
  name
  description
  argument-hint
  
  
  dev-cycle
  TASKS.md 기반 개발 사이클 — 일감 파악 → 플랜 → 리뷰 → 구현 → 테스트 → 품질 루프 → 커밋을 반복
  
  
  --non-interactive
  
  
Dev Cycle

TASKS.md의 다음 미완료 일감을 하나씩 처리하는 전체 개발 사이클.
--non-interactive 플래그가 있으면, 각 단계에서 사용자 확인 없이 자동 진행한다.
전체 흐름

┌───────────────────────────────────────────────────────┐
│  1. NEXT-TODO: 다음 일감 파악                           │
│  2. PLAN: 플랜 작성 (.claude/plans/에 저장)        ◄──┐ │
│  3. CODEX PLAN REVIEW: 플랜 리뷰                   ───┘ │
│     └─ BLOCKER → 플랜 수정 후 2~3 반복 (최대 10회)      │
│  4. IMPLEMENT: 구현                                    │
│  5. QUALITY LOOP (커밋 전 품질 루프):              ◄──┐ │
│     5a. CODE-SIMPLIFIER: 코드 단순화                   │
│     5b. TEST: 전체 테스트 실행                          │
│     5c. CODEX CODE REVIEW: 미커밋 변경사항 리뷰         │
│     5d. 이슈 있으면 → 수정 후 5a로 반복            ───┘ │
│     └─ 이슈 없으면 → 6단계로 진행                       │
│  6. COMMIT: 문서 업데이트 + 커밋 (co-author 없이)       │
│  7. TASKS.md 체크박스 업데이트                           │
│  └─ 다음 일감이 있으면 → 1로 돌아감                      │
└───────────────────────────────────────────────────────┘


단계별 상세

1. NEXT-TODO — 다음 일감 파악


TASKS.md를 읽고 첫 번째 미완료(- [ ]) 항목 그룹을 식별
관련 문서(PRD.md, CLAUDE.md, docs/*.md)와 기존 코드를 읽어 컨텍스트 파악
이 단계의 산출물: 어떤 일감인지, 무엇을 만들어야 하는지 정리

2. PLAN — 플랜 작성


.claude/plans/ 디렉토리에 플랜 파일 저장 (예: phase-1-2-input-page.md)
플랜에 포함할 내용:

구현 범위 (TASKS.md 체크박스 단위)
생성/수정할 파일 목록
각 파일의 핵심 구현 내용
검증 방법 (각 단계마다 verify 기준)
트레이드오프나 결정 사항


⚠️ 3. CODEX PLAN REVIEW — 반드시 거쳐야 하는 플랜 리뷰


이 단계를 건너뛰면 안 된다. 구현 전에 반드시 codex 리뷰를 통과해야 한다.

Bash 도구로 codex를 직접 실행하여 플랜 리뷰를 받는다 (Skill 도구가 아닌 Bash로 직접 실행):
npx codex exec -C . --full-auto -s read-only -c model_reasoning_effort="xhigh" \
  "다음 플랜 파일을 리뷰해주세요: <플랜 파일 경로>
또한 관련 코드 파일들과 CLAUDE.md, TASKS.md를 읽고 플랜이 현실적인지 평가하세요.
리뷰 기준: PRD 정합성, 누락/가정 오류, MVP 과설계 여부, 기술적 타당성.
문제가 있으면 각 문제를 'BLOCKER:' 접두어로 나열하세요.
문제가 없으면 'APPROVED'로 시작하세요.
한국어로 응답."

APPROVED → 4단계로 진행
BLOCKER → 플랜 수정 후 2~3단계 반복 (최대 10회)
10회 초과 시: 남은 blocker를 사용자에게 보고하고 판단 요청

4. IMPLEMENT — 구현


승인된 플랜대로 코드 작성
플랜에 없는 파일은 건드리지 않음
구현 중 플랜과 다른 결정이 필요하면: non-interactive라도 사용자에게 확인

5. QUALITY LOOP — 커밋 전 품질 루프


구현 후, 커밋 전에 반드시 이 루프를 돌려야 한다. 이슈가 없을 때까지 반복한다.

이 루프는 최대 5회 반복한다. 5회 초과 시 남은 이슈를 사용자에게 보고하고 판단 요청.
5a. CODE-SIMPLIFIER — 코드 단순화

code-simplifier 에이전트를 실행하여 최근 수정된 코드를 단순화/정리한다.

기능 변경 없이 가독성, 일관성, 유지보수성 개선
수정 사항이 있으면 파일에 적용

5b. TEST — 전체 테스트 실행

uv run pytest
uv run python manage.py check

테스트 실패 시: 원인 분석 → 수정 → 테스트 재실행 (이 내부에서 최대 10회 반복)
3회 내 해결 안 되면 사용자에게 보고

5c. CODEX CODE REVIEW — 미커밋 변경사항 리뷰

codex를 사용하여 현재 미커밋 변경사항(git diff)을 코드 리뷰한다.
npx codex exec -C . --full-auto -s read-only -c model_reasoning_effort="xhigh" \
  "현재 git 저장소의 미커밋 변경사항을 리뷰해주세요.
git diff와 git diff --cached를 확인하세요.
리뷰 기준: 코드 품질, 버그, 보안, 불필요한 복잡성, 프로젝트 컨벤션(CLAUDE.md 참조).
문제가 있으면 각 문제를 'ISSUE:' 접두어로 나열하세요.
문제가 없으면 'CLEAN'으로 시작하세요.
한국어로 응답."
5d. 결과 판단 및 반복


code-simplifier가 코드를 수정했거나, codex가 ISSUE를 발견한 경우:

이슈 내용을 분석하여 코드 수정
→ 5a로 돌아가 루프 반복


code-simplifier 수정 없음 + codex가 CLEAN 응답 → 루프 종료, 6단계로 진행

6. COMMIT — 문서 업데이트 + 커밋


업데이트가 필요한 문서가 있는지 확인하고 있다면 수정해서 커밋에 들어가게 해야한다.
TASKS.md 에서 완료된 체크박스를 [x]로 변경
커밋 생성 (co-author 적지 않음)

7. TASKS.md 업데이트


다음 미완료 일감이 있으면 → 1단계로 돌아감
모든 일감이 완료되면 종료


모드

Interactive (기본)


각 단계 전환 시 사용자에게 진행 여부 확인

Non-interactive (--non-interactive)


사용자 확인 없이 자동 진행
단, 다음 상황에서는 반드시 멈추고 사용자에게 보고:

codex 플랜 리뷰 10회 초과 blocker
품질 루프 5회 초과 반복
테스트 10회 초과 실패
플랜에 없는 구조적 결정이 필요한 경우
No results found