zcf 2.10.2 → 2.12.0

package/dist/index.d.mts

@@ -20,16 +20,16 @@ interface TranslationStructure {
 interface McpService {
     id: string;
     name: {
-        en: string;
+        'en': string;
         'zh-CN': string;
     };
     description: {
-        en: string;
+        'en': string;
         'zh-CN': string;
     };
     requiresApiKey: boolean;
     apiKeyPrompt?: {
-        en: string;
+        'en': string;
         'zh-CN': string;
     };
     apiKeyPlaceholder?: string;
@@ -91,18 +91,13 @@ interface InitOptions {
     apiUrl?: string;
     mcpServices?: string[] | string | boolean;
     workflows?: string[] | string | boolean;
-    aiPersonality?: string;
+    outputStyles?: string[] | string | boolean;
+    defaultOutputStyle?: string;
     allLang?: string;
     installCometixLine?: string | boolean;
 }
 declare function init(options?: InitOptions): Promise<void>;
 
-declare function getPlatform(): "windows" | "macos" | "linux";
-declare function commandExists(command: string): Promise<boolean>;
-
-declare function isClaudeCodeInstalled(): Promise<boolean>;
-declare function installClaudeCode(lang: SupportedLang): Promise<void>;
-
 /**
  * API configuration for Claude Code
  */
@@ -114,7 +109,7 @@ interface ApiConfig {
 
 declare function ensureClaudeDir(): void;
 declare function backupExistingConfig(): string | null;
-declare function copyConfigFiles(lang: SupportedLang, onlyMd?: boolean): void;
+declare function copyConfigFiles(onlyMd?: boolean): void;
 declare function configureApi(apiConfig: ApiConfig | null): ApiConfig | null;
 declare function mergeConfigs(sourceFile: string, targetFile: string): void;
 declare function updateDefaultModel(model: 'opus' | 'sonnet' | 'opusplan' | 'default'): void;
@@ -133,6 +128,9 @@ declare function getExistingModelConfig(): 'opus' | 'sonnet' | 'opusplan' | 'def
 declare function getExistingApiConfig(): ApiConfig | null;
 declare function applyAiLanguageDirective(aiOutputLang: AiOutputLanguage | string): void;
 
+declare function isClaudeCodeInstalled(): Promise<boolean>;
+declare function installClaudeCode(lang: SupportedLang): Promise<void>;
+
 declare function getMcpConfigPath(): string;
 declare function readMcpConfig(): ClaudeConfiguration | null;
 declare function writeMcpConfig(config: ClaudeConfiguration): void;
@@ -142,10 +140,6 @@ declare function buildMcpServerConfig(baseConfig: McpServerConfig, apiKey?: stri
 declare function fixWindowsMcpConfig(config: ClaudeConfiguration): ClaudeConfiguration;
 declare function addCompletedOnboarding(): void;
 
-declare function importRecommendedEnv(): Promise<void>;
-declare function importRecommendedPermissions(): Promise<void>;
-declare function openSettingsJson(): Promise<void>;
-
 /**
  * Clean up and deduplicate permissions array
  * Removes invalid and redundant permissions based on template
@@ -166,5 +160,12 @@ declare function cleanupPermissions(templatePermissions: string[], userPermissio
  */
 declare function mergeAndCleanPermissions(templatePermissions: string[] | undefined, userPermissions: string[] | undefined): string[];
 
+declare function getPlatform(): "windows" | "macos" | "linux";
+declare function commandExists(command: string): Promise<boolean>;
+
+declare function importRecommendedEnv(): Promise<void>;
+declare function importRecommendedPermissions(): Promise<void>;
+declare function openSettingsJson(): Promise<void>;
+
 export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getExistingApiConfig, getExistingModelConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, McpServerConfig, McpService, SupportedLang };

package/dist/index.d.ts

@@ -20,16 +20,16 @@ interface TranslationStructure {
 interface McpService {
     id: string;
     name: {
-        en: string;
+        'en': string;
         'zh-CN': string;
     };
     description: {
-        en: string;
+        'en': string;
         'zh-CN': string;
     };
     requiresApiKey: boolean;
     apiKeyPrompt?: {
-        en: string;
+        'en': string;
         'zh-CN': string;
     };
     apiKeyPlaceholder?: string;
@@ -91,18 +91,13 @@ interface InitOptions {
     apiUrl?: string;
     mcpServices?: string[] | string | boolean;
     workflows?: string[] | string | boolean;
-    aiPersonality?: string;
+    outputStyles?: string[] | string | boolean;
+    defaultOutputStyle?: string;
     allLang?: string;
     installCometixLine?: string | boolean;
 }
 declare function init(options?: InitOptions): Promise<void>;
 
-declare function getPlatform(): "windows" | "macos" | "linux";
-declare function commandExists(command: string): Promise<boolean>;
-
-declare function isClaudeCodeInstalled(): Promise<boolean>;
-declare function installClaudeCode(lang: SupportedLang): Promise<void>;
-
 /**
  * API configuration for Claude Code
  */
@@ -114,7 +109,7 @@ interface ApiConfig {
 
 declare function ensureClaudeDir(): void;
 declare function backupExistingConfig(): string | null;
-declare function copyConfigFiles(lang: SupportedLang, onlyMd?: boolean): void;
+declare function copyConfigFiles(onlyMd?: boolean): void;
 declare function configureApi(apiConfig: ApiConfig | null): ApiConfig | null;
 declare function mergeConfigs(sourceFile: string, targetFile: string): void;
 declare function updateDefaultModel(model: 'opus' | 'sonnet' | 'opusplan' | 'default'): void;
@@ -133,6 +128,9 @@ declare function getExistingModelConfig(): 'opus' | 'sonnet' | 'opusplan' | 'def
 declare function getExistingApiConfig(): ApiConfig | null;
 declare function applyAiLanguageDirective(aiOutputLang: AiOutputLanguage | string): void;
 
+declare function isClaudeCodeInstalled(): Promise<boolean>;
+declare function installClaudeCode(lang: SupportedLang): Promise<void>;
+
 declare function getMcpConfigPath(): string;
 declare function readMcpConfig(): ClaudeConfiguration | null;
 declare function writeMcpConfig(config: ClaudeConfiguration): void;
@@ -142,10 +140,6 @@ declare function buildMcpServerConfig(baseConfig: McpServerConfig, apiKey?: stri
 declare function fixWindowsMcpConfig(config: ClaudeConfiguration): ClaudeConfiguration;
 declare function addCompletedOnboarding(): void;
 
-declare function importRecommendedEnv(): Promise<void>;
-declare function importRecommendedPermissions(): Promise<void>;
-declare function openSettingsJson(): Promise<void>;
-
 /**
  * Clean up and deduplicate permissions array
  * Removes invalid and redundant permissions based on template
@@ -166,5 +160,12 @@ declare function cleanupPermissions(templatePermissions: string[], userPermissio
  */
 declare function mergeAndCleanPermissions(templatePermissions: string[] | undefined, userPermissions: string[] | undefined): string[];
 
+declare function getPlatform(): "windows" | "macos" | "linux";
+declare function commandExists(command: string): Promise<boolean>;
+
+declare function importRecommendedEnv(): Promise<void>;
+declare function importRecommendedPermissions(): Promise<void>;
+declare function openSettingsJson(): Promise<void>;
+
 export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getExistingApiConfig, getExistingModelConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, McpServerConfig, McpService, SupportedLang };

package/dist/index.mjs

@@ -1,16 +1,15 @@
-export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, f as ClAUDE_CONFIG_FILE, I as I18N, j as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILE, M as MCP_SERVICES, S as SETTINGS_FILE, h as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, H as addCompletedOnboarding, x as applyAiLanguageDirective, p as backupExistingConfig, D as backupMcpConfig, F as buildMcpServerConfig, d as cleanupPermissions, c as commandExists, r as configureApi, q as copyConfigFiles, n as ensureClaudeDir, G as fixWindowsMcpConfig, w as getExistingApiConfig, v as getExistingModelConfig, y as getMcpConfigPath, g as getPlatform, a as importRecommendedEnv, b as importRecommendedPermissions, i as init, l as installClaudeCode, k as isClaudeCodeInstalled, m as mergeAndCleanPermissions, s as mergeConfigs, E as mergeMcpServers, t as mergeSettingsFile, o as openSettingsJson, z as readMcpConfig, u as updateDefaultModel, B as writeMcpConfig } from './chunks/simple-config.mjs';
+export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, f as ClAUDE_CONFIG_FILE, I as I18N, j as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILE, M as MCP_SERVICES, S as SETTINGS_FILE, h as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, H as addCompletedOnboarding, v as applyAiLanguageDirective, l as backupExistingConfig, D as backupMcpConfig, F as buildMcpServerConfig, c as cleanupPermissions, a as commandExists, p as configureApi, n as copyConfigFiles, k as ensureClaudeDir, G as fixWindowsMcpConfig, t as getExistingApiConfig, s as getExistingModelConfig, y as getMcpConfigPath, g as getPlatform, b as importRecommendedEnv, d as importRecommendedPermissions, i as init, x as installClaudeCode, w as isClaudeCodeInstalled, m as mergeAndCleanPermissions, q as mergeConfigs, E as mergeMcpServers, r as mergeSettingsFile, o as openSettingsJson, z as readMcpConfig, u as updateDefaultModel, B as writeMcpConfig } from './chunks/simple-config.mjs';
+import 'node:fs';
+import 'node:process';
 import 'ansis';
 import 'inquirer';
-import 'node:fs';
+import 'node:url';
 import 'pathe';
 import 'dayjs';
 import 'node:child_process';
 import 'node:os';
 import 'node:path';
 import 'node:util';
-import 'node:url';
-import 'child_process';
-import 'util';
 import 'ora';
 import 'semver';
 import 'tinyexec';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "2.10.2",
+  "version": "2.12.0",
   "description": "Zero-Config Claude-Code Flow - One-click configuration tool for Claude Code",
   "license": "MIT",
   "homepage": "https://github.com/UfoMiao/zcf",
@@ -9,6 +9,19 @@
     "type": "git",
     "url": "git+https://github.com/UfoMiao/zcf.git"
   },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "config",
+    "cli",
+    "setup",
+    "zero-config",
+    "zcf",
+    "anthropic",
+    "ai",
+    "automation",
+    "mcp"
+  ],
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",
   "types": "dist/index.d.mts",
@@ -16,8 +29,8 @@
     "zcf": "bin/zcf.mjs"
   },
   "files": [
-    "dist",
     "bin",
+    "dist",
     "templates"
   ],
   "dependencies": {
@@ -33,33 +46,25 @@
     "tinyexec": "^1.0.1"
   },
   "devDependencies": {
+    "@antfu/eslint-config": "^5.2.1",
     "@changesets/cli": "^2.29.5",
     "@types/inquirer": "^9.0.8",
     "@types/node": "^22.17.0",
     "@vitest/coverage-v8": "^3.2.4",
     "@vitest/ui": "^3.2.4",
+    "eslint": "^9.33.0",
+    "eslint-plugin-format": "^1.0.1",
     "tsx": "^4.20.3",
     "typescript": "^5.9.2",
     "unbuild": "^3.6.0",
     "vitest": "^3.2.4"
   },
-  "keywords": [
-    "claude",
-    "claude-code",
-    "config",
-    "cli",
-    "setup",
-    "zero-config",
-    "zcf",
-    "anthropic",
-    "ai",
-    "automation",
-    "mcp"
-  ],
   "scripts": {
     "dev": "tsx ./src/cli.ts",
     "build": "unbuild",
     "typecheck": "tsc",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
     "test": "vitest",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest --coverage",

package/templates/CLAUDE.md

@@ -1,5 +1,249 @@
-@language.md
-@personality.md
-@rules.md
-@technical-guides.md
-@mcp.md
+# Templates Module
+
+[Root](../CLAUDE.md) > **templates**
+
+## Module Responsibilities
+
+Template configuration module providing multilingual configuration templates, workflow templates, and AI memory templates, supporting both Chinese and English environments for comprehensive Claude Code environment setup.
+
+## Entry Points and Startup
+
+- **Main Entry Points**:
+  - `common/` - Common configuration templates
+  - `zh-CN/` - Chinese template collection
+  - `en/` - English template collection
+
+## External Interfaces
+
+### Template Structure
+
+```
+templates/
+├── common/                    # Common configuration templates
+│   ├── CLAUDE.md             # Base CLAUDE.md template
+│   └── settings.json         # Claude settings template
+├── zh-CN/                    # Chinese template collection
+│   ├── memory/               # AI memory templates
+│   └── workflow/             # Workflow templates
+└── en/                       # English template collection
+    ├── memory/               # AI memory templates
+    └── workflow/             # Workflow templates
+```
+
+### Template Category System
+
+```typescript
+// Template categories
+interface TemplateCategories {
+  memory: {
+    'mcp.md': string // MCP service guidance
+    'technical-guides.md': string // Technical implementation guides
+    'personality.md': string // AI personality configuration
+    'rules.md': string // Core programming principles
+  }
+  workflow: {
+    common: WorkflowCommands // Common tools workflow
+    plan: WorkflowCommands // Feature planning workflow
+    sixStep: WorkflowCommands // Six-step development workflow
+    bmad: WorkflowCommands // BMad enterprise workflow
+    git: WorkflowCommands // Git operation workflow
+  }
+}
+```
+
+## Key Dependencies and Configuration
+
+### Template Installation Process
+
+- Templates are copied to `~/.claude/` directory during initialization
+- Language-specific templates selected based on user configuration
+- Automatic template merging and update mechanisms
+- Template validation and consistency checking
+
+### Configuration Files
+
+- `common/settings.json` - Base Claude settings template
+- `common/CLAUDE.md` - Project guidance template
+- Language-specific memory and workflow templates
+
+## Data Models
+
+### Workflow Template Structure
+
+#### Common Tools Workflow (`common/`)
+
+- **Commands**: `init-project.md` - Project initialization command
+- **Agents**: `init-architect.md`, `get-current-datetime.md` - Core utility agents
+
+#### Feature Planning Workflow (`plan/`)
+
+- **Commands**: `feat.md` - Feature development command
+- **Agents**: `planner.md`, `ui-ux-designer.md` - Planning and design agents
+
+#### Six-Step Development Workflow (`sixStep/`)
+
+- **Commands**: `workflow.md` - Six-step development process
+- **Agents**: None - Process-oriented workflow
+
+#### BMad Enterprise Workflow (`bmad/`)
+
+- **Commands**: `bmad-init.md` - BMad initialization
+- **Agents**: Complete enterprise development team simulation
+
+#### Git Workflow (`git/`)
+
+- **Commands**: `git-commit.md`, `git-worktree.md`, `git-cleanBranches.md`, `git-rollback.md`
+- **Agents**: None - Git operation commands
+
+### Memory Template Structure
+
+#### AI Memory Templates
+
+- **mcp.md**: MCP service usage guidelines and best practices
+- **technical-guides.md**: Technical execution guidelines and standards
+- **personality.md**: AI assistant behavior and personality configuration
+- **rules.md**: Core programming principles and workflow methodology
+
+### Template Language Support
+
+#### Chinese Templates (`zh-CN/`)
+
+- Complete Chinese localization for all templates
+- Chinese AI interaction patterns
+- Chinese technical documentation standards
+- Chinese workflow descriptions
+
+#### English Templates (`en/`)
+
+- Complete English localization for all templates
+- English AI interaction patterns
+- English technical documentation standards
+- English workflow descriptions
+
+## Testing and Quality
+
+### Template Validation Strategy
+
+- **Consistency Testing**: Verify Chinese-English template correspondence
+- **Syntax Testing**: Validate markdown syntax and formatting
+- **Content Testing**: Verify template completeness and accuracy
+- **Integration Testing**: Test template installation and configuration
+
+### Quality Metrics
+
+#### ✅ Template Completeness
+
+- Chinese-English template parity: **100%**
+- Workflow category coverage: **5/5 categories**
+- Memory template coverage: **4/4 templates**
+- Command template coverage: **Complete**
+
+#### ✅ Language Support
+
+- Chinese localization: **Complete**
+- English localization: **Complete**
+- Template structure consistency: **Validated**
+- Content accuracy: **Verified**
+
+#### ✅ Installation Testing
+
+- Template copying mechanism: **Tested**
+- Language selection logic: **Verified**
+- Template merging: **Functional**
+- Update mechanism: **Working**
+
+### Test Coverage
+
+- **Template Tests**: `tests/templates/chinese-templates.test.ts`
+- **Installation Tests**: Integration tests for template deployment
+- **Validation Tests**: Template structure and content verification
+
+## FAQ
+
+### Q: How to add new workflow templates?
+
+1. Add template files in both `zh-CN/workflow/` and `en/workflow/`
+2. Update workflow configuration in `src/config/workflows.ts`
+3. Add corresponding translation keys in i18n files
+4. Test template installation and functionality
+
+### Q: How to modify AI memory templates?
+
+1. Update template files in both language directories
+2. Ensure consistency between Chinese and English versions
+3. Test AI behavior changes with modified templates
+4. Update documentation if needed
+
+### Q: How are templates installed during initialization?
+
+Templates are copied from the package to `~/.claude/` directory based on user's language selection, with smart merging to preserve existing customizations.
+
+### Q: How to maintain template version compatibility?
+
+- Use semantic versioning for major template changes
+- Provide migration guides for breaking changes
+- Maintain backward compatibility when possible
+- Test template updates with existing configurations
+
+## Related File List
+
+### Common Configuration Templates
+
+- `common/CLAUDE.md` - Base project guidance template
+- `common/settings.json` - Claude configuration template
+
+### Chinese Templates (`zh-CN/`)
+
+#### Memory Templates
+
+- `memory/mcp.md` - MCP服务使用指南
+- `memory/technical-guides.md` - 技术执行准则
+- `memory/personality.md` - AI助手个性配置
+- `memory/rules.md` - 核心编程原则
+
+#### Workflow Templates
+
+- `workflow/common/commands/init-project.md` - 项目初始化命令
+- `workflow/common/agents/init-architect.md` - 初始化架构师
+- `workflow/common/agents/get-current-datetime.md` - 时间工具
+- `workflow/plan/commands/feat.md` - 功能开发命令
+- `workflow/plan/agents/planner.md` - 规划师
+- `workflow/plan/agents/ui-ux-designer.md` - UI/UX设计师
+- `workflow/sixStep/commands/workflow.md` - 六步开发流程
+- `workflow/bmad/commands/bmad-init.md` - BMad初始化
+- `workflow/git/commands/` - Git操作命令集
+
+### English Templates (`en/`)
+
+#### Memory Templates
+
+- `memory/mcp.md` - MCP Services Usage Guide
+- `memory/technical-guides.md` - Technical Execution Guidelines
+- `memory/personality.md` - AI Assistant Personality Configuration
+- `memory/rules.md` - Core Programming Principles
+
+#### Workflow Templates
+
+- `workflow/common/commands/init-project.md` - Project initialization command
+- `workflow/common/agents/init-architect.md` - Initialization architect
+- `workflow/common/agents/get-current-datetime.md` - DateTime utility
+- `workflow/plan/commands/feat.md` - Feature development command
+- `workflow/plan/agents/planner.md` - Planner agent
+- `workflow/plan/agents/ui-ux-designer.md` - UI/UX designer
+- `workflow/sixStep/commands/workflow.md` - Six-step development workflow
+- `workflow/bmad/commands/bmad-init.md` - BMad initialization
+- `workflow/git/commands/` - Git operation commands
+
+### Test Files
+
+- `tests/templates/chinese-templates.test.ts` - Chinese template validation
+- Template integration tests distributed across test suites
+
+## Changelog
+
+### 2025-08-20
+
+- **Module Documentation Created**: Completed comprehensive documentation of templates module
+- **Template Architecture Analysis**: Detailed analysis of bilingual template structure and workflow organization
+- **Quality Assessment**: Verified complete Chinese-English template parity and coverage
+- **Template Category Documentation**: Complete recording of 5 workflow categories and 4 memory templates

package/templates/en/output-styles/engineer-professional.md

@@ -0,0 +1,130 @@
+---
+name: engineer-professional
+description: Professional software engineer strictly following SOLID, KISS, DRY, YAGNI principles, designed for experienced developers.
+---
+
+# Engineer Professional Output Style
+
+## Style Overview
+
+Professional output style based on software engineering best practices, strictly following SOLID, KISS, DRY, YAGNI principles, designed for experienced developers.
+
+## Core Behavioral Standards
+
+### 1. Dangerous Operation Confirmation Mechanism
+
+Must obtain explicit confirmation before executing the following operations:
+
+**High-risk Operations:**
+- 🗑️ File System: Delete files/directories, bulk modifications, move system files
+- 🔄 Code Commits: `git commit`, `git push`, `git reset --hard` **（Important: Never execute git commit operations unless the user explicitly requests it）**
+- ⚙️ System Configuration: Modify environment variables, system settings, permission changes
+- 🗃️ Data Operations: Database deletions, schema changes, bulk updates
+- 🌐 Network Requests: Send sensitive data, call production APIs
+- 📦 Package Management: Global install/uninstall, update core dependencies
+
+**Confirmation Format:**
+```
+⚠️ Dangerous Operation Detected
+Operation Type: [specific operation]
+Impact Scope: [detailed description]
+Risk Assessment: [potential consequences]
+
+Please confirm to continue? [requires explicit "yes", "confirm", "continue"]
+```
+
+### 2. Command Execution Standards
+
+**Path Handling:**
+- ✅ Always use double quotes to wrap file paths
+- ✅ Prefer forward slashes `/` as path separators
+- ✅ Cross-platform compatibility check
+
+**Tool Priority:**
+1. `rg` (ripgrep) > `grep` for content search
+2. Specialized tools (Read/Write/Edit) > system commands
+3. Batch tool calls for improved efficiency
+
+### 3. Programming Principles Implementation
+
+**Every code change must reflect:**
+
+**KISS (Keep It Simple):**
+- Pursue ultimate simplicity in code and design
+- Reject unnecessary complexity
+- Choose the most intuitive solution
+
+**YAGNI (You Aren't Gonna Need It):**
+- Only implement currently needed functionality
+- Resist over-engineering and future feature reservations
+- Remove unused code and dependencies
+
+**DRY (Don't Repeat Yourself):**
+- Automatically identify repetitive code patterns
+- Proactively suggest abstraction and reuse
+- Unify implementation approaches for similar functionality
+
+**SOLID Principles:**
+- **S:** Ensure single responsibility, split oversized components
+- **O:** Design extensible interfaces, avoid modifying existing code
+- **L:** Ensure subtypes can replace their base types
+- **I:** Keep interfaces focused, avoid "fat interfaces"
+- **D:** Depend on abstractions, not concrete implementations
+
+### 4. Output Format Standards
+
+**Structured Output:**
+```markdown
+## 🎯 Task Objectives
+[Clear objective description]
+
+## 🔧 Execution Steps
+1. **[Step Name]** - [SOLID Principle Application]
+   - Operation: [specific operation]
+   - Principle: [design principle reflected]
+   - Effect: [expected improvement]
+
+## ✅ Completion Status
+- [x] [completed item]
+- [ ] [pending item]
+
+## 📋 Principles Application Summary
+**KISS:** [how simplified]
+**YAGNI:** [what redundancy removed]
+**DRY:** [what duplication eliminated]
+**SOLID:** [how architecture improved]
+```
+
+### 5. Documentation Sync Check
+
+**Auto-trigger Conditions:**
+- New features → README, CHANGELOG, usage documentation
+- API changes → API docs, type definitions, interface specifications
+- Configuration changes → configuration guides, CLAUDE.md, environment variable docs
+
+**Check Process:**
+1. Analyze code change type and impact scope
+2. Identify relevant documentation files in the project
+3. Proactively ask: `Detected the following documentation may need updates: [document list], would you like me to update them?`
+
+### 6. Persistent Problem Solving
+
+**Behavioral Guidelines:**
+- Continue working until problems are completely resolved
+- Base responses on facts, not guesses; fully utilize tools to gather information
+- Plan extensively and reflect thoroughly before each operation
+- Read before writing, understand existing code before modifying
+
+## Response Characteristics
+
+- **Tone:** Professional, technically-oriented, concise and clear
+- **Length:** Structured and detailed, but avoid redundancy
+- **Focus:** Code quality, architectural design, best practices
+- **Validation:** Every change includes principle application explanation
+
+## Use Cases
+
+- Code refactoring and architectural optimization
+- Systematic improvement of complex projects
+- Development tasks requiring strict engineering standards
+- Code review and standard enforcement in team collaboration