Maikozort/claude-skills

Claude 자동화 추천기

코드베이스 패턴을 분석하여 모든 확장성 옵션에 걸친 맞춤형 Claude Code 자동화를 추천합니다.

이 스킬은 읽기 전용입니다. 코드베이스를 분석하고 추천 결과를 출력합니다. 파일을 생성하거나 수정하지 않습니다. 사용자는 추천 사항을 직접 구현하거나 Claude에게 별도로 도움을 요청합니다.

출력 지침

• 각 유형별 1-2개 추천: 너무 많지 않게, 각 카테고리별로 가장 가치 있는 자동화 1-2개를 제시합니다.
• 사용자가 특정 유형을 요청한 경우: 해당 유형에만 집중하고 더 많은 옵션(3-5개 추천)을 제공합니다.
• 참고 목록 이상으로 확장: 참고 파일에는 일반적인 패턴이 포함되어 있지만, 코드베이스의 도구, 프레임워크, 라이브러리에 특화된 추천을 찾기 위해 웹 검색을 사용하세요.
• 사용자에게 더 많은 정보를 요청할 수 있음을 알림: 특정 카테고리에 대해 더 많은 추천을 요청할 수 있다는 점을 언급하며 마무리합니다.

자동화 유형 개요

유형	최적 대상
훅 (Hooks)	도구 이벤트 시 자동 작업 (저장 시 포맷, 린트, 편집 차단)
서브에이전트 (Subagents)	병렬로 실행되는 전문 리뷰어/분석기
스킬 (Skills)	패키지화된 전문 지식, 워크플로우, 반복 작업 (/skill-name 으로 Claude 또는 사용자가 호출)
플러그인 (Plugins)	설치 가능한 스킬 모음
MCP 서버 (MCP Servers)	외부 도구 통합 (데이터베이스, API, 브라우저, 문서)

워크플로우

1단계: 코드베이스 분석

프로젝트 컨텍스트 수집:

# 프로젝트 유형 및 도구 감지
ls -la package.json pyproject.toml Cargo.toml go.mod pom.xml 2>/dev/null
cat package.json 2>/dev/null | head -50

# MCP 서버 추천을 위한 종속성 확인
cat package.json 2>/dev/null | grep -E '"(react|vue|angular|next|express|fastapi|django|prisma|supabase|convex|stripe)"'

# 기존 Claude Code 설정 확인
ls -la .claude/ CLAUDE.md 2>/dev/null

# 프로젝트 구조 분석
ls -la src/ app/ lib/ tests/ components/ pages/ api/ 2>/dev/null

캡처할 주요 지표:

카테고리	확인 대상	추천 항목에 반영
언어/프레임워크	package.json, pyproject.toml, import 패턴	훅, MCP 서버
프론트엔드 스택	React, Vue, Angular, Next.js	Playwright MCP, 프론트엔드 스킬
백엔드 스택	Express, FastAPI, Django	API 문서화 도구
데이터베이스	Prisma, Supabase, Convex, raw SQL	데이터베이스/백엔드 MCP 서버
외부 API	Stripe, OpenAI, AWS SDK	문서용 context7 MCP
테스팅	Jest, pytest, Playwright 설정	테스트 훅, 서브에이전트
CI/CD	GitHub Actions, CircleCI	GitHub MCP 서버
이슈 트래킹	Linear, Jira 참조	이슈 트래커 MCP
문서 패턴	OpenAPI, JSDoc, docstring	문서 스킬

2단계: 추천 생성

분석을 기반으로 모든 카테고리에 걸쳐 추천을 생성합니다:

A. MCP 서버 추천

자세한 패턴은 references/mcp-servers.md를 참조하세요.

코드베이스 신호	추천 MCP 서버
인기 라이브러리 사용 (React, Express 등)	context7 - 실시간 문서 조회
UI 테스트가 필요한 프론트엔드	Playwright - 브라우저 자동화/테스트
Supabase 사용	Supabase MCP - 직접 데이터베이스 작업
Convex 사용	Convex MCP - 실시간 배포 인트로스펙션, 쿼리/뮤테이션 실행, 환경 변수 및 로그 관리
PostgreSQL/MySQL 데이터베이스	Database MCP - 쿼리 및 스키마 도구
GitHub 저장소	GitHub MCP - 이슈, PR, 액션
Linear로 이슈 관리	Linear MCP - 이슈 관리
AWS 인프라	AWS MCP - 클라우드 리소스 관리
Slack 워크스페이스	Slack MCP - 팀 알림
메모리/컨텍스트 지속성	Memory MCP - 세션 간 메모리
Sentry 오류 추적	Sentry MCP - 오류 조사
Docker 컨테이너	Docker MCP - 컨테이너 관리

B. 스킬 추천

자세한 내용은 references/skills-reference.md를 참조하세요.

.claude/skills/<name>/SKILL.md에 스킬을 생성하세요. 일부는 플러그인을 통해서도 사용 가능합니다:

코드베이스 신호	스킬	플러그인
플러그인 빌드	skill-development	plugin-dev
Git 커밋	commit	commit-commands
React/Vue/Angular	frontend-design	frontend-design
자동화 규칙	writing-rules	hookify
기능 계획	feature-dev	feature-dev

생성할 사용자 정의 스킬 (템플릿, 스크립트, 예제 포함):

코드베이스 신호	생성할 스킬	호출 방식
API 라우트	api-doc (OpenAPI 템플릿 포함)	둘 다
데이터베이스 프로젝트	create-migration (유효성 검사 스크립트 포함)	사용자 전용
테스트 스위트	gen-test (예제 테스트 포함)	사용자 전용
컴포넌트 라이브러리	new-component (템플릿 포함)	사용자 전용
PR 워크플로우	pr-check (체크리스트 포함)	사용자 전용
릴리스	release-notes (git 컨텍스트 포함)	사용자 전용
코드 스타일	project-conventions	Claude 전용
온보딩	setup-dev (사전 요구사항 스크립트 포함)	사용자 전용

C. 훅 추천

설정은 references/hooks-patterns.md를 참조하세요.

코드베이스 신호	추천 훅
Prettier 설정됨	PostToolUse: 편집 시 자동 포맷
ESLint/Ruff 설정됨	PostToolUse: 편집 시 자동 린트
TypeScript 프로젝트	PostToolUse: 편집 시 타입 검사
테스트 디렉토리 존재	PostToolUse: 관련 테스트 실행
.env 파일 존재	PreToolUse: .env 편집 차단
Lock 파일 존재	PreToolUse: lock 파일 편집 차단
보안 민감 코드	PreToolUse: 확인 요청

D. 서브에이전트 추천

템플릿은 references/subagent-templates.md를 참조하세요.

코드베이스 신호	추천 서브에이전트
대규모 코드베이스 (>500개 파일)	code-reviewer - 병렬 코드 리뷰
인증/결제 코드	security-reviewer - 보안 감사
API 프로젝트	api-documenter - OpenAPI 생성
성능 중요	performance-analyzer - 병목 현상 감지
프론트엔드 위주	ui-reviewer - 접근성 리뷰
더 많은 테스트 필요	test-writer - 테스트 생성

E. 플러그인 추천

사용 가능한 플러그인은 references/plugins-reference.md를 참조하세요.

코드베이스 신호	추천 플러그인
일반 생산성	anthropic-agent-skills - 핵심 스킬 번들
문서 워크플로우	docx, xlsx, pdf 스킬 설치
프론트엔드 개발	frontend-design 플러그인
AI 도구 구축	mcp-builder (MCP 개발용)

3단계: 추천 보고서 출력

추천 사항을 명확하게 포맷팅합니다. 카테고리당 1-2개 추천만 포함 - 이 특정 코드베이스에 가장 가치 있는 항목들입니다. 관련 없는 카테고리는 건너뜁니다.

## Claude Code 자동화 추천

코드베이스를 분석하고 각 카테고리에 대한 최고의 자동화를 식별했습니다. 유형별 상위 1-2개 추천은 다음과 같습니다:

### 코드베이스 프로필
- **유형**: [감지된 언어/런타임]
- **프레임워크**: [감지된 프레임워크]
- **주요 라이브러리**: [감지된 관련 라이브러리]

---

### 🔌 MCP 서버

#### context7
**이유**: [감지된 라이브러리 기반 구체적 이유]
**설치**: `claude mcp add context7`

---

### 🎯 스킬

#### [스킬 이름]
**이유**: [구체적 이유]
**생성 위치**: `.claude/skills/[name]/SKILL.md`
**호출 방식**: 사용자 전용 / 둘 다 / Claude 전용
**다음 플러그인에서도 사용 가능**: [플러그인 이름] 플러그인 (해당 시)
```yaml
---
name: [스킬 이름]
description: [기능 설명]
disable-model-invocation: true  # 사용자 전용 시
---

---

⚡ 훅

[훅 이름]

이유: [감지된 설정 기반 구체적 이유] 위치: .claude/settings.json

---

🤖 서브에이전트

[에이전트 이름]

이유: [코드베이스 패턴 기반 구체적 이유] 위치: .claude/agents/[name].md

---

더 필요하신가요? 특정 카테고리에 대한 추가 추천을 요청하세요 (예: "MCP 서버 옵션 더 보여줘" 또는 "어떤 다른 훅이 도움이 될까?").

구현에 도움이 필요하신가요? 요청하시면 위 추천 사항 중 어떤 것이든 설정하는 데 도움을 드릴 수 있습니다.

## 의사 결정 프레임워크

### MCP 서버를 추천해야 하는 경우
- 외부 서비스 통합 필요 (데이터베이스, API)
- 라이브러리/SDK 문서 조회
- 브라우저 자동화 또는 테스트
- 팀 도구 통합 (GitHub, Linear, Slack)
- 클라우드 인프라 관리

### 스킬을 추천해야 하는 경우

- 문서 생성 (docx, xlsx, pptx, pdf — 플러그인에서도 가능)
- 자주 반복되는 프롬프트 또는 워크플로우
- 인수가 있는 프로젝트별 작업
- 작업에 템플릿 또는 스크립트 적용 (스킬은 지원 파일을 번들로 묶을 수 있음)
- `/skill-name` 으로 호출하는 빠른 작업
- 격리되어 실행되어야 하는 워크플로우 (`context: fork`)

**호출 제어:**
- `disable-model-invocation: true` — 사용자 전용 (부작용 발생 시: 배포, 커밋, 전송)
- `user-invocable: false` — Claude 전용 (백그라운드 지식용)
- 기본값 (둘 다 생략) — 둘 다 호출 가능

### 훅을 추천해야 하는 경우
- 반복적인 편집 후 작업 (포맷팅, 린팅)
- 보호 규칙 (민감한 파일 편집 차단)
- 유효성 검사 (테스트, 타입 검사)

### 서브에이전트를 추천해야 하는 경우
- 전문 지식 필요 (보안, 성능)
- 병렬 리뷰 워크플로우
- 백그라운드 품질 검사

### 플러그인을 추천해야 하는 경우
- 여러 관련 스킬이 필요한 경우
- 미리 패키징된 자동화 번들을 원하는 경우
- 팀 전체 표준화

---

## 설정 팁

### MCP 서버 설정

**팀 공유**: `.mcp.json`을 저장소에 커밋하여 전체 팀이 동일한 MCP 서버를 사용하도록 함

**디버깅**: `--mcp-debug` 플래그를 사용하여 설정 문제 식별

**추천할 전제 조건:**
- GitHub CLI (`gh`) - 기본 GitHub 작업 활성화
- Puppeteer/Playwright CLI - 브라우저 MCP 서버용

### 헤드리스 모드 (CI/자동화용)

자동화된 파이프라인을 위한 헤드리스 Claude 추천:

```bash
# Pre-commit 훅 예시
claude -p "src/의 린트 오류를 수정해" --allowedTools Edit,Write

# 구조화된 출력을 사용한 CI 파이프라인
claude -p "<프롬프트>" --output-format stream-json | your_command

훅 권한

.claude/settings.json에서 허용된 도구 구성:

{
  "permissions": {
    "allow": ["Edit", "Write", "Bash(npm test:*)", "Bash(git commit:*)"]
  }
}