ccjk 1.3.1

package/README.ko.md

@@ -0,0 +1,455 @@
+<!--
+  SEO Meta: CCJK - Claude Code 진쿠 | 최고의 AI 코딩 어시스턴트 | 11+ AI 에이전트 | 무료 오픈소스
+  Description: CCJK는 Claude Code를 위한 가장 강력한 확장 툴킷입니다. 11+ AI 에이전트, LLM 기반 코드 감사, 스킬 자동화, 플러그인 시스템을 제공합니다. 원클릭 설정.
+-->
+
+<div align="center">
+
+<!-- Logo & Badges - GitHub 소셜 미리보기 최적화 -->
+<img src="https://raw.githubusercontent.com/miounet11/ccjk/main/docs/assets/ccjk-logo.png" alt="CCJK Logo" width="200" />
+
+# CCJK - Claude Code 진쿠
+
+### 🏆 #1 AI 코딩 어시스턴트 확장 툴킷
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![License][license-src]][license-href]
+[![GitHub stars][stars-src]][stars-href]
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/miounet11/ccjk/pulls)
+
+**[English](README.md)** | **[简体中文](README.zh-CN.md)** | **[日本語](README.ja.md)** | **[한국어](README.ko.md)**
+
+<br/>
+
+> 💡 **한 줄 명령으로 AI 코딩 경험을 슈퍼차지하세요**
+>
+> ```bash
+> npx ccjk
+> ```
+
+<br/>
+
+[📖 빠른 시작](#-빠른-시작) · [🚀 핵심 기능](#-핵심-기능) · [💬 커뮤니티](#-커뮤니티--지원) · [🤝 기여하기](#-기여하기)
+
+</div>
+
+---
+
+## 🎯 CCJK란?
+
+**CCJK (Claude Code 진쿠)** 는 Claude Code를 단순한 AI 어시스턴트에서 **완전한 AI 개발팀**으로 변환합니다. 11+ 전문 AI 에이전트, 지능형 자동화, 세계 최초의 LLM 기반 코드 감사기로 더 빠르게 더 나은 코드를 작성할 수 있습니다.
+
+<table>
+<tr>
+<td width="33%" align="center">
+<h3>🤖 11+ AI 에이전트</h3>
+<p>보안, 성능, 테스트, DevOps, 코드 리뷰 등</p>
+</td>
+<td width="33%" align="center">
+<h3>⚡ 제로 설정</h3>
+<p>한 줄 명령으로 바로 사용 가능</p>
+</td>
+<td width="33%" align="center">
+<h3>🆓 100% 무료</h3>
+<p>오픈소스. 숨겨진 비용 없음. MIT 라이선스.</p>
+</td>
+</tr>
+</table>
+
+---
+
+## 🚀 빠른 시작
+
+### 1단계: CCJK 설치 (30초)
+
+```bash
+# 옵션 A: 직접 실행 (처음 사용자 추천)
+npx ccjk
+
+# 옵션 B: 전역 설치
+npm install -g ccjk
+```
+
+### 2단계: API 설정
+
+`npx ccjk` 실행 시 친숙한 메뉴가 표시됩니다:
+
+```
+╔═══════════════════════════════════════════════════════════╗
+║   ██████╗ ██████╗     ██╗██╗  ██╗                         ║
+║  ██╔════╝██╔════╝     ██║██║ ██╔╝                         ║
+║  ██║     ██║          ██║█████╔╝   Claude Code 진쿠      ║
+║  ██║     ██║     ██   ██║██╔═██╗   v1.0.0                ║
+║  ╚██████╗╚██████╗╚█████╔╝██║  ██╗                         ║
+║   ╚═════╝ ╚═════╝ ╚════╝ ╚═╝  ╚═╝                         ║
+╚═══════════════════════════════════════════════════════════╝
+
+? 옵션을 선택하세요:
+❯ 🚀 빠른 설정 (추천)
+  ⚙️  API 설정
+  🛠️  고급 설정
+  📖 도움말
+```
+
+**"빠른 설정"** 을 선택하고 안내를 따르세요!
+
+### 3단계: 코딩 시작!
+
+```bash
+# CCJK 향상된 Claude Code 실행
+claude
+```
+
+완료! 이제 11+ AI 에이전트, 스킬 자동화 등 모든 기능을 사용할 수 있습니다.
+
+---
+
+## ✨ 핵심 기능
+
+### 🤖 AI 에이전트 군단
+
+당신만의 AI 개발팀, 24/7 대기:
+
+| 에이전트 | 기능 | 사용 예시 |
+|---------|------|----------|
+| 🛡️ **보안 전문가** | 취약점 발견, OWASP 검사 | "이 인증 코드의 보안 문제 검토" |
+| ⚡ **성능 전문가** | 속도 최적화, 메모리 절감 | "앱이 왜 느린가요?" |
+| 🧪 **테스트 전문가** | 테스트 작성, 커버리지 분석 | "이 함수에 단위 테스트 추가" |
+| 🚀 **DevOps 전문가** | CI/CD, Docker, Kubernetes | "GitHub Actions 워크플로우 생성" |
+| 📝 **코드 리뷰어** | 베스트 프랙티스, 코드 품질 | "이 PR 리뷰" |
+| 🏗️ **API 아키텍트** | REST, GraphQL, API 설계 | "사용자 관리 API 설계" |
+| 💾 **데이터베이스 전문가** | 쿼리 최적화, 인덱싱 | "이 SQL 쿼리 최적화" |
+| 🎨 **프론트엔드 아키텍트** | React, Vue, 접근성 | "이 컴포넌트 리팩토링" |
+| ⚙️ **백엔드 아키텍트** | 마이크로서비스, 이벤트 기반 | "확장 가능한 백엔드 설계" |
+| 📚 **문서 전문가** | API 문서, README, 가이드 | "이 코드베이스 문서화" |
+| 🔄 **리팩토링 전문가** | 클린 코드, 디자인 패턴 | "SOLID 원칙으로 리팩토링" |
+
+### 🔍 ShenCha - AI 코드 감사기
+
+세계 최초의 **완전 자율** AI 코드 감사기:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  🧠 ShenCha 감사 엔진                                       │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  1️⃣  스캔    → AI가 문제 발견 (사전 정의 규칙 없음)         │
+│  2️⃣  분석    → 컨텍스트와 영향도 이해                      │
+│  3️⃣  수정    → 자동으로 수정 생성 및 적용                  │
+│  4️⃣  검증    → 수정이 올바르게 작동하는지 확인             │
+│                                                             │
+│  ✅ 72시간 연속 감사 사이클                                  │
+│  ✅ 포괄적인 보고서 생성                                     │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### ⚡ 스킬 시스템
+
+간단한 명령으로 강력한 자동화 생성:
+
+```bash
+# TypeScript 개발자용
+ccjk skills create-batch --lang typescript
+# 생성: ts-debug, ts-refactor, ts-test, ts-type-check, ts-migrate
+
+# Python 개발자용
+ccjk skills create-batch --lang python
+# 생성: py-debug, py-refactor, py-test, py-lint, py-type
+
+# SEO 최적화용
+ccjk skills create-batch --seo
+# 생성: meta-optimize, sitemap-generate, schema-markup, core-web-vitals
+
+# DevOps용
+ccjk skills create-batch --devops
+# 생성: docker-setup, ci-pipeline, deploy-script, monitoring
+```
+
+### 🌐 13+ API 프로바이더 내장
+
+원클릭으로 모든 AI 프로바이더 연결:
+
+| 프로바이더 | 유형 | 무료 티어 |
+|-----------|------|:---------:|
+| **Anthropic** | 공식 | - |
+| **OpenRouter** | 멀티 모델 | ✅ |
+| **DeepSeek** | 비용 효율적 | ✅ |
+| **Groq** | 빠른 추론 | ✅ |
+| **Gemini** | Google AI | ✅ |
+| **Ollama** | 로컬/프라이빗 | ✅ |
+| 302.AI, Qwen, SiliconFlow, Kimi, GLM... | 아시아 프로바이더 | 다양 |
+
+```bash
+# 빠른 API 설정
+ccjk api setup deepseek sk-your-api-key
+
+# 또는 대화형 마법사 사용
+ccjk api wizard
+```
+
+### 🔌 플러그인 시스템
+
+커스텀 플러그인으로 CCJK 확장:
+
+```typescript
+// ~/.ccjk/plugins/my-plugin/index.ts
+export default {
+  name: 'my-awesome-plugin',
+  version: '1.0.0',
+
+  // 커스텀 에이전트 추가
+  agents: [
+    { name: 'my-agent', model: 'sonnet', template: '...' }
+  ],
+
+  // 커스텀 스킬 추가
+  skills: [
+    { id: 'my-skill', trigger: '/my-skill', template: '...' }
+  ],
+
+  // 커스텀 워크플로우 추가
+  workflows: [...]
+}
+```
+
+---
+
+## 📖 명령어 참조
+
+### 필수 명령어 (먼저 사용하세요!)
+
+| 명령어 | 설명 | 사용 시기 |
+|-------|------|----------|
+| `npx ccjk` | 대화형 설정 메뉴 | 처음 설정 |
+| `ccjk setup` | 안내 온보딩 마법사 | CCJK 처음 사용 |
+| `ccjk doctor` | 환경 검사 | 문제 발생 시 |
+| `ccjk upgrade` | 모든 것 업데이트 | 최신 상태 유지 |
+
+### 설정 명령어
+
+| 명령어 | 설명 |
+|-------|------|
+| `ccjk init` | 모든 옵션으로 전체 초기화 |
+| `ccjk api wizard` | API 프로바이더 설정 |
+| `ccjk api list` | 사용 가능한 프로바이더 표시 |
+| `ccjk api status` | 현재 API 설정 확인 |
+| `ccjk api test` | API 연결 테스트 |
+
+### 도구 관리
+
+| 명령어 | 설명 |
+|-------|------|
+| `ccjk tools list` | 모든 AI 코딩 도구 표시 |
+| `ccjk tools install <도구>` | 특정 도구 설치 |
+| `ccjk tools status` | 설치 상태 확인 |
+
+### 스킬 & 자동화
+
+| 명령어 | 설명 |
+|-------|------|
+| `ccjk skills list` | 모든 스킬 목록 |
+| `ccjk skills create-batch --lang <언어>` | 언어별 스킬 생성 |
+| `ccjk skills enable <스킬>` | 스킬 활성화 |
+| `ccjk skills disable <스킬>` | 스킬 비활성화 |
+
+### 고급 명령어
+
+| 명령어 | 설명 |
+|-------|------|
+| `ccjk config-scan` | 모든 Claude Code 설정 찾기 |
+| `ccjk permissions` | Claude Code 권한 관리 |
+| `ccjk versions` | 모든 컴포넌트 버전 확인 |
+| `ccjk uninstall` | 완전 제거 |
+
+---
+
+## 🌍 다국어 지원
+
+CCJK는 당신의 언어를 지원합니다:
+
+```bash
+# English (기본값)
+ccjk init --lang en
+
+# 한국어
+ccjk init --lang ko
+
+# 简体中文
+ccjk init --lang zh-CN
+
+# 日本語
+ccjk init --lang ja
+
+# 모든 언어 한 번에 설정 (UI + 설정 + AI 출력)
+ccjk init --all-lang ko
+```
+
+---
+
+## 📊 왜 CCJK인가?
+
+| 기능 | CCJK | Cursor | Copilot | 기타 도구 |
+|-----|:----:|:------:|:-------:|:---------:|
+| AI 에이전트 | **11+** | 2 | 1 | 0-2 |
+| 스킬 자동화 | ✅ | ❌ | ❌ | ❌ |
+| 플러그인 시스템 | ✅ | ❌ | ❌ | ❌ |
+| LLM 코드 감사 | ✅ | ❌ | ❌ | ❌ |
+| 멀티 프로바이더 | **13+** | 1 | 1 | 1-3 |
+| 제로 설정 | ✅ | ❌ | ❌ | ❌ |
+| 오픈소스 | ✅ | ❌ | ❌ | 일부 |
+| 무료 | ✅ | ❌ | ❌ | 일부 |
+
+---
+
+## 💻 플랫폼 지원
+
+| 플랫폼 | 상태 | 비고 |
+|-------|:----:|-----|
+| **macOS** | ✅ 완전 지원 | Intel & Apple Silicon |
+| **Linux** | ✅ 완전 지원 | 모든 주요 배포판 |
+| **Windows** | ✅ 완전 지원 | Windows 10/11, WSL2 |
+| **Termux** | ✅ 완전 지원 | 안드로이드 터미널 |
+
+---
+
+## ❓ 자주 묻는 질문
+
+<details>
+<summary><b>API 키가 필요한가요?</b></summary>
+
+13+ 지원 프로바이더 중 하나에서 API 키가 필요합니다. 일부는 무료 티어를 제공합니다:
+- **Groq** - 무료 티어 제공
+- **Gemini** - 무료 티어 제공
+- **DeepSeek** - 매우 저렴
+- **Ollama** - 로컬 실행, 완전 무료
+
+</details>
+
+<details>
+<summary><b>CCJK는 무료인가요?</b></summary>
+
+네! CCJK는 100% 무료 오픈소스입니다 (MIT 라이선스). 선택한 프로바이더의 API 사용료만 지불합니다.
+
+</details>
+
+<details>
+<summary><b>Claude Code와 작동하나요?</b></summary>
+
+네! CCJK는 Claude Code 향상을 위해 특별히 설계되었습니다. Codex, Aider, Continue, Cline, Cursor도 지원합니다.
+
+</details>
+
+<details>
+<summary><b>회사에서 사용할 수 있나요?</b></summary>
+
+물론입니다! MIT 라이선스는 상업적 사용을 허용합니다. 많은 팀이 CCJK를 사용합니다:
+- AI 코딩 관행 표준화
+- 빠른 개발자 온보딩
+- 자동화된 코드 리뷰
+- 보안 규정 준수
+
+</details>
+
+<details>
+<summary><b>문제가 생기면 어떻게 하나요?</b></summary>
+
+헬스 체크를 실행하세요:
+```bash
+ccjk doctor
+```
+일반적인 문제를 진단하고 해결책을 제안합니다.
+
+</details>
+
+---
+
+## 💬 커뮤니티 & 지원
+
+<div align="center">
+
+[![GitHub Discussions](https://img.shields.io/badge/GitHub-토론-333?style=for-the-badge&logo=github)](https://github.com/miounet11/ccjk/discussions)
+[![Telegram](https://img.shields.io/badge/Telegram-채팅-26A5E4?style=for-the-badge&logo=telegram)](https://t.me/ccjk_community)
+[![Discord](https://img.shields.io/badge/Discord-서버-5865F2?style=for-the-badge&logo=discord)](https://discord.gg/ccjk)
+
+</div>
+
+- 🐛 **버그 리포트**: [GitHub Issues](https://github.com/miounet11/ccjk/issues)
+- 💡 **기능 요청**: [GitHub Discussions](https://github.com/miounet11/ccjk/discussions)
+- 📖 **문서**: [docs.ccjk.dev](https://docs.ccjk.dev)
+
+---
+
+## 🤝 기여하기
+
+기여를 환영합니다! 시작하는 방법:
+
+```bash
+# 저장소 클론
+git clone https://github.com/miounet11/ccjk.git
+cd ccjk
+
+# 의존성 설치
+pnpm install
+
+# 개발 모드 실행
+pnpm dev
+
+# 테스트 실행
+pnpm test
+
+# 빌드
+pnpm build
+```
+
+자세한 내용은 [기여 가이드](CONTRIBUTING.md)를 참조하세요.
+
+---
+
+## 🙏 감사의 말
+
+CCJK는 거인의 어깨 위에 서 있습니다:
+
+- [Claude Code](https://claude.ai/code) - 강력한 AI 코딩 기반
+- [ZCF](https://github.com/UfoMiao/zcf) - 원본 영감
+- [Claude Code Router](https://github.com/musistudio/claude-code-router) - API 라우팅
+- [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD) - 워크플로우 패턴
+
+---
+
+## 📄 라이선스
+
+MIT © [CCJK Team](https://github.com/miounet11/ccjk)
+
+---
+
+<div align="center">
+
+## ⭐ GitHub에서 스타를 눌러주세요
+
+CCJK가 도움이 되었다면 스타를 눌러주세요! 다른 사람들이 프로젝트를 발견하는 데 도움이 됩니다.
+
+[![Star History Chart](https://api.star-history.com/svg?repos=miounet11/ccjk&type=Date)](https://star-history.com/#miounet11/ccjk&Date)
+
+<br/>
+
+**개발자를 위해 개발자가 ❤️로 만들었습니다**
+
+<br/>
+
+### 🔍 검색 키워드
+
+`claude-code` `AI코딩어시스턴트` `코드리뷰AI` `AI개발도구` `claude-ai` `anthropic` `LLM코딩` `AI에이전트` `코드자동화` `devops-ai` `보안감사` `성능최적화` `typescript` `python` `javascript` `react` `vue` `nodejs` `docker` `kubernetes` `github-actions` `ci-cd` `코드품질` `베스트프랙티스` `클린코드` `copilot대안` `cursor대안` `무료AI코딩` `오픈소스AI`
+
+</div>
+
+<!-- Badge Links -->
+[npm-version-src]: https://img.shields.io/npm/v/ccjk?style=flat&colorA=18181B&colorB=28CF8D
+[npm-version-href]: https://npmjs.com/package/ccjk
+[npm-downloads-src]: https://img.shields.io/npm/dm/ccjk?style=flat&colorA=18181B&colorB=28CF8D
+[npm-downloads-href]: https://npmjs.com/package/ccjk
+[license-src]: https://img.shields.io/github/license/miounet11/ccjk?style=flat&colorA=18181B&colorB=28CF8D
+[license-href]: https://github.com/miounet11/ccjk/blob/main/LICENSE
+[stars-src]: https://img.shields.io/github/stars/miounet11/ccjk?style=flat&colorA=18181B&colorB=28CF8D
+[stars-href]: https://github.com/miounet11/ccjk/stargazers