ccjk 2.0.0 → 2.0.4

package/README.md

@@ -1,9 +1,9 @@
 <!--
-  SEO Meta: CCJK - Claude Code JinKu | #1 AI Coding Assistant | Smart Skills System | 11+ AI Agents | Hot Reload | Zero Config
-  Description: CCJK 2.0 is the most advanced AI coding toolkit. Features Smart Skills with hot-reload, 11+ AI agents,
-  intelligent context awareness, subagent orchestration, and permission system. The future of AI-assisted development.
+  SEO Meta: CCJK - Claude Code JinKu | Zero-Config AI Coding Assistant | Workflow Templates | Multi-Provider Support
+  Description: CCJK is a powerful CLI toolkit for Claude Code. Features zero-config setup, workflow templates,
+  multi-provider API support, MCP service integration, and bilingual support. Simplify your AI development workflow.
   Keywords: claude code, ai coding assistant, claude code extension, ai developer tools, code automation,
-  ai agents, copilot alternative, cursor alternative, free ai coding, open source ai tools
+  workflow templates, copilot alternative, cursor alternative, free ai coding, open source ai tools
 -->
 
 <div align="center">
@@ -13,7 +13,7 @@
 
 # CCJK - Claude Code JinKu
 
-### 🚀 The Most Advanced AI Coding Assistant Enhancement Toolkit
+### 🚀 Zero-Config AI Coding Assistant Enhancement Toolkit
 
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
@@ -25,21 +25,6 @@
 
 <br/>
 
-## 🎉 v2.0.0 - Revolutionary Skill System! (January 2025)
-
-> **🧠 Intelligent Skills Architecture - The Future of AI Coding**
->
-> - 🔥 **Smart Skills Hot-Reload** - Edit skills, instant activation, zero restart
-> - 🤖 **Subagent Orchestration** - Parallel/sequential task execution with AI agents
-> - 🛡️ **Permission System** - Fine-grained access control with wildcard patterns
-> - ⚡ **Lifecycle Hooks** - before/after/error callbacks for complete control
-> - 🎯 **Context-Aware Activation** - Skills auto-activate based on your work
-> - 📦 **22+ Built-in Skill Templates** - PR Review, Security Audit, Refactoring, and more
->
-> **⭐ Star us on GitHub to support the project!**
-
-<br/>
-
 > 💡 **One command to supercharge your AI coding experience**
 >
 > ```bash
@@ -48,7 +33,7 @@
 
 <br/>
 
-[📖 Documentation](#-quick-start) · [🚀 Features](#-revolutionary-features) · [💬 Community](#-community--support) · [🤝 Contributing](#-contributing)
+[📖 Documentation](#-quick-start) · [🚀 Features](#-core-features) · [💬 Community](#-community--support) · [🤝 Contributing](#-contributing)
 
 </div>
 
@@ -56,21 +41,21 @@
 
 ## 🎯 What is CCJK?
 
-**CCJK (Claude Code JinKu)** transforms Claude Code from a simple AI assistant into a **complete AI development powerhouse**. With our revolutionary **Smart Skills System**, 11+ specialized AI agents, and intelligent automation, CCJK helps you write better code 10x faster.
+**CCJK (Claude Code JinKu)** is a powerful CLI toolkit that transforms Claude Code setup from hours to seconds. With zero-configuration initialization, professional workflow templates, and multi-provider API support, CCJK helps you start coding with AI assistance immediately.
 
 <table>
 <tr>
 <td width="25%" align="center">
-<h3>🧠 Smart Skills</h3>
-<p>Hot-reload, context-aware, auto-activation</p>
+<h3>⚡ Zero Config</h3>
+<p>One command. Works instantly.</p>
 </td>
 <td width="25%" align="center">
-<h3>🤖 11+ AI Agents</h3>
-<p>Security, Performance, Testing, DevOps</p>
+<h3>📋 Workflow Templates</h3>
+<p>Git, Six-Step, Feature Planning</p>
 </td>
 <td width="25%" align="center">
-<h3>⚡ Zero Config</h3>
-<p>One command. Works instantly.</p>
+<h3>🌐 Multi-Provider</h3>
+<p>13+ API providers supported</p>
 </td>
 <td width="25%" align="center">
 <h3>🆓 100% Free</h3>
@@ -115,156 +100,109 @@ claude
 
 ---
 
-## ✨ Revolutionary Features
+## ✨ Core Features
 
-### 🧠 Smart Skills System 2.0 (NEW!)
+### ⚡ Zero-Configuration Setup
 
-The most advanced skill system for AI coding assistants:
+Get started in seconds with intelligent defaults:
 
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  🧠 CCJK Smart Skills Architecture                              │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │
-│  │   Hooks     │  │  Subagent   │  │     Permissions         │ │
-│  │   System    │  │  Manager    │  │       System            │ │
-│  │             │  │             │  │                         │ │
-│  │ • before    │  │ • parallel  │  │ • allow/deny rules      │ │
-│  │ • after     │  │ • sequential│  │ • wildcard patterns     │ │
-│  │ • error     │  │ • transcript│  │ • file/command control  │ │
-│  └──────┬──────┘  └──────┬──────┘  └───────────┬─────────────┘ │
-│         │                │                     │               │
-│         └────────────────┼─────────────────────┘               │
-│                          │                                     │
-│              ┌───────────▼───────────┐                         │
-│              │   Hot Reload Engine   │                         │
-│              │                       │                         │
-│              │  • File watching      │                         │
-│              │  • Smart caching      │                         │
-│              │  • Auto discovery     │                         │
-│              │  • Instant activation │                         │
-│              └───────────────────────┘                         │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
+```bash
+# One command does it all
+npx ccjk
+
+# Interactive setup guides you through:
+# ✓ API configuration (13+ providers)
+# ✓ MCP service integration
+# ✓ Workflow template installation
+# ✓ Output style customization
 ```
 
-#### 🔥 Hot Reload - Edit Skills, Instant Effect
+### 📋 Professional Workflow Templates
 
-```yaml
-# Edit any skill file, changes apply immediately!
-# No restart needed. No configuration required.
+Battle-tested workflows for common development tasks:
 
-# Example: ~/.ccjk/skills/my-skill.md
----
-name: my-custom-skill
-trigger: /my-skill
-auto_activate:
-  file_patterns: ["*.ts", "*.tsx"]
-  keywords: ["refactor", "optimize"]
-hooks:
-  before: validate-context
-  after: generate-report
----
+#### Git Workflow Commands
+- `/git-commit` - Smart commit message generation
+- `/git-rollback` - Safe rollback with conflict resolution
+- `/git-cleanBranches` - Clean up merged branches
+- `/git-worktree` - Git worktree management
 
-Your skill instructions here...
-```
+#### Six-Step Development Workflow
+- `/workflow` - Structured development process
+  1. Requirements Analysis
+  2. Design & Planning
+  3. Implementation
+  4. Testing
+  5. Documentation
+  6. Review & Optimization
 
-#### 🤖 Subagent Orchestration
+#### Feature Planning Workflow
+- `/feat` - Feature planning with task breakdown
+- `@planner` - AI planning agent for complex features
+- `@ui-ux-designer` - UI/UX design assistance
 
-Run multiple AI agents in parallel or sequence:
+#### Common Tools
+- `/init-project` - Project initialization with best practices
+- `@init-architect` - Project structure design
 
-```yaml
-subagents:
-  - name: security-scan
-    model: sonnet
-    task: "Scan for vulnerabilities"
-  - name: performance-check
-    model: haiku
-    task: "Analyze performance"
-    depends_on: security-scan  # Sequential execution
-```
+### 🤖 AI Agent System
 
-#### 🛡️ Permission System
+Pre-configured AI agents for specialized tasks:
 
-Fine-grained access control:
-
-```yaml
-permissions:
-  allow:
-    - "src/**/*.ts"           # Allow all TypeScript files
-    - "!src/**/*.test.ts"     # Except test files
-  deny:
-    - ".env*"                 # Never touch env files
-    - "node_modules/**"       # Skip node_modules
-  commands:
-    allow: ["npm test", "npm run build"]
-    deny: ["rm -rf", "sudo *"]
+| Agent | Specialty | Invocation |
+|-------|-----------|------------|
+| 📋 **Planner** | Task breakdown & planning | `@planner` |
+| 🎨 **UI/UX Designer** | Interface design | `@ui-ux-designer` |
+| 🏗️ **Init Architect** | Project setup | `@init-architect` |
+
+**Usage Example:**
+```bash
+# In Claude Code conversation
+> @planner I need to add user authentication to my app
+
+# Agent will provide:
+# - Task breakdown
+# - Implementation steps
+# - Best practices
+# - Security considerations
 ```
 
-### 📦 22+ Built-in Skill Templates
+### 📦 16 Built-in Skill Templates
+
+Ready-to-use skill templates for common tasks:
 
 | Category | Skills | Description |
 |----------|--------|-------------|
-| **Code Quality** | `pr-review`, `code-review`, `refactoring` | Comprehensive code analysis |
-| **Security** | `security-audit`, `vulnerability-scan` | OWASP, CVE detection |
-| **Performance** | `performance-profiling`, `optimization` | Speed & memory analysis |
-| **Documentation** | `documentation-gen`, `api-docs` | Auto-generate docs |
-| **Testing** | `tdd-workflow`, `test-generation` | Test-driven development |
-| **DevOps** | `git-commit`, `ci-cd-setup` | Automation workflows |
-| **Migration** | `migration-assistant`, `upgrade-helper` | Framework migrations |
-| **Planning** | `writing-plans`, `executing-plans` | Project planning |
-
-### 🤖 AI Agent Army
-
-Your personal AI development team, available 24/7:
-
-| Agent | Specialty | Use Case |
-|-------|-----------|----------|
-| 🛡️ **Security Expert** | Vulnerabilities, OWASP | "Review auth code for security" |
-| ⚡ **Performance Expert** | Speed, Memory | "Why is my app slow?" |
-| 🧪 **Testing Specialist** | Unit tests, Coverage | "Add tests for this function" |
-| 🚀 **DevOps Expert** | CI/CD, Docker, K8s | "Create GitHub Actions workflow" |
-| 📝 **Code Reviewer** | Best practices | "Review this PR" |
-| 🏗️ **API Architect** | REST, GraphQL | "Design user management API" |
-| 💾 **Database Expert** | Query optimization | "Optimize this SQL query" |
-| 🎨 **Frontend Architect** | React, Vue, A11y | "Refactor this component" |
-| ⚙️ **Backend Architect** | Microservices | "Design scalable backend" |
-| 📚 **Documentation Expert** | API docs, READMEs | "Document this codebase" |
-| 🔄 **Refactoring Expert** | Clean code, SOLID | "Apply design patterns" |
-
-### 🔍 ShenCha - AI Code Auditor
-
-Fully autonomous AI code auditor:
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  🧠 ShenCha Audit Engine                                    │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│  1️⃣  SCAN    → AI discovers issues (no predefined rules)   │
-│  2️⃣  ANALYZE → Understands context and impact              │
-│  3️⃣  FIX     → Generates and applies fixes automatically   │
-│  4️⃣  VERIFY  → Confirms fixes work correctly               │
-│                                                             │
-│  ✅ Runs continuously in 72-hour cycles                     │
-│  ✅ Generates comprehensive reports                         │
-│                                                             │
-└─────────────────────────────────────────────────────────────┘
-```
+| **Code Quality** | `pr-review`, `code-review`, `refactoring` | Code analysis & improvement |
+| **Security** | `security-audit` | Security vulnerability scanning |
+| **Performance** | `performance-profiling` | Performance analysis |
+| **Documentation** | `documentation-gen` | Auto-generate documentation |
+| **Testing** | `tdd-workflow`, `systematic-debugging` | Test-driven development |
+| **DevOps** | `git-commit` | Git automation |
+| **Migration** | `migration-assistant` | Framework migrations |
+| **Planning** | `writing-plans`, `executing-plans`, `brainstorming` | Project planning |
+| **Verification** | `verification` | Code verification |
+| **Interview** | `interview` | Requirements gathering |
 
 ### 🎤 Interview-Driven Development
 
-> **"Interview first. Spec second. Code last."**
+Gather requirements before coding:
 
 ```bash
-ccjk interview          # Smart mode selector
-ccjk interview --quick  # 10 essential questions
-ccjk interview --deep   # 40+ comprehensive questions
+# Interactive interview mode
+ccjk interview
+
+# Quick mode (10 essential questions)
+ccjk interview --quick
+
+# Deep mode (40+ comprehensive questions)
+ccjk interview --deep
 ```
 
 ### 🌐 13+ API Providers
 
+Pre-configured support for popular AI providers:
+
 | Provider | Type | Free Tier |
 |----------|------|:---------:|
 | **Anthropic** | Official | - |
@@ -275,22 +213,85 @@ ccjk interview --deep   # 40+ comprehensive questions
 | **Ollama** | Local/Private | ✅ |
 | 302.AI, Qwen, SiliconFlow... | Chinese Providers | Varies |
 
+**Quick Setup with Presets:**
+```bash
+# Use provider presets for instant configuration
+npx ccjk init --provider 302ai --api-key YOUR_KEY
+npx ccjk init --provider glm --api-key YOUR_KEY
+npx ccjk init --provider minimax --api-key YOUR_KEY
+```
+
 ---
 
-## 📊 Why CCJK is #1
-
-| Feature | CCJK 2.0 | Cursor | Copilot | Others |
-|---------|:--------:|:------:|:-------:|:------:|
-| **Smart Skills** | ✅ Hot-reload | ❌ | ❌ | ❌ |
-| **AI Agents** | **11+** | 2 | 1 | 0-2 |
-| **Subagent System** | ✅ | ❌ | ❌ | ❌ |
-| **Permission Control** | ✅ | ❌ | ❌ | ❌ |
-| **Lifecycle Hooks** | ✅ | ❌ | ❌ | ❌ |
-| **Multi-Provider** | **13+** | 1 | 1 | 1-3 |
-| **Context Awareness** | ✅ | Partial | ❌ | ❌ |
-| **Zero Config** | ✅ | ❌ | ❌ | ❌ |
-| **Open Source** | ✅ | ❌ | ❌ | Varies |
-| **Free** | ✅ | ❌ | ❌ | Varies |
+## 📊 Why Choose CCJK?
+
+| Feature | CCJK | Manual Setup | Other Tools |
+|---------|:----:|:------------:|:-----------:|
+| **Zero Config** | ✅ One command | ❌ Hours of setup | ⚠️ Complex |
+| **Workflow Templates** | ✅ 16+ templates | ❌ Build yourself | ⚠️ Limited |
+| **Multi-Provider** | ✅ 13+ providers | ❌ Manual config | ⚠️ 1-3 providers |
+| **MCP Integration** | ✅ Auto-setup | ❌ Manual JSON | ⚠️ Partial |
+| **Bilingual Support** | ✅ EN + ZH | ❌ English only | ⚠️ Limited |
+| **Open Source** | ✅ MIT | - | Varies |
+| **Free** | ✅ | ✅ | ❌ Most paid |
+
+---
+
+## 🗺️ Roadmap
+
+The following features are planned for future releases:
+
+### 🔮 Planned Features (v2.0+)
+
+#### 🔥 Smart Skills Hot-Reload System
+- Real-time skill file watching and auto-reload
+- Edit skills without restarting Claude Code
+- Smart caching and instant activation
+- **Status**: Infrastructure implemented, integration in progress
+
+#### 🤖 Advanced Subagent Orchestration
+- Parallel and sequential AI agent execution
+- Multi-agent collaboration with task delegation
+- Transcript recording and analysis
+- **Status**: Core manager implemented, Claude Code integration pending
+
+#### 🛡️ Permission System
+- Fine-grained file and command access control
+- Wildcard pattern matching for flexible rules
+- Security-first skill execution
+- **Status**: Type definitions ready, implementation planned
+
+#### ⚡ Lifecycle Hooks System
+- Pre/post tool execution hooks
+- Custom workflow event handlers
+- Plugin-style extensibility
+- **Status**: Core system implemented, documentation in progress
+
+#### 🎯 Context-Aware Skill Activation
+- Auto-activate skills based on file patterns
+- Keyword-triggered skill suggestions
+- Intelligent skill recommendations
+- **Status**: Parser ready, activation logic planned
+
+#### 📦 Expanded Skill Marketplace
+- Community-contributed skills
+- One-click skill installation
+- Skill versioning and updates
+- **Status**: Registry infrastructure ready, marketplace UI planned
+
+#### 🔍 ShenCha AI Code Auditor
+- Autonomous code scanning and analysis
+- Automatic fix generation and application
+- Continuous 72-hour audit cycles
+- **Status**: Basic scanner implemented, full automation planned
+
+### 🎯 How to Contribute
+
+Interested in these features? We welcome contributions!
+
+- Check our [GitHub Issues](https://github.com/anthropics/claude-code/issues) for feature discussions
+- Join our [Discord](https://discord.gg/ccjk) to collaborate with the team
+- Submit PRs for features you'd like to see implemented
 
 ---
 
@@ -300,26 +301,25 @@ ccjk interview --deep   # 40+ comprehensive questions
 
 ```bash
 npx ccjk              # Interactive setup menu
-ccjk setup            # Guided onboarding
-ccjk doctor           # Health check
-ccjk upgrade          # Update everything
+ccjk init             # Full initialization
+ccjk update           # Update workflows
+ccjk interview        # Requirements gathering
 ```
 
-### Skills Management
+### Configuration Commands
 
 ```bash
-ccjk skills list                    # List all skills
-ccjk skills create my-skill         # Create new skill
-ccjk skills enable <skill>          # Enable a skill
-ccjk skills create-batch --lang ts  # Create TypeScript skills
+ccjk config-switch --list              # List available configs
+ccjk config-switch <name>              # Switch to a config
+ccjk uninstall                         # Uninstall CCJK
 ```
 
-### API Configuration
+### Tool Integration
 
 ```bash
-ccjk api wizard       # Interactive API setup
-ccjk api list         # Show providers
-ccjk api test         # Test connection
+ccjk ccr              # Claude Code Router setup
+ccjk ccu              # CCusage analytics
+ccjk check-updates    # Check for updates
 ```
 
 ---
@@ -329,8 +329,8 @@ ccjk api test         # Test connection
 ```bash
 ccjk init --lang en      # English
 ccjk init --lang zh-CN   # 简体中文
-ccjk init --lang ja      # 日本語
-ccjk init --lang ko      # 한국어
+ccjk init --lang ja      # 日本語 (coming soon)
+ccjk init --lang ko      # 한국어 (coming soon)
 ```
 
 ---
@@ -360,6 +360,8 @@ ccjk init --lang ko      # 한국어
 
 ## 🤝 Contributing
 
+We welcome contributions! Here's how to get started:
+
 ```bash
 git clone https://github.com/anthropics/claude-code.git
 cd ccjk
@@ -367,7 +369,7 @@ pnpm install
 pnpm dev
 ```
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
 
 ---
 
@@ -393,7 +395,7 @@ If CCJK helps you code better, please give us a star!
 
 ### 🔍 SEO Keywords
 
-`claude-code` `ai-coding-assistant` `claude-code-extension` `ai-developer-tools` `claude-ai` `anthropic` `llm-coding` `ai-agents` `code-automation` `smart-skills` `hot-reload` `subagent` `devops-ai` `security-audit` `performance-optimization` `typescript` `python` `javascript` `react` `vue` `nodejs` `docker` `kubernetes` `github-actions` `ci-cd` `code-quality` `best-practices` `clean-code` `copilot-alternative` `cursor-alternative` `windsurf-alternative` `free-ai-coding` `open-source-ai` `vscode-extension` `code-review-ai` `ai-pair-programming` `intelligent-coding` `developer-productivity` `coding-assistant` `ai-tools-2025`
+`claude-code` `ai-coding-assistant` `claude-code-extension` `ai-developer-tools` `claude-ai` `anthropic` `llm-coding` `workflow-templates` `code-automation` `zero-config` `multi-provider` `mcp-integration` `typescript` `python` `javascript` `react` `vue` `nodejs` `docker` `kubernetes` `github-actions` `ci-cd` `code-quality` `best-practices` `clean-code` `copilot-alternative` `cursor-alternative` `windsurf-alternative` `free-ai-coding` `open-source-ai` `vscode-extension` `ai-pair-programming` `intelligent-coding` `developer-productivity` `coding-assistant` `ai-tools-2025`
 
 </div>