AgentSkillsCN

plan

为复杂实现制定周密的计划

SKILL.md
--- frontmatter
name: plan
description: 복잡한 구현을 위한 계획 수립

구현 계획 수립

복잡한 기능 구현을 위한 계획을 수립합니다.

사용법

code
/plan [기능 설명]
/plan 사용자 인증 시스템 구현
/plan Redis 캐싱 레이어 추가

프로세스

  1. 요구사항 분석

    • 핵심 목표 정의
    • 제약 조건 파악
    • 성공 기준 설정
  2. 현황 분석

    • 기존 코드/아키텍처 확인
    • 재사용 가능한 컴포넌트 식별
    • 영향 범위 파악
  3. 작업 분해

    • 독립적으로 완료 가능한 단위로 분해
    • 의존성 관계 명시
  4. 실행 계획

    • 작업 순서 결정
    • 검증 포인트 정의

작업 분해 기준

대상 독자

"코드베이스 맥락 없는 숙련된 엔지니어"가 실행 가능해야 함

작업 단위 규칙

규칙설명
크기각 단계는 2-5분 단일 작업
파일 경로정확한 파일 경로 포함 필수
명령어실행 명령어와 예상 결과 명시
의존성선행 작업 번호 명시

작업 설명 필수 항목

code
각 작업에 포함할 내용:
☐ 정확한 파일 경로 (src/api/user.ts)
☐ 구체적 변경 내용 (함수 추가, 수정, 삭제)
☐ 검증 방법 (테스트 명령어, 예상 결과)
☐ 의존성 (선행 작업 번호)

저장 위치 (선택)

복잡한 계획은 문서로 저장:

code
docs/plans/YYYY-MM-DD-<기능명>.md

출력 예시

markdown
## 계획: 사용자 인증 시스템

### 목표
- JWT 기반 인증 시스템 구현

### 제약 조건
- 기존 세션 방식과 병행 운영 필요
- 토큰 만료 시간 1시간

### 작업 목록

| # | 작업 | 복잡도 | 의존성 | 검증 |
|---|------|--------|--------|------|
| 1 | JWT 유틸리티 함수 | 낮음 | - | 단위 테스트 |
| 2 | 인증 미들웨어 | 중간 | 1 | 통합 테스트 |
| 3 | 로그인 API | 중간 | 1,2 | E2E 테스트 |
| 4 | 토큰 갱신 API | 중간 | 1,2 | E2E 테스트 |

### 리스크
- 기존 세션과 충돌 가능 → 점진적 마이그레이션

### 첫 번째 작업
JWT 유틸리티 함수 (sign, verify) 구현 시작

옵션

  • --detailed: 더 상세한 계획
  • --minimal: 핵심만 간략하게