project-initializer

📁 khw1031/ai-library 📅 1 day ago
1
总安装量
1
周安装量
#76273
全站排名
安装命令
npx skills add https://github.com/khw1031/ai-library --skill project-initializer

Agent 安装分布

amp 1
cline 1
opencode 1
cursor 1
continue 1
kimi-cli 1

Skill 文档

Project Initializer

새 프로젝트를 프레임워크에 맞게 초기화합니다. WebSearch로 최신 정보를 조사하고, 사용자에게 모호한 부분을 질문하며, 완료 후 기본 규칙을 자동 생성합니다.

핵심 원칙

  1. Web Search First – 설치/설정 전 반드시 최신 버전 검색
  2. 모호하면 물어본다 – 선택지 제시 후 사용자 결정 대기
  3. 사용자 확인 필수 – Phase 3에서 전체 기술 스택 확인
  4. 규칙 자동 설정 – Phase 5에서 rule-manager 워크플로우로 기본 규칙 생성

다중 전문가 관점

다음 전문가 관점에서 초기화를 수행합니다:

전문가 관점
Architect 프로젝트 구조, 모듈 설계, 확장성
DevOps Engineer 빌드 도구, CI/CD, 환경 설정
DX Specialist 개발자 경험, 린팅, 포맷팅, 스크립트

5-Phase 워크플로우

Phase 1        Phase 2        Phase 3        Phase 4        Phase 5
Discovery  →   Research   →   Decision   →   Execution  →   Finalize
요구사항 파악   최신 정보 수집  기술 스택 확정  프로젝트 생성   검증 + 규칙

Phase 1: Discovery (요구사항 파악)

사용자에게 다음을 확인합니다. 이미 알고 있는 항목은 건너뜁니다.

항목 질문 기본값
프로젝트 종류 “웹앱, API, CLI, 라이브러리 중 어떤 걸 만드시나요?”
프레임워크 “어떤 프레임워크를 사용하시나요?” 목적 기반 추천
프로젝트 이름 “프로젝트 이름은 무엇인가요?”
생성 경로 “어디에 프로젝트를 생성할까요?” 현재 디렉토리
특별 요구사항 “추가로 필요한 기능이 있나요?” (DB, 인증 등) 없음

프레임워크 미정 시 추천:

목적 추천 프레임워크
웹앱 (풀스택) Next.js, Nuxt
웹앱 (SPA) Vite + React/Vue
API 서버 NestJS, FastAPI, Go
CLI 도구 Commander.js, Click, Cobra
라이브러리 tsup, setuptools, cargo

상세 프레임워크 정보: references/framework-profiles.md


Phase 2: Research (최신 정보 수집)

반드시 WebSearch로 다음 항목을 검색합니다:

검색 항목 쿼리 패턴 목적
프레임워크 최신 버전 {framework} latest stable version {year} 최신 안정 버전 확인
런타임 LTS {runtime} LTS version {year} 호환 런타임 버전 확인
CLI/scaffold 도구 {framework} create project CLI {year} 공식 생성 도구 확인
권장 프로젝트 구조 {framework} recommended project structure 모범 사례 구조 확인

검색 결과 기록 형식:

## 검색 결과 요약
- 프레임워크: {name} v{version} (출처: {source})
- 런타임: {runtime} v{version} (LTS)
- CLI 도구: {tool} v{version}
- 권장 구조: {brief description}

상세 검색 전략: references/web-search-strategy.md


Phase 3: Decision (기술 스택 확정)

검색 결과를 바탕으로 기술 스택을 제안하고 사용자 확인을 받습니다.

공통 결정 항목:

항목 선택지 예시 기본값
패키지 매니저 npm, pnpm, yarn, bun / pip, uv, poetry 생태계 권장값
언어 설정 TypeScript, JavaScript / Python 버전 TypeScript
린팅 도구 Biome, ESLint, Ruff, golangci-lint 프레임워크 기본
포맷터 Biome, Prettier, Black, gofmt 린터 통합
테스트 프레임워크 Vitest, Jest, pytest, go test 프레임워크 기본
Git hooks husky, lefthook, pre-commit 선택적

확인 형식:

## 기술 스택 확인

| 항목 | 선택 |
|------|------|
| 프레임워크 | {framework} v{version} |
| 런타임 | {runtime} v{version} |
| 패키지 매니저 | {pm} |
| 언어 | {lang} |
| 린팅 | {linter} |
| 포맷팅 | {formatter} |
| 테스트 | {test_framework} |
| 추가 기능 | {features} |

이 스택으로 프로젝트를 생성할까요?

사용자 확인 없이 Phase 4로 진행하지 않습니다.


Phase 4: Execution (프로젝트 생성)

승인받은 스택으로 프로젝트를 생성합니다. 다음 순서를 따릅니다:

Step 1: 환경 확인

# 런타임 버전 확인
{runtime} --version

# 패키지 매니저 확인 (없으면 설치)
{pm} --version

Step 2: 프로젝트 Scaffold

# 프레임워크 공식 CLI로 프로젝트 생성
{scaffold_command} {project_name}
cd {project_name}

Step 3: 추가 패키지 설치

Phase 3에서 확정된 추가 기능에 따라 패키지를 설치합니다.

# 런타임 의존성
{pm} add {runtime_deps}

# 개발 의존성
{pm} add -D {dev_deps}

Step 4: 설정 파일 구성

  • 린터/포맷터 설정 파일
  • 환경 변수 파일 (.env, .env.example)
  • 에디터 설정 (.editorconfig)

Step 5: Git 초기화

# scaffold에서 이미 생성된 경우 건너뜀
git init
git add .
git commit -m "Initial commit: {framework} project setup"

상세 Phase별 절차: references/phases.md


Phase 5: Finalize (검증 + 규칙 생성)

5-1. 빌드 검증

프로젝트가 정상 동작하는지 검증합니다:

# 1. 린트 검사
{pm} {lint_script}

# 2. 빌드 테스트
{pm} {build_script}

# 3. 테스트 실행
{pm} {test_script}

# 4. 개발 서버 실행 (빠르게 확인 후 종료)
{pm} {dev_script}

검증 실패 시 즉시 수정 후 재검증합니다.

5-2. 기본 규칙 자동 생성

rule-manager 워크플로우를 참조하여 프로젝트에 기본 규칙을 생성합니다.

대상 경로: 초기화된 프로젝트의 .claude/skills/

기본 규칙 카테고리:

카테고리 규칙 내용 user-invocable
코딩 컨벤션 네이밍, 포맷팅, 파일 구조 false
Git 컨벤션 커밋 메시지, 브랜치 전략 false
프로젝트 구조 디렉토리 규칙, 모듈 구성 false

상세 규칙 생성 가이드: references/rule-integration.md

5-3. 완료 보고

## 프로젝트 초기화 완료

### 프로젝트 정보
- **이름**: {project_name}
- **경로**: {project_path}
- **프레임워크**: {framework} v{version}
- **런타임**: {runtime} v{version}

### 설치된 패키지
| 패키지 | 버전 | 용도 |
|--------|------|------|
| ... | ... | ... |

### 사용 가능한 스크립트
| 명령어 | 설명 |
|--------|------|
| `{pm} dev` | 개발 서버 실행 |
| `{pm} build` | 프로덕션 빌드 |
| `{pm} test` | 테스트 실행 |
| `{pm} lint` | 린트 검사 |

### 생성된 규칙
| 규칙 | 경로 |
|------|------|
| ... | .claude/skills/... |

### 다음 단계 권장사항
1. {recommendation_1}
2. {recommendation_2}
3. {recommendation_3}

실행 체크리스트

[ ] Phase 1: 프로젝트 종류, 프레임워크, 이름, 경로 확인
[ ] Phase 2: 최신 버전 WebSearch 완료 (4개 항목)
[ ] Phase 2: 검색 결과 기록 완료
[ ] Phase 3: 기술 스택 제안 완료
[ ] Phase 3: 사용자 확인 완료
[ ] Phase 4: 환경 확인 완료
[ ] Phase 4: scaffold 실행 완료
[ ] Phase 4: 추가 패키지 설치 완료
[ ] Phase 4: 설정 파일 구성 완료
[ ] Phase 4: Git 초기화 완료
[ ] Phase 5: 빌드 검증 통과
[ ] Phase 5: 기본 규칙 자동 생성 완료

에러 처리

상황 대응
scaffold 실패 CLI 도구 버전 확인 → 재설치 → 재시도
패키지 충돌 호환 버전 WebSearch → 버전 조정
빌드 실패 에러 로그 분석 → 설정 수정 → 재검증
런타임 미설치 설치 안내 → 사용자 확인 후 설치

상세 가이드