ccjk 14.1.11 → 14.2.1

package/dist/templates/hooks/pre-commit-type-check.md

@@ -0,0 +1,377 @@
+---
+id: pre-commit-type-check
+type: PreToolUse
+name: TypeScript Type Check Pre-commit Hook
+description: Run TypeScript type checking before git commits to catch type errors
+priority: 10
+matcher: Bash(git commit *)
+command: npx tsc --noEmit
+timeout: 45000
+enabled: true
+applicableTo: [typescript, react, vue, angular, node]
+---
+
+# TypeScript Type Check Pre-commit Hook
+
+## Description
+
+This hook runs TypeScript type checking before every git commit to catch type errors early. It uses `tsc --noEmit` to perform type checking without generating output files, ensuring type safety without affecting the build process.
+
+## 描述
+
+此钩子在每次 git 提交前运行 TypeScript 类型检查以尽早发现类型错误。它使用 `tsc --noEmit` 执行类型检查而不生成输出文件，确保类型安全而不影响构建过程。
+
+## When it runs
+
+- **Trigger**: Before any `git commit` command
+- **Condition**: When TypeScript configuration (`tsconfig.json`) is detected
+- **Scope**: Runs type checking on all TypeScript files in the project
+
+## 运行时机
+
+- **触发器**: 任何 `git commit` 命令之前
+- **条件**: 检测到 TypeScript 配置（`tsconfig.json`）时
+- **范围**: 对项目中所有 TypeScript 文件运行类型检查
+
+## Configuration
+
+### Prerequisites
+```bash
+# Install TypeScript if not already installed
+npm install --save-dev typescript
+
+# Initialize TypeScript configuration
+npx tsc --init
+```
+
+### Basic tsconfig.json
+```json
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}
+```
+
+### Hook Configuration
+```yaml
+# In your CCJK configuration
+hooks:
+  pre-commit-type-check:
+    enabled: true
+    command: "npx tsc --noEmit"
+    timeout: 45000
+    failOnError: true
+```
+
+## 配置
+
+### 前置条件
+```bash
+# 如果尚未安装 TypeScript，请安装
+npm install --save-dev typescript
+
+# 初始化 TypeScript 配置
+npx tsc --init
+```
+
+### 基本 tsconfig.json
+```json
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}
+```
+
+## Customization
+
+### Custom TypeScript Configuration
+```yaml
+hooks:
+  pre-commit-type-check:
+    command: "npx tsc --noEmit --project tsconfig.build.json"
+    description: "Use specific TypeScript configuration for type checking"
+```
+
+### Check Specific Directories Only
+```yaml
+hooks:
+  pre-commit-type-check:
+    command: "npx tsc --noEmit src/**/*.ts"
+    include: ["src/**/*.ts", "src/**/*.tsx"]
+```
+
+### Skip Type Checking for Tests
+```json
+// tsconfig.build.json
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["**/*.test.ts", "**/*.spec.ts", "tests/**/*"]
+}
+```
+
+```yaml
+hooks:
+  pre-commit-type-check:
+    command: "npx tsc --noEmit --project tsconfig.build.json"
+```
+
+### Incremental Type Checking
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "incremental": true,
+    "tsBuildInfoFile": ".tsbuildinfo"
+  }
+}
+```
+
+```yaml
+hooks:
+  pre-commit-type-check:
+    command: "npx tsc --noEmit --incremental"
+    description: "Use incremental type checking for better performance"
+```
+
+### Integration with Multiple Projects
+```yaml
+hooks:
+  pre-commit-type-check-client:
+    command: "npx tsc --noEmit --project client/tsconfig.json"
+    priority: 10
+  pre-commit-type-check-server:
+    command: "npx tsc --noEmit --project server/tsconfig.json"
+    priority: 10
+```
+
+## 自定义
+
+### 自定义 TypeScript 配置
+```yaml
+hooks:
+  pre-commit-type-check:
+    command: "npx tsc --noEmit --project tsconfig.build.json"
+    description: "使用特定的 TypeScript 配置进行类型检查"
+```
+
+### 仅检查特定目录
+```yaml
+hooks:
+  pre-commit-type-check:
+    command: "npx tsc --noEmit src/**/*.ts"
+    include: ["src/**/*.ts", "src/**/*.tsx"]
+```
+
+### 跳过测试的类型检查
+```json
+// tsconfig.build.json
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["**/*.test.ts", "**/*.spec.ts", "tests/**/*"]
+}
+```
+
+## Error Handling
+
+- **Type errors found**: Commit is blocked with detailed type error information
+- **Configuration errors**: Commit is blocked with tsconfig.json error details
+- **Timeout**: Hook fails after 45 seconds (longer timeout for large projects)
+- **Missing TypeScript**: Hook is skipped with installation instructions
+- **Missing tsconfig.json**: Hook is skipped with configuration instructions
+
+## 错误处理
+
+- **发现类型错误**: 阻止提交并显示详细的类型错误信息
+- **配置错误**: 阻止提交并显示 tsconfig.json 错误详情
+- **超时**: 45 秒后钩子失败（大型项目的更长超时）
+- **缺少 TypeScript**: 跳过钩子并显示安装说明
+- **缺少 tsconfig.json**: 跳过钩子并显示配置说明
+
+## Advanced Configuration
+
+### Strict Type Checking
+```json
+// tsconfig.strict.json
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "strict": true,
+    "noImplicitAny": true,
+    "noImplicitReturns": true,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "exactOptionalPropertyTypes": true
+  }
+}
+```
+
+### Project References for Monorepos
+```json
+// tsconfig.json (root)
+{
+  "files": [],
+  "references": [
+    { "path": "./packages/core" },
+    { "path": "./packages/utils" },
+    { "path": "./apps/web" }
+  ]
+}
+```
+
+```yaml
+hooks:
+  pre-commit-type-check:
+    command: "npx tsc --build --noEmit"
+    description: "Type check all project references"
+```
+
+### Custom Compiler Options
+```yaml
+hooks:
+  pre-commit-type-check:
+    command: "npx tsc --noEmit --strict --noUnusedLocals --noUnusedParameters"
+    description: "Type check with additional strict options"
+```
+
+## 高级配置
+
+### 严格类型检查
+```json
+// tsconfig.strict.json
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "strict": true,
+    "noImplicitAny": true,
+    "noImplicitReturns": true,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "exactOptionalPropertyTypes": true
+  }
+}
+```
+
+### Monorepo 的项目引用
+```json
+// tsconfig.json (root)
+{
+  "files": [],
+  "references": [
+    { "path": "./packages/core" },
+    { "path": "./packages/utils" },
+    { "path": "./apps/web" }
+  ]
+}
+```
+
+## Performance Tips
+
+### Use Project References
+For large monorepos, use TypeScript project references to improve type checking performance.
+
+### Enable Incremental Compilation
+```json
+{
+  "compilerOptions": {
+    "incremental": true,
+    "tsBuildInfoFile": ".tsbuildinfo"
+  }
+}
+```
+
+### Skip Library Type Checking
+```json
+{
+  "compilerOptions": {
+    "skipLibCheck": true
+  }
+}
+```
+
+## 性能提示
+
+### 使用项目引用
+对于大型 monorepo，使用 TypeScript 项目引用来提高类型检查性能。
+
+### 启用增量编译
+```json
+{
+  "compilerOptions": {
+    "incremental": true,
+    "tsBuildInfoFile": ".tsbuildinfo"
+  }
+}
+```
+
+### 跳过库类型检查
+```json
+{
+  "compilerOptions": {
+    "skipLibCheck": true
+  }
+}
+```
+
+## Integration with Other Tools
+
+### Combine with ESLint
+```yaml
+hooks:
+  pre-commit-type-check:
+    command: "npx tsc --noEmit"
+    priority: 11
+  pre-commit-eslint:
+    command: "npx eslint --fix ."
+    priority: 10
+```
+
+### Use with Vue.js
+```json
+// tsconfig.json for Vue
+{
+  "compilerOptions": {
+    "jsx": "preserve",
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"]
+}
+```
+
+## 与其他工具集成
+
+### 与 ESLint 结合
+```yaml
+hooks:
+  pre-commit-type-check:
+    command: "npx tsc --noEmit"
+    priority: 11
+  pre-commit-eslint:
+    command: "npx eslint --fix ."
+    priority: 10
+```

package/dist/templates/skills/ccjk-init.md

@@ -0,0 +1,154 @@
+---
+name: ccjk-init
+description: Initialize CCJK environment with guided setup
+version: 1.0.0
+author: CCJK Team
+category: devops
+triggers:
+  - /ccjk-init
+  - /setup-ccjk
+use_when:
+  - User wants to set up CCJK
+  - When initializing a new project with CCJK
+  - When resetting CCJK configuration
+auto_activate: true
+priority: 9
+user_invocable: true
+context: inherit
+args:
+  - name: mode
+    description: Setup mode (full, quick, project)
+    required: false
+    default: "full"
+allowed_tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(npx ccjk *)
+  - Bash(ccjk *)
+  - Bash(ls *)
+  - Bash(cat *)
+  - Bash(mkdir *)
+hooks:
+  - type: SkillActivate
+    command: "echo '🚀 Starting CCJK initialization...'"
+  - type: SkillComplete
+    command: "echo '✅ CCJK initialization complete!'"
+timeout: 600
+---
+
+# CCJK Initialization Skill
+
+This skill guides users through CCJK setup with intelligent defaults and best practices.
+
+## Arguments
+
+- `$0` - **mode**: Setup mode (default: "full")
+  - `full` - Complete setup with all options
+  - `quick` - Quick setup with defaults
+  - `project` - Project-specific setup only
+
+## Initialization Workflow
+
+### Phase 1: Environment Check
+
+1. **Check Node.js version**
+   - Minimum: Node.js 20+
+   - Run: `node --version`
+
+2. **Check existing configuration**
+   - Look for `~/.claude.json`
+   - Look for `~/.claude/` directory
+   - Look for `.claude/` in current project
+
+3. **Detect code tool**
+   - Check if Claude Code is installed
+   - Check for other AI code tools
+
+### Phase 2: Configuration Setup
+
+Based on mode `$0`:
+
+#### Full Mode
+1. Configure API settings (provider, key, URL)
+2. Install MCP services
+3. Install workflows
+4. Set up output styles
+5. Configure cloud sync (optional)
+
+#### Quick Mode
+1. Use default API settings
+2. Install essential MCP services
+3. Install essential workflows
+
+#### Project Mode
+1. Create `.claude/` directory
+2. Set up project-specific settings
+3. Create project CLAUDE.md
+
+### Phase 3: Verification
+
+1. **Test API connection**
+   - Verify API key works
+   - Check model availability
+
+2. **Verify MCP services**
+   - Run `ccjk mcp doctor`
+   - Check service status
+
+3. **Verify workflows**
+   - Check command availability
+   - Test a simple workflow
+
+## Commands to Execute
+
+```bash
+# Full initialization
+npx ccjk init
+
+# Quick setup
+npx ccjk init --quick
+
+# Project setup only
+npx ccjk init --project
+```
+
+## Post-Initialization
+
+After setup, users can:
+
+1. **Use workflows**:
+   - `/init-project` - Initialize project context
+   - `/feat` - Feature development
+   - `/git-commit` - Smart commits
+
+2. **Manage MCP**:
+   - `ccjk mcp list` - List services
+   - `ccjk mcp install` - Add services
+
+3. **Create skills**:
+   - `ccjk skill create` - New skill
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Permission denied**
+   - Check write permissions to `~/.claude/`
+   - Run with appropriate permissions
+
+2. **API key invalid**
+   - Verify key format
+   - Check provider URL
+
+3. **MCP services failing**
+   - Run `ccjk mcp doctor`
+   - Check npm/npx availability
+
+## Example Usage
+
+```
+/ccjk-init full
+/ccjk-init quick
+/setup-ccjk project
+```

package/dist/templates/skills/ccjk-mcp-setup.md

@@ -0,0 +1,205 @@
+---
+name: ccjk-mcp-setup
+description: Interactive MCP service setup and configuration
+version: 1.0.0
+author: CCJK Team
+category: devops
+triggers:
+  - /mcp-setup
+  - /setup-mcp
+use_when:
+  - User wants to set up MCP services
+  - When configuring new MCP services
+  - When optimizing MCP configuration
+auto_activate: true
+priority: 8
+user_invocable: true
+context: inherit
+args:
+  - name: preset
+    description: MCP preset (minimal, standard, full, custom)
+    required: false
+    default: "standard"
+allowed_tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(ccjk mcp *)
+  - Bash(npx *)
+  - Bash(cat *)
+  - Bash(ls *)
+  - mcp__*
+hooks:
+  - type: SkillActivate
+    command: "ccjk mcp list 2>/dev/null || echo 'No MCP services installed'"
+timeout: 600
+---
+
+# MCP Setup Skill
+
+This skill helps users set up MCP services with intelligent presets and recommendations.
+
+## Arguments
+
+- `$0` - **preset**: MCP preset (default: "standard")
+  - `minimal` - Essential services only
+  - `standard` - Recommended services
+  - `full` - All available services
+  - `custom` - Interactive selection
+
+## MCP Presets
+
+### Minimal Preset
+Essential services for basic functionality:
+
+| Service | Purpose |
+|---------|--------|
+| `context7` | Documentation lookup |
+| `filesystem-mcp` | File operations |
+
+### Standard Preset (Recommended)
+Balanced set for most users:
+
+| Service | Purpose |
+|---------|--------|
+| `context7` | Documentation lookup |
+| `open-websearch` | Web search |
+| `filesystem-mcp` | File operations |
+| `github-mcp` | GitHub integration |
+
+### Full Preset
+All available services:
+
+| Service | Purpose |
+|---------|--------|
+| `context7` | Documentation lookup |
+| `open-websearch` | Web search |
+| `filesystem-mcp` | File operations |
+| `github-mcp` | GitHub integration |
+| `Playwright` | Browser automation |
+| `sqlite` | Database operations |
+| `mcp-deepwiki` | Wiki search |
+
+## Setup Workflow
+
+### Phase 1: Current State Analysis
+
+1. **Check existing MCP config**:
+   ```bash
+   cat ~/.claude/claude_desktop_config.json 2>/dev/null || echo 'No config found'
+   ```
+
+2. **List installed services**:
+   ```bash
+   ccjk mcp list
+   ```
+
+3. **Run diagnostics**:
+   ```bash
+   ccjk mcp doctor
+   ```
+
+### Phase 2: Preset Installation
+
+Based on preset `$0`:
+
+#### Minimal
+```bash
+ccjk mcp install context7
+ccjk mcp install filesystem-mcp
+```
+
+#### Standard
+```bash
+ccjk mcp install context7
+ccjk mcp install open-websearch
+ccjk mcp install filesystem-mcp
+ccjk mcp install github-mcp
+```
+
+#### Full
+```bash
+ccjk mcp install context7
+ccjk mcp install open-websearch
+ccjk mcp install filesystem-mcp
+ccjk mcp install github-mcp
+ccjk mcp install playwright
+ccjk mcp install sqlite
+ccjk mcp install mcp-deepwiki
+```
+
+#### Custom
+Interactive selection - ask user which services they want.
+
+### Phase 3: Configuration
+
+1. **Configure API keys** (if needed):
+   - GitHub token for `github-mcp`
+   - Other service credentials
+
+2. **Set environment variables**:
+   ```json
+   {
+     "mcpServers": {
+       "github-mcp": {
+         "env": {
+           "GITHUB_TOKEN": "your-token"
+         }
+       }
+     }
+   }
+   ```
+
+### Phase 4: Verification
+
+1. **Test each service**:
+   - Verify service starts
+   - Test basic functionality
+
+2. **Run final diagnostics**:
+   ```bash
+   ccjk mcp doctor
+   ```
+
+## Service Recommendations
+
+### By Use Case
+
+| Use Case | Recommended Services |
+|----------|---------------------|
+| **Web Development** | context7, playwright, github-mcp |
+| **Data Analysis** | sqlite, filesystem-mcp |
+| **Research** | open-websearch, mcp-deepwiki, context7 |
+| **DevOps** | github-mcp, filesystem-mcp |
+| **General** | context7, open-websearch, filesystem-mcp |
+
+### By Resource Usage
+
+| Level | Services | Memory |
+|-------|----------|--------|
+| **Low** | context7, filesystem-mcp | ~50MB |
+| **Medium** | + open-websearch, github-mcp | ~100MB |
+| **High** | + playwright, sqlite | ~200MB+ |
+
+## Troubleshooting
+
+### Service Won't Start
+
+1. Check npm/npx availability
+2. Verify package exists
+3. Check for port conflicts
+
+### Service Not Responding
+
+1. Restart Claude Code
+2. Check service logs
+3. Verify configuration
+
+## Example Usage
+
+```
+/mcp-setup minimal
+/mcp-setup standard
+/setup-mcp full
+/mcp-setup custom
+```