ccjk 7.0.0 → 7.0.2

package/skills/ccjk/references/ccjk-defaults.md

@@ -1,265 +0,0 @@
-# CCJK Shared Defaults
-
-> **Purpose**: Centralized configuration and patterns for all CCJK child skills
-> **Used By**: All child skills via inheritance
-
-## 🎯 What This File Provides
-
-All CCJK child skills inherit these defaults, ensuring consistency and reducing duplication.
-
-## 📝 Code Generation Defaults
-
-### TypeScript Configuration
-```typescript
-// Always use these TypeScript defaults
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  }
-}
-```
-
-### Import/Export Style
-```typescript
-// ✅ CORRECT: ESM imports
-import { foo } from './foo'
-export { bar }
-
-// ❌ INCORRECT: CommonJS
-const foo = require('./foo')
-module.exports = { bar }
-```
-
-### Error Handling Pattern
-```typescript
-// Standard error handling for all CCJK code
-class CCJKError extends Error {
-  constructor(
-    message: string,
-    public code: string,
-    public details?: unknown
-  ) {
-    super(i18n.t(`errors.${code}`))
-    this.name = 'CCJKError'
-  }
-}
-
-// Usage
-throw new CCJKError('Failed to load config', 'CONFIG_LOAD_FAILED', { path })
-```
-
-## 📁 Cross-Platform Paths
-
-### Path Resolution
-```typescript
-import path from 'node:path'
-import os from 'node:os'
-
-// Config directories (platform-aware)
-export const PATHS = {
-  config: process.env.APPDATA || path.join(os.homedir(), '.config'),
-  cache: path.join(os.homedir(), '.ccjk', 'cache'),
-  data: path.join(os.homedir(), '.ccjk'),
-  temp: os.tmpdir()
-}
-```
-
-### Path Separators
-```typescript
-// ✅ CORRECT: Use path.join for cross-platform
-const configPath = path.join(os.homedir(), '.ccjk', 'config.json')
-
-// ❌ INCORRECT: Hardcoded separators (won't work on Windows)
-const configPath = os.homedir() + '/.ccjk/config.json'
-```
-
-## 🔒 Security Patterns
-
-### Environment Variables
-```typescript
-// ✅ CORRECT: Use environment variables for secrets
-const apiKey = process.env.CCJK_API_KEY
-
-// ❌ INCORRECT: Hardcoded secrets
-const apiKey = 'sk-ant-xxx...'
-```
-
-### File Permissions
-```typescript
-// Check file permissions before operations
-import { access } from 'node:fs/promises'
-
-async function ensureWriteAccess(filePath: string) {
-  try {
-    await access(filePath, constants.W_OK)
-    return true
-  } catch {
-    return false
-  }
-}
-```
-
-## 🌍 i18n Patterns
-
-### User-Facing Strings
-```typescript
-// ✅ CORRECT: Use i18n for user-facing strings
-console.log(i18n.t('cli.init.success'))
-
-// ❌ INCORRECT: Hardcoded strings
-console.log('Initialization successful')
-```
-
-### Error Messages
-```typescript
-// ✅ CORRECT: i18n with context
-throw new Error(i18n.t('errors.config.notFound', { path }))
-
-// ❌ INCORRECT: Hardcoded error
-throw new Error(`Config not found: ${path}`)
-```
-
-## 🧪 Testing Patterns
-
-### Test Structure
-```typescript
-describe('FeatureName', () => {
-  describe('functionName()', () => {
-    it('should do X when Y', async () => {
-      // Arrange
-      const input = createMockInput()
-
-      // Act
-      const result = await functionName(input)
-
-      // Assert
-      expect(result).toEqual(expectedOutput)
-    })
-  })
-})
-```
-
-### Coverage Goals
-- Lines: > 80%
-- Functions: > 80%
-- Branches: > 80%
-- Statements: > 80%
-
-## 🎨 Code Style
-
-### Naming Conventions
-- **Files**: kebab-case (`config-manager.ts`)
-- **Variables**: camelCase (`const configPath`)
-- **Classes**: PascalCase (`class ConfigManager`)
-- **Constants**: SCREAMING_SNAKE_CASE (`const MAX_RETRIES`)
-- **Types/Interfaces**: PascalCase (`interface ConfigOptions`)
-- **Enums**: PascalCase (`enum ErrorType`)
-
-### Formatting
-- Use `@antfu/eslint-config`
-- 2 space indentation
-- Single quotes for strings
-- Semicolons required
-- Trailing commas in objects/arrays
-
-## 🔧 Configuration Defaults
-
-### Default Config Structure
-```typescript
-interface CCJKConfig {
-  version: string
-  apiProvider: string
-  mcpServers: Record<string, MCPConfig>
-  workflows: Record<string, WorkflowConfig>
-  features: FeatureFlags
-}
-
-interface MCPConfig {
-  transport: 'stdio' | 'sse'
-  command?: string
-  args?: string[]
-  env?: Record<string, string>
-}
-
-interface FeatureFlags {
-  cloudSync: boolean
-  remoteExecution: boolean
-  errorTerminator: boolean
-}
-```
-
-### Default Values
-```typescript
-export const DEFAULTS = {
-  timeout: 30000,              // 30 seconds
-  retries: 3,
-  cacheTTL: 24 * 60 * 60 * 1000,  // 24 hours
-  maxCacheSize: 100 * 1024 * 1024,  // 100MB
-  logLevel: 'info' as const
-}
-```
-
-## 🚀 Performance Patterns
-
-### Async Operations
-```typescript
-// ✅ CORRECT: Use Promise.all for parallel operations
-const [config1, config2] = await Promise.all([
-  loadConfig('config1.json'),
-  loadConfig('config2.json')
-])
-
-// ❌ INCORRECT: Sequential await (slower)
-const config1 = await loadConfig('config1.json')
-const config2 = await loadConfig('config2.json')
-```
-
-### Caching Strategy
-```typescript
-// Cache-first pattern with fallback
-async function getCachedOrFetch(key: string) {
-  const cached = await cache.get(key)
-  if (cached && !isExpired(cached)) {
-    return cached
-  }
-
-  const fresh = await fetchFromSource(key)
-  await cache.set(key, fresh)
-  return fresh
-}
-```
-
-## 📋 Platform-Specific Notes
-
-### Windows
-- Use `path.join()` for paths
-- Use `process.env.APPDATA` for config
-- Handle both PowerShell and CMD
-- Line endings: CRLF
-
-### macOS/Linux
-- Use `path.join()` for paths
-- Use `~/.config` for config
-- Use bash/zsh scripts
-- Line endings: LF
-
-### Termux
-- Paths: `/data/data/com.termux/files/home/.ccjk`
-- Limited package support
-- Some features may not work
-
-## 🔗 Related Files
-
-- [Coding Standards](./coding-standards.md)
-- [Platform Conventions](./platform-conventions.md)
-- [Error Patterns](./error-patterns.md)
-
----
-
-**Note**: When this file is updated, all child skills benefit from the changes automatically.

package/skills/ccjk/references/coding-standards.md

@@ -1,198 +0,0 @@
-# CCJK Coding Standards
-
-> **Purpose**: Define coding standards for all CCJK development
-> **Applied To**: All generated code, child skills
-
-## 🎯 Core Principles
-
-### 1. TypeScript-First
-- ✅ Use TypeScript for all new code
-- ✅ Enable strict mode
-- ✅ Provide explicit type annotations
-- ❌ Avoid `any` without good reason
-
-```typescript
-// ✅ GOOD
-interface Config {
-  name: string
-  version: string
-}
-
-function loadConfig(config: Config): void {
-  // ...
-}
-
-// ❌ BAD
-function loadConfig(config: any): void {
-  // ...
-}
-```
-
-### 2. English Comments Only
-- ✅ All code comments in English
-- ✅ All documentation in English (except README_zh-CN)
-- ❌ No Chinese in code comments
-
-```typescript
-// ✅ GOOD: Clear English comment
-// Load MCP configuration from file
-async function loadMCPConfig(): Promise<MCPConfig> {
-  // ...
-}
-
-// ❌ BAD: Chinese comment
-// 加载 MCP 配置
-async function loadMCPConfig(): Promise<MCPConfig> {
-  // ...
-}
-```
-
-### 3. i18n for User-Facing Strings
-- ✅ Use `i18n.t()` for all user-facing strings
-- ✅ Support both zh-CN and en
-- ❌ Don't hardcode user messages
-
-```typescript
-// ✅ GOOD
-console.log(i18n.t('cli.init.success'))
-
-// ❌ BAD
-console.log('初始化成功')  // Chinese
-console.log('Init success')  // English, not translatable
-```
-
-### 4. ESM-Only
-- ✅ Use ES modules (import/export)
-- ❌ Don't use CommonJS (require/module.exports)
-
-```typescript
-// ✅ GOOD: ESM
-import { foo } from './foo'
-export { bar }
-
-// ❌ BAD: CommonJS
-const foo = require('./foo')
-module.exports = { bar }
-```
-
-## 📝 File Organization
-
-### Directory Structure
-```
-src/
-├── commands/       # CLI commands
-├── utils/          # Utility functions
-├── i18n/           # Internationalization
-├── types/          # Type definitions
-└── config/         # Configuration management
-```
-
-### File Naming
-- Source files: kebab-case (`config-manager.ts`)
-- Test files: `*.test.ts` suffix
-- Type files: `*.types.ts` or `types.ts`
-
-## 🎨 Code Style
-
-### Naming Conventions
-| Type | Convention | Example |
-|------|-----------|---------|
-| Variables | camelCase | `const configPath` |
-| Functions | camelCase | `function loadConfig()` |
-| Classes | PascalCase | `class ConfigManager` |
-| Interfaces | PascalCase | `interface IConfig` |
-| Types | PascalCase | `type ConfigOptions` |
-| Constants | SCREAMING_SNAKE_CASE | `const MAX_RETRIES` |
-
-### Indentation & Spacing
-- 2 spaces (no tabs)
-- Single quotes for strings
-- Semicolons required
-- Trailing commas in objects/arrays
-
-## 🧪 Testing Standards
-
-### Test Structure
-```typescript
-describe('FeatureName', () => {
-  describe('functionName()', () => {
-    it('should do X when Y', async () => {
-      // Arrange
-      const input = createMockInput()
-
-      // Act
-      const result = await functionName(input)
-
-      // Assert
-      expect(result).toEqual(expectedOutput)
-    })
-  })
-})
-```
-
-### Coverage Goals
-- Lines: > 80%
-- Functions: > 80%
-- Branches: > 80%
-- Statements: > 80%
-
-## 🔒 Error Handling
-
-### Error Class
-```typescript
-class CCJKError extends Error {
-  constructor(
-    message: string,
-    public code: string,
-    public details?: unknown
-  ) {
-    super(i18n.t(`errors.${code}`))
-    this.name = 'CCJKError'
-  }
-}
-```
-
-### Error Throwing
-```typescript
-// ✅ GOOD: Use custom error
-throw new CCJKError(
-  'Failed to load configuration',
-  'CONFIG_LOAD_FAILED',
-  { path }
-)
-
-// ❌ BAD: Throw string
-throw 'Config not found'
-```
-
-## 📚 Documentation Standards
-
-### Function Documentation
-```typescript
-/**
- * Load CCJK configuration from file
- * @param configPath - Path to config file
- * @returns Parsed configuration object
- * @throws {CCJKError} If file not found or invalid JSON
- */
-async function loadConfig(configPath: string): Promise<CCJKConfig> {
-  // ...
-}
-```
-
-### JSDoc Tags
-- `@param` - Parameter description
-- `@returns` - Return value description
-- `@throws` - Error conditions
-- `@example` - Usage example
-
-## 🔗 Related Files
-
-- [CCJK Defaults](./ccjk-defaults.md)
-- [Platform Conventions](./platform-conventions.md)
-- [Error Patterns](./error-patterns.md)
-
----
-
-**Status**: ✅ Active standard
-**Enforced By**: ESLint, TypeScript compiler