From e79c4293a92124d15fe668c510e946ea0c278b6e Mon Sep 17 00:00:00 2001
From: catlog22 <catlog22@github.com>
Date: Sun, 7 Sep 2025 17:51:57 +0800
Subject: [PATCH] Add remote installation script documentation to README files
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Added Quick Install section with one-liner PowerShell command
- Included installation parameters and options table
- Updated repository URLs to reflect catlog22/Claude-CCW naming
- Provided both English and Chinese documentation for remote installation
- Enhanced installation guide with manual and automated options

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md    | 535 +++++++++++++++--------------------------
 README_CN.md | 660 +++++++++++++++------------------------------------
 2 files changed, 379 insertions(+), 816 deletions(-)

diff --git a/README.md b/README.md
index a65fd3ee..6c517bf4 100644
--- a/README.md
+++ b/README.md
@@ -1,375 +1,228 @@
-# Claude Code Workflow (CCW) - Intelligent Development Workflow System
+# Claude Code Workflow (CCW)
 
-[中文](README_CN.md) | **English**
+A sophisticated multi-agent automation workflow framework that transforms complex software development tasks from conceptualization to implementation review into manageable, trackable, AI-orchestrated processes.
 
-**An innovative AI-powered development workflow orchestration system featuring progressive complexity management, document-state separation architecture, and intelligent multi-agent coordination.**
+## 🏗️ Architecture Overview
 
-> 🚀 **Version 2.0+** - Next-generation development automation with advanced architectural patterns and intelligent workflow orchestration.
+Claude Code Workflow (CCW) is built on two foundational pillars:
 
-## 🏗️ System Architecture
+### **Document-State Separation**
+- **Documents (*.md)**: Store human-readable plans, strategies, analysis reports, and summaries
+- **State (*.json)**: Manage machine-readable, dynamic workflow states and task definitions
+- This separation ensures robustness, recoverability, and automated processing capabilities
 
-Claude Code Workflow implements a **4-layer intelligent development architecture**:
-
-### 🧠 Core Innovation: Document-State Separation Pattern
-- **Markdown Files** → Planning, requirements, task structure, implementation strategy
-- **JSON Files** → Execution state, progress tracking, session metadata, dynamic changes
-- **Auto-Sync Engine** → Bidirectional coordination with clear ownership rules
-
-### ⚡ Progressive Complexity Management
-- **Level 0** (Simple): <5 tasks, minimal structure, direct execution
-- **Level 1** (Medium): 5-15 tasks, enhanced planning, agent coordination
-- **Level 2** (Complex): >15 tasks, full orchestration, iterative refinement
-
-### 🤖 Intelligent Agent Orchestration
-- **5 Specialized Agents**: Planning → Development → Review → Quality → Memory
-- **Context Preservation**: Original task context maintained throughout agent chain
-- **Quality Gates**: Each agent validates input and ensures output standards
-- **Adaptive Workflows**: Workflow depth matches task complexity requirements
-
-### 🔄 Advanced Features
-- **Session-First Architecture**: All commands auto-discover and inherit active session context
-- **Embedded Workflow Logic**: Commands contain built-in document generation
-- **Gemini CLI Integration**: 12+ specialized templates for intelligent context management
-- **Real-time Synchronization**: Reliable document-state coordination with conflict resolution
-
-## 🔥 Revolutionary Features
-
-### 🎯 Intelligent Workflow Orchestration
-**Three Execution Patterns**:
-- **Simple**: `TodoWrite → Context → Implementation → Review`
-- **Medium**: `TodoWrite → Planning → Implementation → Review`  
-- **Complex**: `TodoWrite → Planning → Implementation → Review → Iteration (max 2 cycles)`
-
-### 🏗️ Advanced Architecture Components
-
-#### 1. **5-Agent Specialized System**
-- **Action Planning Agent** (27KB) - PRD processing & implementation plans
-- **Code Developer** (13KB) - Test-driven development expert  
-- **Code Review Agent** (12KB) - Quality assurance & security validation
-- **Conceptual Planning Agent** (9KB) - High-level concept design
-- **Memory Gemini Bridge** (8KB) - Distributed memory synchronization
-
-#### 2. **Dynamic Template Ecosystem**
-- **10 Role-Based Planning Templates**: Multi-perspective brainstorming
-- **6 Tech-Stack Templates**: Language-specific development guidelines
-- **Script-Based Discovery**: YAML frontmatter parsing with semantic loading
-- **Conditional Content Filtering**: Version-aware template management
-
-#### 3. **JSON Document Coordination System**
-**Hierarchical File Structure**:
-```
-.workflow/WFS-[topic-slug]/
-├── workflow-session.json (master state)
-├── IMPL_PLAN.md (planning document)
-├── TODO_LIST.md (progress tracking)
-└── .task/
-    ├── impl-*.json (main tasks)
-    ├── impl-*.*.json (subtasks)
-    └── impl-*.*.*.json (detailed subtasks, max 3 levels)
-```
-
-**Data Ownership Rules**:
-- **Documents Own**: Implementation strategy, requirements, context
-- **JSON Owns**: Task definitions, status, progress, dependencies  
-- **Shared Responsibility**: Task status, progress calculation, cross-references
-
-#### 4. **Real-time Synchronization Engine**
-```
-File System Monitor → Change Parser → Conflict Detector → Sync Engine → Validator → Audit Log
-```
-**Conflict Resolution Priority**: Data ownership rules → Recent timestamp → User intent → System consistency
-
-## 📁 Project Structure
-
-```
-Claude-CCW/
-├── .claude/
-│   ├── agents/                    # Specialized development agents
-│   │   ├── conceptual-planning-agent.md
-│   │   ├── action-planning-agent.md
-│   │   ├── code-developer.md
-│   │   ├── code-review-agent.md
-│   │   └── [4 more agents]
-│   ├── commands/                  # Command implementations with file output
-│   │   ├── workflow/              # 8 core workflow commands (all with file generation)
-│   │   ├── task/                  # 6 task management commands (JSON + summary files)
-│   │   ├── docs/                  # Documentation management commands  
-│   │   └── [utility commands]
-│   ├── planning-templates/        # 10 role-based planning templates
-│   │   ├── system-architect.md
-│   │   ├── ui-designer.md
-│   │   └── [8 more roles]
-│   ├── tech-stack-templates/      # 6 language-specific guidelines
-│   │   ├── javascript-dev.md
-│   │   ├── python-dev.md
-│   │   ├── react-dev.md
-│   │   └── [3 more languages]
-│   ├── scripts/                   # Dynamic template loaders & executors
-│   │   ├── plan-executor.sh
-│   │   ├── tech-stack-loader.sh
-│   │   └── gemini-chat-executor.sh
-│   ├── schemas/                   # JSON schemas for state management
-│   │   ├── workflow-session.json
-│   │   ├── task.json
-│   │   └── issue.json
-│   ├── output-styles/             # Document generation templates
-│   │   └── agent-workflow-coordination.md
-│   └── workflows/                 # Unified workflow system principles
-│       ├── unified-workflow-system-principles.md
-│       ├── session-management-principles.md
-│       ├── file-structure-standards.md
-│       └── [18+ workflow guidelines]
-├── .workflow/                     # Generated workflow sessions
-│   ├── WFS-[topic-slug]/          # Individual session directories
-│   │   ├── workflow-session.json # Session state
-│   │   ├── IMPL_PLAN.md          # Planning document
-│   │   ├── TODO_LIST.md          # Task tracking
-│   │   ├── WORKFLOW_ISSUES.md    # Issue tracking
-│   │   ├── .task/                # JSON task files
-│   │   ├── .summaries/           # Completion summaries
-│   │   └── reports/              # Status reports
-│   └── session_status.jsonl     # Multi-session registry
-├── CLAUDE.md                     # Project-specific guidelines
-└── [Project documentation files]
-```
+### **Progressive Complexity**
+CCW intelligently adapts its file structure and workflow processes based on task complexity:
+- **Simple workflows**: Lightweight structure for single-file bug fixes
+- **Medium workflows**: Enhanced documentation with progress visualization
+- **Complex workflows**: Complete document suite with detailed implementation plans and multi-round iteration
 
 ## 🚀 Core Features
 
-### 1. Unified File Output System
+### Multi-Agent System
+- **Conceptual Planning Agent**: Multi-perspective brainstorming and concept planning
+- **Action Planning Agent**: Converts high-level concepts into executable implementation plans
+- **Code Developer**: Implements code based on plans
+- **Code Review Agent**: Reviews code quality and compliance
+- **Memory Gemini Bridge**: Synchronizes Claude and Gemini memory, maintains CLAUDE.md files
 
-**All Workflow Commands Generate Files**:
+### Workflow Session Management
+- Create, pause, resume, list, and switch workflow sessions
+- Automatic initialization of required file and directory structures
+- Hierarchical workflow filesystem (`.workflow/WFS-[topic-slug]/`)
+
+### Intelligent Context Generation
+- Dynamic context construction based on technology stack detection
+- Project structure analysis and domain keyword extraction
+- Optimized file targeting for Gemini CLI integration
+
+### Dynamic Change Management
+- Issue tracking and integration (`/workflow:issue`)
+- Automatic re-planning capabilities (`/task:replan`)
+- Seamless adaptation to changing requirements
+
+## 📁 Directory Structure
+
+```
+.claude/
+├── agents/                 # AI agent definitions and behaviors
+├── commands/              # CLI command implementations
+├── output-styles/         # Output formatting templates
+├── planning-templates/    # Role-specific planning approaches
+├── prompt-templates/      # AI interaction templates
+├── scripts/              # Automation scripts
+├── tech-stack-templates/ # Technology-specific templates
+├── workflows/            # Workflow definitions and guides
+└── settings.local.json   # Local configuration
+```
+
+## 🛠️ Installation
+
+### Quick Install (Recommended)
+
+**One-liner remote installation:**
+
+```powershell
+# PowerShell (Windows/Linux/macOS)
+Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content
+```
+
+**With parameters:**
+```powershell
+# Global installation
+Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content | ForEach-Object { iex "$_ -Global" }
+
+# Custom directory installation  
+Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content | ForEach-Object { iex "$_ -Directory 'C:\MyCustomPath'" }
+
+# Force installation (overwrites existing)
+Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content | ForEach-Object { iex "$_ -Force" }
+```
+
+### Manual Installation
+
+1. Clone this repository:
 ```bash
-# Context analysis with exportable reports  
-/workflow:context --export --health-check
-# → Generates reports/STATUS_REPORT.md and reports/HEALTH_CHECK.md
-
-# Implementation with comprehensive logging
-/workflow:implement --type=medium
-# → Generates TODO_LIST.md and IMPLEMENTATION_LOG.md
-
-# Issue tracking with structured files
-/workflow:issue create --type=feature "OAuth2 support"
-# → Generates WORKFLOW_ISSUES.md and issues/ISS-001.json
-```
-
-**Dynamic Template System**:
-```bash
-# Discover available planning roles
-~/.claude/scripts/plan-executor.sh --list
-
-# Load specific role semantically  
-~/.claude/scripts/plan-executor.sh --load system-architect
-```
-
-### 2. Multi-Agent Workflow Orchestration
-
-**Simple Tasks** (Bug fixes, single-file changes):
-```bash
-/workflow:session start simple "Fix login button styling"
-/workflow:implement --type=simple
-# Auto-completes with minimal overhead
-```
-
-**Medium Tasks** (Multi-component features):
-```bash  
-/workflow:session start medium "Add user profile editing"
-/workflow:plan                      # Lightweight planning
-/workflow:implement --type=medium   # Multi-agent execution
-/workflow:review                    # Quality validation
-```
-
-**Complex Tasks** (System-level changes):
-```bash
-/workflow:session start complex "Implement OAuth2 authentication"
-/workflow:plan                      # Detailed planning with PRD
-/workflow:implement --type=complex  # Full agent orchestration
-/task:create "Design OAuth2 architecture"
-/task:breakdown IMPL-001
-/workflow:status                    # Progress monitoring
-/workflow:review                    # Comprehensive review
-```
-
-### 3. Session Management with State Persistence
-
-**Complete Session Control**:
-- **JSON State Management**: All workflow state persisted in `workflow-session.json`
-- **Task-Level Tracking**: Detailed task management in `tasks.json`
-- **Pause/Resume**: Safe interruption and recovery
-- **Progress Monitoring**: Real-time TodoWrite integration
-
-**Session Example**:
-```json
-{
-  "session_id": "WFS-2025-001",
-  "type": "complex",
-  "current_phase": "IMPLEMENT", 
-  "phases": {
-    "PLAN": {"status": "completed"},
-    "IMPLEMENT": {"status": "active", "progress": 60},
-    "REVIEW": {"status": "pending"}
-  }
-}
-```
-
-### 4. Intelligent Context Analysis
-
-**Gemini CLI Integration** with 12+ specialized templates:
-- **Architecture Analysis**: System structure and component relationships
-- **Security Review**: Vulnerability assessment and compliance
-- **Performance Analysis**: Optimization opportunities and bottlenecks
-- **Pattern Detection**: Code patterns and best practices
-- **Dependency Analysis**: Module relationships and impacts
-
-### 5. Unified Task Management  
-
-**Dual-Layer Architecture**:
-- **Workflow Layer**: Macro-level session and phase management
-- **Task Layer**: Micro-level task execution and tracking
-- **Automatic Synchronization**: Bi-directional data consistency
-- **Unified Status**: Single command for complete project overview
-
-## 🎯 Usage Examples
-
-### Multi-Perspective Feature Planning
-```bash
-# Use conceptual planning agent for brainstorming
-# System loads multiple planning roles dynamically:
-# - system-architect (technical feasibility)
-# - ui-designer (user experience)  
-# - security-expert (security implications)
-# - data-architect (data requirements)
-
-/workflow:session start complex "Real-time chat feature"
-/workflow:plan
-# → Generates comprehensive PRD with multi-role analysis
-# → Creates IMPLEMENTATION_PLAN.md and TASK_DECOMPOSITION.md
-```
-
-### Tech Stack Specific Development
-```bash  
-# Code developer agent loads appropriate tech guidelines
-/workflow:implement --type=medium
-# → Automatically detects JavaScript/React codebase
-# → Loads javascript-dev.md and react-dev.md guidelines  
-# → Applies language-specific best practices
-```
-
-### Advanced Session Management
-```bash
-# Complex project with interruption handling
-/workflow:session start complex "Microservices migration"
-/workflow:plan                       # Detailed planning
-/workflow:implement --type=complex   # Begin implementation
-
-# Work gets interrupted
-/workflow:session pause              # Safe state preservation
-
-# Later resume
-/workflow:session resume             # Continues from exact point
-/workflow:status                     # Shows current progress
-/task:execute IMPL-003.2             # Continue specific task
-```
-
-## 🛠️ Installation & Setup
-
-### Prerequisites
-- **Claude Code CLI** environment
-- **Bash/PowerShell** for script execution  
-- **Git** for version control
-- **Gemini CLI** (optional, for enhanced analysis)
-
-### Installation
-```bash
-# Clone the repository
 git clone https://github.com/catlog22/Claude-CCW.git
 cd Claude-CCW
-
-# Copy to Claude Code directory
-cp -r .claude ~/.claude/
-cp CLAUDE.md ~/.claude/
-
-# Make scripts executable
-chmod +x ~/.claude/scripts/*.sh
 ```
 
-### Quick Start
-```bash
-# Start with a simple task
-/workflow:session start simple "Fix responsive layout bug"
-/workflow:implement --type=simple
+2. Run the local installer:
+```powershell
+# Windows PowerShell
+.\Install-Claude.ps1
 
-# Or try a medium complexity task
-/workflow:session start medium "Add user notification system"  
-/workflow:plan
-/workflow:implement --type=medium
+# With parameters
+.\Install-Claude.ps1 -InstallMode Global -Force
+```
+
+3. Or manually set up the environment:
+```bash
+# Copy to your Claude Code configuration directory
+cp -r .claude ~/.claude/
+# Or on Windows
+xcopy .claude %USERPROFILE%\.claude /E /I
+```
+
+4. Verify installation:
+```bash
+/workflow:session list
+```
+
+### Installation Options
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `-Global` | Install system-wide | `-Global` |
+| `-Directory` | Custom installation path | `-Directory "C:\CCW"` |
+| `-Force` | Overwrite existing installation | `-Force` |
+| `-NoBackup` | Skip backup of existing files | `-NoBackup` |
+| `-NonInteractive` | Silent installation | `-NonInteractive` |
+| `-Branch` | Install from specific branch | `-Branch "develop"` |
+
+## 📖 Usage Guide
+
+### Starting a Complex Workflow
+
+1. **Initialize Session**:
+```bash
+/workflow:session start complex "Implement OAuth2 user authentication system"
+```
+
+2. **Conceptual Planning** (Optional but recommended):
+```bash
+/brainstorm "Design OAuth2 authentication system architecture" --perspectives=system-architect,security-expert,data-architect
+```
+
+3. **Create Action Plan**:
+```bash
+/workflow:action-plan --from-brainstorming
+```
+
+4. **Task Creation & Breakdown**:
+```bash
+/task:create "Backend API development"
+/task:breakdown IMPL-1
+```
+
+5. **Execute Tasks**:
+```bash
+/task:execute IMPL-1.1
+```
+
+6. **Handle Changes**:
+```bash
+/workflow:issue create --type=bug "JWT token refresh logic vulnerability"
+/workflow:issue integrate ISS-001 --position=immediate
+```
+
+7. **Monitor Progress**:
+```bash
+/workflow:context --detailed
+/task:context IMPL-1.2
+```
+
+8. **Review & Complete**:
+```bash
 /workflow:review
 ```
 
-## 📊 System Capabilities
+## 🎯 Key Commands
 
-### Planning & Analysis
-- **Multi-Role Brainstorming**: 10 specialized planning perspectives
-- **PRD Generation**: Comprehensive requirement documentation
-- **Risk Assessment**: Automated risk identification and mitigation
-- **Dependency Analysis**: Smart module relationship detection
+| Command | Purpose |
+|---------|---------|
+| `/workflow:session` | Manage workflow sessions |
+| `/brainstorm` | Multi-perspective conceptual planning |
+| `/workflow:action-plan` | Convert concepts to implementation plans |
+| `/task:breakdown` | Decompose tasks into executable units |
+| `/task:execute` | Execute specific tasks |
+| `/workflow:issue` | Manage issues and changes |
+| `/gemini-execute` | Enhanced Gemini CLI integration |
+| `/update_dms` | Maintain distributed memory system |
 
-### Development & Implementation  
-- **Tech Stack Awareness**: 6 language-specific development guidelines
-- **Test-Driven Development**: Automated test generation and execution
-- **Code Quality Enforcement**: Real-time quality validation
-- **Pattern Recognition**: Existing codebase pattern analysis
+## 🔧 Technical Highlights
 
-### Project Management
-- **Session Persistence**: Complete workflow state management
-- **Progress Tracking**: Real-time TodoWrite integration
-- **Task Decomposition**: Hierarchical task breakdown
-- **Status Monitoring**: Unified progress dashboard
+- **Intelligent Context Processing**: Dynamic context construction with technology stack detection
+- **Template-Driven Architecture**: Highly customizable and extensible through templates
+- **Quality Assurance Integration**: Built-in code review and testing strategy phases
+- **Distributed Memory System (DMS)**: Maintains project-level shared memory through CLAUDE.md files
+- **CLI-First Design**: Powerful, orthogonal command-line interface for automation
 
-### Quality Assurance
-- **Multi-Phase Review**: Planning → Implementation → Review validation
-- **Security Analysis**: Automated security assessment
-- **Performance Monitoring**: Performance impact analysis
-- **Documentation Updates**: Automatic documentation synchronization
+## 🎨 Design Philosophy
 
-## 🔧 Advanced Configuration
+- **Structure over Freeform**: Guided workflows prevent chaos and oversights
+- **Traceability & Auditing**: Complete audit trail for all decisions and changes
+- **Automation with Human Oversight**: High automation with human confirmation at key decision points
+- **Separation of Concerns**: Clean architecture with distinct responsibilities
+- **Extensibility**: Easy to extend with new agents, commands, and templates
 
-### Template Customization
-Add custom planning roles or tech stack guidelines by:
-1. Creating new `.md` files with YAML frontmatter
-2. Following the template structure pattern
-3. Templates auto-discovered by script loaders
+## 📚 Documentation
 
-### Session Configuration
-Modify session behavior in:
-- `.claude/workflows/session-management-principles.md`
-- `.claude/schemas/workflow-session.json`
-
-### Agent Coordination
-Customize agent workflows in:
-- `.claude/workflows/agent-orchestration-patterns.md`
-- Individual agent configuration files
-
-## 📈 Performance & Scalability
-
-- **JSON-Based State**: Efficient session persistence
-- **Modular Architecture**: Independent component operation
-- **Dynamic Loading**: On-demand template activation  
-- **Scalable Task Management**: Handles simple to enterprise-level complexity
-- **Memory Efficient**: Smart context management with Gemini integration
+- **Workflow Guidelines**: See `workflows/` directory for detailed process documentation
+- **Agent Definitions**: Check `agents/` for AI agent specifications
+- **Template Library**: Explore `planning-templates/` and `prompt-templates/`
+- **Integration Guides**: Review Gemini CLI integration in `workflows/gemini-*.md`
 
 ## 🤝 Contributing
 
-This is an active development project. Key areas for contribution:
-- Additional planning role templates
-- New tech stack development guidelines  
-- Enhanced agent coordination patterns
-- Performance optimizations
-- Documentation improvements
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/amazing-feature`
+3. Commit your changes: `git commit -m 'Add amazing feature'`
+4. Push to the branch: `git push origin feature/amazing-feature`
+5. Open a Pull Request
 
 ## 📄 License
 
-[Specify license - typically MIT or Apache 2.0]
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🔮 Future Roadmap
+
+- Enhanced multi-language support
+- Integration with additional AI models
+- Advanced project analytics and insights
+- Real-time collaboration features
+- Extended CI/CD pipeline integration
 
 ---
 
-**Claude Code Workflow (CCW)** - Elevating Claude Code development through intelligent workflow orchestration and comprehensive project management.
\ No newline at end of file
+**Claude Code Workflow (CCW)** - Transforming software development through intelligent automation and structured workflows.
\ No newline at end of file
diff --git a/README_CN.md b/README_CN.md
index 0c9b69f3..c5e94d54 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -1,518 +1,228 @@
-# Claude Code Workflow (CCW) - 智能开发工作流系统
+# Claude Code Workflow (CCW)
 
-**中文** | [English](README.md)
-
-**创新的AI驱动开发工作流编排系统，具备渐进式复杂度管理、文档-状态分离架构和智能多智能体协调功能。**
-
-> 🚀 **Version 2.0+** - 下一代开发自动化，采用先进架构模式和智能工作流编排。
-
-## 🏗️ 系统架构
-
-Claude Code Workflow 实现了**4层智能开发架构**：
-
-### 🧠 核心创新：文档-状态分离模式
-- **Markdown 文件** → 规划、需求、任务结构、实现策略
-- **JSON 文件** → 执行状态、进度跟踪、会话元数据、动态变更
-- **自动同步引擎** → 双向协调，具备清晰的所有权规则
-
-### ⚡ 渐进式复杂度管理
-- **Level 0** (简单): <5任务，最小结构，直接执行
-- **Level 1** (中等): 5-15任务，增强规划，智能体协调
-- **Level 2** (复杂): >15任务，完整编排，迭代优化
-
-### 🤖 智能体协调编排
-- **5个专业智能体**：规划 → 开发 → 审查 → 质量 → 内存
-- **上下文保持**：原始任务上下文在智能体链中保持
-- **质量门控**：每个智能体验证输入并确保输出标准
-- **自适应工作流**：工作流深度匹配任务复杂度要求
-
-### 🔄 高级功能特性
-- **会话优先架构**：所有命令自动发现并继承活跃会话上下文
-- **嵌入式工作流逻辑**：命令包含内置文档生成功能
-- **Gemini CLI 集成**：12+专业模板实现智能上下文管理
-- **实时同步机制**：可靠的文档-状态协调和冲突解决
-
-## 🆕 最新系统演进
-
-### 文件输出系统实现
-
-系统已完全增强，具备全面的文件生成功能：
-
-**之前状态**：命令仅生成最少文件输出  
-**当前状态**：统一文件输出系统，具备：
-- 所有工作流命令生成结构化输出文件
-- 一致的`.workflow/WFS-[topic-slug]/`目录结构  
-- 交叉引用文档生成（IMPL_PLAN.md、TODO_LIST.md、reports/）
-- 会话状态与文档跟踪同步
-- 可导出状态报告和分析文件
-- 具有JSON文件生成的分层任务管理
-
-### 关键架构组件
-
-#### 1. **智能体系统** 
-- **概念规划智能体**：多角度头脑风暴，基于角色的模板
-- **行动规划智能体**：基于PRD的实现规划  
-- **代码开发者**：测试驱动开发，技术栈指南
-- **代码审查智能体**：质量保证和安全验证
-- **UI设计专家**：设计系统合规性
-- **Memory Gemini Bridge**：分布式内存管理
-
-#### 2. **动态模板加载**
-- **规划模板**：10个基于角色的多角度分析模板
-- **技术栈模板**：6个特定语言的核心开发指南
-- **基于脚本的发现**：带YAML frontmatter的`plan-executor.sh`和`tech-stack-loader.sh`
-
-#### 3. **工作流管理**
-- **会话管理**：具有JSON持久化的完整工作流生命周期
-- **双层跟踪**：工作流级别和任务级别管理
-- **中断/恢复**：带检查点系统的安全状态管理
-- **进度监控**：实时TodoWrite集成
-
-#### 4. **统一文件输出架构**
-所有工作流命令现在生成全面的结构化输出：
-
-**文档生成命令**：
-- `/workflow:context --export` - STATUS_REPORT.md、HEALTH_CHECK.md  
-- `/workflow:implement` - TODO_LIST.md（所有复杂度）、IMPLEMENTATION_LOG.md
-- `/workflow:issue create` - WORKFLOW_ISSUES.md、单个ISS-###.json文件
-- `/workflow:sync --export-report` - 带备份跟踪的SYNC_REPORT.md
-- `/brainstorm` - synthesis-analysis.md、recommendations.md、会话元数据
-
-**文件结构标准**：
-- 所有文件存储在`.workflow/WFS-[topic-slug]/`结构中
-- workflow-session.json更新文档引用
-- 带时间戳和元数据的交叉引用文档
-- `.task/`目录中带JSON文件的分层任务管理
-
-### 增强架构与集成
-- **深度Gemini CLI集成**：跨工作流统一引用模式
-- **任务驱动模块化编排**：改进的规划和执行架构
-- **规划优先原则**：强制复杂任务结构化规划（>1000行）
-- **Memory-Gemini-Bridge**：分布式内存系统自动同步
-
-### 改进的命令系统
-- **`/dmsflow version`**：实时版本检查和远程比较
-- **`/dmsflow upgrade`**：带用户确认的无缝系统升级
-- **增强工作流控制**：改进的中断/恢复机制
-- **Agent协调**：更好的TodoWrite集成和进度跟踪
-
-### 核心命令
-
-- **`/workflow <复杂度> "任务"`** - 带智能会话管理的工作流编排
-- **`/enhance-prompt "请求"`** - 将模糊请求转换为结构化需求
-- **`/update_dms [模式] [目标]`** - 配备 memory-gemini-bridge 代理的智能分布式内存系统
-- **`/dmsflow <version|upgrade>`** - 版本管理和自动升级实用工具
-- **`/gemini-chat`** - 带模板自动选择和会话持久化的Gemini CLI交互
-- **`/gemini-execute`** - 智能上下文推理执行器，支持会话保存
-- **`/brainstorm`** - 多角度头脑风暴协调，具备会话状态管理
-
-### 命令参考表格
-
-#### 命令快速参考
-| 命令 | 描述 | 基础语法 | 自动触发场景 |
-|------|------|---------|-------------|
-| `/workflow` | 智能工作流编排 | `/workflow <复杂度> "任务"` | 多模块任务、架构变更 |
-| `/enhance-prompt` | 动态提示增强 | `/enhance-prompt [--gemini] "请求"` | 模糊请求、复杂需求 |
-| `/update_dms` | Memory-Gemini-Bridge 协调 | `/update_dms [模式] [目标] [选项]` | 项目文档更新 |
-| `/dmsflow` | 版本管理与升级 | `/dmsflow version\|upgrade` | 版本检查、系统升级 |
-
-#### 核心参数参考
-| 参数类型 | 选项 | 影响范围 | 触发条件 |
-|---------|-----|---------|---------|
-| **复杂度** | `simple` / `medium` / `complex` | 工作流深度、Gemini 激活 | >3模块 → complex |
-| **DMS模式** | `full` / `fast` / `deep` | 内存系统更新范围 | full → memory-gemini-bridge |
-| **分析类型** | `pattern` / `architecture` / `security` / `performance` / `feature` / `quality` / `dependencies` / `migration` / `custom` | Gemini 焦点、模板选择 | 关键词自动匹配 |
-| **执行选项** | `--auto` / `--manual` / `--gemini` / `--yolo` / `--debug` / `--interactive` | Task 工具、交互模式 | 复杂度自动判断 |
-
-#### 智能文件定位语法
-| 语法模式 | 示例 | 用途 |
-|---------|------|-----|
-| 单文件 | `@{file.js}` | 精确定位 |
-| 目录递归 | `@{src/**/*}` | 模块分析 |
-| 多扩展名 | `@{**/*.{ts,tsx}}` | 类型筛选 |
-| 多路径 | `@{src/*,lib/*,api/*}` | 跨模块分析 |
-| 模式匹配 | `@{**/*auth*,**/*login*}` | 领域特定定位 |
-
-#### 命令协作模式
-| 场景 | 命令流程 | 执行过程 |
-|-----|---------|---------|
-| **功能开发** | enhance → workflow → update_dms | 增强需求 → 执行开发 → 更新文档 |
-| **代码审查** | gemini → workflow review | 分析模式 → 审查验证 |
-| **架构重构** | gemini architecture → workflow complex | 架构分析 → 复杂执行 |
-| **快速修复** | workflow simple | 直接简单任务执行 |
-
-#### 自动升级触发器
-| 触发条件 | 阈值 | 升级行为 |
-|---------|-----|---------|
-| 模块数量 | >3个模块 | simple → medium |
-| 代码行数 | >1000行 | 触发规划阶段 |
-| 文件数量 | >10个文件 | 激活 Gemini 分析 |
-| 关键词检测 | `auth` / `payment` / `security` | 强制 complex 模式 |
-| 跨模块变更 | >5个模块影响 | 启用 Task 工具协调 |
-
-## 安装
-
-### 前置要求
-
-- **PowerShell 5.1+**（Windows）或 **PowerShell Core 6+**（Linux/macOS）
-- **Git** 用于仓库操作
-- **Gemini CLI** 用于增强功能：[安装指南](https://github.com/google-gemini/gemini-cli)
-
-### 安装
-
-#### 推荐：克隆仓库
-
-```bash
-# 克隆并全局安装（默认且唯一模式）
-git clone https://github.com/catlog22/Claude-CCW.git
-cd Claude-CCW
-.\Install-Claude.ps1
-```
-
-#### 替代：远程安装（推荐）
-
-```powershell
-# 一键远程全局安装（v2.0.0）
-iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1)
-```
-
-**注意**：从 v1.2.0 开始，仅支持全局安装（`~/.claude/`），确保所有项目的一致行为。
-
-#### 手动安装（脚本失效时）
-
-如果自动化安装无法正常工作，可手动复制文件：
-
-**全局安装：**
-```bash
-# 创建全局目录
-mkdir -p ~/.claude
-
-# 复制 .claude 目录内容
-cp -r .claude/* ~/.claude/
-
-# 复制 CLAUDE.md 到全局 .claude 目录
-cp CLAUDE.md ~/.claude/
-```
-
-**项目安装：**
-```bash
-# 复制到当前项目
-cp -r .claude ./
-cp CLAUDE.md ./
-
-# 或复制到指定项目
-cp -r .claude /path/to/your/project/
-cp CLAUDE.md /path/to/your/project/
-```
-
-**Windows（PowerShell）：**
-```powershell
-# 全局安装
-New-Item -Path "$env:USERPROFILE\.claude" -ItemType Directory -Force
-Copy-Item -Path ".claude\*" -Destination "$env:USERPROFILE\.claude\" -Recurse -Force
-Copy-Item -Path "CLAUDE.md" -Destination "$env:USERPROFILE\.claude\CLAUDE.md"
-
-# 项目安装
-Copy-Item -Path ".claude" -Destination ".\" -Recurse -Force
-Copy-Item -Path "CLAUDE.md" -Destination ".\CLAUDE.md"
-```
-
-## 快速开始
-
-1. **安装** 全局系统：
-   ```bash
-   # 最新 v2.0.0 安装
-   iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1)
-   ```
-2. **自定义** 项目的 CLAUDE.md
-3. **检查版本** 和 **升级** 系统：
-   ```bash
-   /dmsflow version   # 智能版本检查和远程比较
-   /dmsflow upgrade   # 无缝升级到最新版本
-   ```
-   
-   **v2.0 版本管理示例：**
-   ```bash
-   /dmsflow version
-   # DMSFlow 版本信息
-   # ================
-   # 版本：2.1.0
-   # 分支：feature/planning-agent-split-with-session-management  
-   # 追踪提交：951afeb (tracked)
-   # 远程提交：a1b2c3d (origin/HEAD~1)
-   # 状态：🔄 有可用更新！运行 '/dmsflow upgrade' 升级。
-   ```
-4. **开始使用** 智能工作流：
-
-```bash
-# 简单工作流示例
-/workflow simple "修复按钮样式"          # 直接：developer → review
-/workflow medium "添加用户认证"          # 计划：planning → dev → review  
-/workflow complex "实现微服务"           # 完整：planning → dev → review → iterate
-
-# 增强命令
-/enhance-prompt "改善应用性能"           # 结构化模糊请求
-/enhance-prompt --gemini "重构认证系统"  # 强制Gemini分析增强
-/gemini architecture "@src/**/* 系统分析" # 深度代码库分析
-/update_dms src/auth/                   # 智能内存更新
-```
-
-## 🚀 增强提示词系统
-
-### 智能建议机制
-`/enhance-prompt` 命令会自动分析任务复杂度并提供下一步建议：
-
-```bash
-# 基本用法
-/enhance-prompt "添加用户登录功能"
-# ✅ 增强完成！
-# 🎯 建议下一步：
-# 1. 执行：/workflow medium "实现用户登录与FormValidator模式"
-# 2. 研究：Task(general-purpose) - 仅用于研究现有模式
-# 3. 简化：/workflow simple - 如果范围比预期简单
-
-# 强制Gemini分析
-/enhance-prompt --gemini "重构身份验证"
-# ✅ 使用Gemini洞察增强完成！
-# 🎯 建议：/workflow complex "使用JWT中间件重构身份验证"
-```
-
-### 🎯 智能建议规则
-
-**建议决策矩阵**：
-| 检测到的复杂度 | 推荐工作流 | 建议原因 |
-|---------------|-----------|---------|
-| **简单任务** | `/workflow simple` | 单文件变更，直接实现 |
-| **中等任务** | `/workflow medium` | 多组件功能，需要规划 |
-| **复杂任务** | `/workflow complex` | 系统级变更，需要完整生命周期 |
-| **分析任务** | `Task(general-purpose)` | 研究任务，无需实现 |
-
-**自动Gemini触发条件**：
-- 关键词检测：`auth`、`payment`、`security`、`crypto`
-- 复杂度指标：`complex`、`critical`级别
-- 模块数量：影响 >3 个模块
-- 架构关键词：`refactor`、`migrate`、`redesign`
-
-### 💡 使用流程
-
-1. **增强请求** → `/enhance-prompt "模糊需求"`
-2. **获取建议** → 系统分析并推荐工作流
-3. **执行建议** → 选择推荐的 `/workflow` 命令
-4. **自动协调** → TodoWrite + Agent + DMS 自动管理
-
-## 工作流系统
-
-### 🎯 5阶段过程
-1. **任务规划** - TodoWrite 创建进度跟踪
-2. **上下文收集** - Gemini 收集代码库智能
-3. **实现** - Agent 执行，实时更新
-4. **质量审查** - 综合验证
-5. **内存更新** - 自动 DMS 同步
-
-### ⚡ 中断与恢复机制
-工作流支持安全中断和无缝恢复：
-
-```bash
-# 中断与恢复控制
-/workflow interrupt    # 安全中断，保存所有状态
-/workflow continue     # 从上次中断点继续执行  
-/workflow status       # 查看当前进度和状态
-```
-
-**中断特性**：
-- **检查点保存**：每个 Agent 完成后自动保存状态
-- **安全时机**：仅在 Agent 完成间隙中断，避免破坏执行
-- **完整状态**：保存 TodoWrite、Agent 输出、上下文链
-- **无缝恢复**：从最后完成的 Agent 继续，跳过已完成部分
-
-### 复杂度级别
-- **简单**：错误修复，单文件 → 直接实现
-- **中等**：新功能，多文件 → 规划 + 实现
-- **复杂**：架构更改 → 完整规划 + 迭代
+一个精密的多智能体自动化工作流框架，将复杂的软件开发任务从概念构思到实现审查转化为可管理、可追踪、AI协调的流程。
 
 ## 🏗️ 架构概览
 
-DMSFlow v2.0 实现了为智能开发自动化设计的复杂 **4层架构**：
+Claude Code Workflow (CCW) 建立在两大基础支柱之上：
 
-### 1. 命令层
-- **核心命令**：`/workflow`、`/enhance-prompt`、`/update_dms`、`/dmsflow`、`/gemini`
-- **智能路由**：自动复杂度检测和agent协调
-- **版本管理**：使用倒数第二个commit跟踪的智能升级系统
+### **文档-状态分离**
+- **文档 (*.md)**：存储人类可读的计划、策略、分析报告和总结
+- **状态 (*.json)**：管理机器可读的、动态的工作流状态和任务定义
+- 这种分离确保了健壮性、可恢复性和自动化处理能力
 
-### 2. Agent层
-- **规划Agent**：任务分解和结构化规划
-- **代码开发者**：测试驱动开发和实现
-- **代码审查Agent**：质量评估和安全验证
-- **Memory-Gemini-Bridge**：分布式内存同步
-- **UI设计专家**：设计系统合规性和UX一致性
+### **渐进式复杂度**
+CCW 根据任务复杂度智能调整其文件结构和工作流程：
+- **简单工作流**：用于单文件 Bug 修复的轻量级结构
+- **中等工作流**：增强的文档和进度可视化
+- **复杂工作流**：完整的文档套件，包含详细的实现计划和多轮迭代
 
-### 3. 工作流层
-- **Gemini集成模板**：12个专业化模板用于智能上下文管理
-- **智能文件定位**：高级模式匹配和上下文检测
-- **任务编排**：规划优先原则与自动升级
-- **中断与恢复**：安全的工作流状态管理
+## 🚀 核心功能
 
-### 4. 内存层
-- **分布式CLAUDE.md**：分层项目文档
-- **自动同步系统**：agent完成后实时内存更新
-- **智能检测**：自动核心模块识别（>5文件或>500行代码）
-- **版本跟踪**：带commit同步的自动更新文档
+### 多智能体系统
+- **概念规划智能体**：多视角头脑风暴和概念规划
+- **行动规划智能体**：将高层概念转化为可执行的实施计划
+- **代码开发智能体**：基于计划实现代码
+- **代码审查智能体**：审查代码质量和合规性
+- **记忆桥接智能体**：同步 Claude 和 Gemini 记忆，维护 CLAUDE.md 文件
 
-### 核心创新：智能版本管理
-```
-当前架构 → 前置提交跟踪 → 远程比较 → 更新检测
-```
-- **解决问题**：传统commit ID在文档更新后立即过时
-- **解决方案**：跟踪倒数第二个commit ID，与远程仓库的倒数第二个commit比较
-- **优势**：准确的版本检测、自动升级提示、可靠的更新机制
+### 工作流会话管理
+- 创建、暂停、恢复、列出和切换工作流会话
+- 自动初始化所需的文件和目录结构
+- 层次化工作流文件系统 (`.workflow/WFS-[topic-slug]/`)
 
-## 📁 项目结构
+### 智能上下文生成
+- 基于技术栈检测的动态上下文构建
+- 项目结构分析和领域关键词提取
+- 为 Gemini CLI 集成优化的文件定位
+
+### 动态变更管理
+- 问题跟踪和集成 (`/workflow:issue`)
+- 自动重新规划能力 (`/task:replan`)
+- 无缝适应需求变更
+
+## 📁 目录结构
 
 ```
-Claude-CCW/
-├── .claude/
-│   ├── agents/                    # 专业开发智能体
-│   │   ├── conceptual-planning-agent.md
-│   │   ├── action-planning-agent.md
-│   │   ├── code-developer.md
-│   │   ├── code-review-agent.md
-│   │   └── [4个更多智能体]
-│   ├── commands/                  # 带文件输出的命令实现
-│   │   ├── workflow/              # 8个核心工作流命令（全部带文件生成）
-│   │   ├── task/                  # 6个任务管理命令（JSON + 摘要文件）
-│   │   ├── docs/                  # 文档管理命令  
-│   │   └── [实用命令]
-│   ├── planning-templates/        # 10个基于角色的规划模板
-│   │   ├── system-architect.md
-│   │   ├── ui-designer.md
-│   │   └── [8个更多角色]
-│   ├── tech-stack-templates/      # 6个特定语言指南
-│   │   ├── javascript-dev.md
-│   │   ├── python-dev.md
-│   │   ├── react-dev.md
-│   │   └── [3个更多语言]
-│   ├── scripts/                   # 动态模板加载器和执行器
-│   │   ├── plan-executor.sh
-│   │   ├── tech-stack-loader.sh
-│   │   └── gemini-chat-executor.sh
-│   ├── workflows/                 # 工作流原则和标准
-│   │   ├── file-structure-standards.md
-│   │   ├── session-management-principles.md
-│   │   └── [文档系统指南]
-│   └── output-styles/             # 输出样式和协调模式
-└── CLAUDE.md                      # 核心开发指南
+.claude/
+├── agents/                 # AI 智能体定义和行为
+├── commands/              # CLI 命令实现
+├── output-styles/         # 输出格式模板
+├── planning-templates/    # 角色特定的规划方法
+├── prompt-templates/      # AI 交互模板
+├── scripts/              # 自动化脚本
+├── tech-stack-templates/ # 技术栈特定模板
+├── workflows/            # 工作流定义和指南
+└── settings.local.json   # 本地配置
 ```
 
-## 最佳实践
+## 🛠️ 安装
 
-- **渐进式进步** - 小的、可工作的更改
-- **学习现有模式** - 实施前研究
-- **使用 TodoWrite** 处理多步任务（>3个组件）
-- **信任自动化** - 让系统处理 DMS 更新
+### 快速安装（推荐）
 
-## 内存系统
+**一键远程安装：**
 
-智能 CLAUDE.md 文件管理，自动同步：
+```powershell
+# PowerShell (Windows/Linux/macOS)
+Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content
+```
 
-- **分层结构**：项目 → 模块 → 实现级别
-- **自动同步**：Agent 完成后更新
-- **智能检测**：识别核心模块（>5文件或>500行）
+**带参数安装：**
+```powershell
+# 全局安装
+Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content | ForEach-Object { iex "$_ -Global" }
 
+# 自定义目录安装
+Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content | ForEach-Object { iex "$_ -Directory 'C:\MyCustomPath'" }
+
+# 强制安装（覆盖现有文件）
+Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content | ForEach-Object { iex "$_ -Force" }
+```
+
+### 手动安装
+
+1. 克隆此仓库：
 ```bash
-/update_dms [路径]     # 快速更新（默认）
-/update_dms deep       # 综合分析
-/update_dms full       # 完全重建
+git clone https://github.com/catlog22/Claude-CCW.git
+cd Claude-CCW
 ```
 
-## 📚 文档结构
+2. 运行本地安装脚本：
+```powershell
+# Windows PowerShell
+.\Install-Claude.ps1
 
-系统使用模块化模板架构以增强可维护性：
+# 带参数
+.\Install-Claude.ps1 -InstallMode Global -Force
+```
 
-### 工作流模板
-- **[gemini-cli-guidelines.md](./.claude/workflows/gemini-cli-guidelines.md)** - 核心CLI使用模式和智能上下文原则
-- **[gemini-agent-templates.md](./.claude/workflows/gemini-agent-templates.md)** - 简化的agent工作流单命令模板
-- **[gemini-core-templates.md](./.claude/workflows/gemini-core-templates.md)** - 综合分析模板（模式、架构、安全、性能）
-- **[gemini-dms-templates.md](./.claude/workflows/gemini-dms-templates.md)** - DMS特定文档管理模板
-- **[gemini-intelligent-context.md](./.claude/workflows/gemini-intelligent-context.md)** - 智能文件定位和上下文检测算法
-
-### Agent系统
-- **[conceptual-planning-agent.md](./.claude/agents/conceptual-planning-agent.md)** - 高级策略规划和需求文档化，支持多角色头脑风暴
-- **[action-planning-agent.md](./.claude/agents/action-planning-agent.md)** - 基于PRD文档的实现规划和任务分解
-- **[code-developer.md](./.claude/agents/code-developer.md)** - 测试驱动开发和实现
-- **[code-review-agent.md](./.claude/agents/code-review-agent.md)** - 质量评估和安全验证
-
-
-### 命令参考
-- **[workflow.md](./.claude/commands/workflow.md)** - 智能工作流编排
-- **[enhance-prompt.md](./.claude/commands/enhance-prompt.md)** - 动态提示增强
-- **[gemini.md](./.claude/commands/gemini.md)** - 深度代码库分析
-- **[update_dms.md](./.claude/commands/update_dms.md)** - 分布式内存管理
-- **[dmsflow.md](./.claude/commands/dmsflow.md)** - 智能版本管理和升级系统
-
-## 自定义
-
-**设置**：编辑 `.claude/settings.local.json` 进行权限和输出样式配置
-**指南**：使用项目约定和架构决策自定义 `CLAUDE.md`
-
-## 🎯 完整示例 - OAuth2 身份验证
-
-展示完整工作流系统功能：
-
-### 步骤1：增强模糊请求
+3. 或手动设置环境：
 ```bash
-/enhance-prompt "添加 OAuth2 用户登录"
-# → 增强为结构化需求：Google 提供商、JWT 令牌、安全流程
+# 复制到您的 Claude Code 配置目录
+cp -r .claude ~/.claude/
+# 或在 Windows 上
+xcopy .claude %USERPROFILE%\.claude /E /I
 ```
 
-### 步骤2：收集上下文智能
+4. 验证安装：
 ```bash
-/gemini architecture "@src/**/* 身份验证系统结构"
-/gemini security "@**/*auth* 现有安全模式" 
-/gemini pattern "@**/*.{js,ts} OAuth 实现"
-# → 提供当前模式、安全差距、集成点
+/workflow:session list
 ```
 
-### 步骤3：执行智能工作流
+### 安装选项
+
+| 参数 | 说明 | 示例 |
+|-----------|-------------|---------|
+| `-Global` | 系统级安装 | `-Global` |
+| `-Directory` | 自定义安装路径 | `-Directory "C:\CCW"` |
+| `-Force` | 覆盖现有安装 | `-Force` |
+| `-NoBackup` | 跳过现有文件备份 | `-NoBackup` |
+| `-NonInteractive` | 静默安装 | `-NonInteractive` |
+| `-Branch` | 从特定分支安装 | `-Branch "develop"` |
+
+## 📖 使用指南
+
+### 启动复杂工作流
+
+1. **初始化会话**：
 ```bash
-/workflow "使用 Google 提供商实现 OAuth2 身份验证"
-# 自动流程：
-# • TodoWrite 跟踪8个任务
-# • Gemini 上下文集成
-# • 规划生成 IMPLEMENTATION_PLAN.md、TASK_DECOMPOSITION.md
-# • 代码开发者使用 TDD 实现
-# • 代码审查验证安全
-# • DMS 自动更新身份验证模块
+/workflow:session start complex "实现 OAuth2 用户认证系统"
 ```
 
-### 步骤4：监控进度
+2. **概念规划**（可选但推荐）：
 ```bash
-# 实时 TodoWrite 更新：
-# [✓] 分析 OAuth2 需求
-# [⏳] 实现 Google 提供商集成  
-# [ ] 添加 JWT 令牌验证
-# [ ] 创建会话中间件
+/brainstorm "设计 OAuth2 认证系统架构" --perspectives=system-architect,security-expert,data-architect
 ```
 
-### 优势
-- **单个命令** → 完整功能实现
-- **模糊需求自动增强**
-- **TodoWrite 实时进度跟踪**
-- **多阶段验证质量保证**
-- **自动 DMS 更新内存一致性**
+3. **创建行动计划**：
+```bash
+/workflow:action-plan --from-brainstorming
+```
 
-## 故障排除
+4. **任务创建与分解**：
+```bash
+/task:create "后端 API 开发"
+/task:breakdown IMPL-1
+```
 
-**命令无法识别**：确保项目中存在 `.claude` 目录
-**安装失败**：检查 PowerShell 执行策略或使用克隆方法
-**权限被拒绝**：以管理员身份运行或使用自定义安装路径
+5. **执行任务**：
+```bash
+/task:execute IMPL-1.1
+```
 
-## 支持
+6. **处理变更**：
+```bash
+/workflow:issue create --type=bug "JWT 令牌刷新逻辑漏洞"
+/workflow:issue integrate ISS-001 --position=immediate
+```
 
-- [GitHub Issues](https://github.com/catlog22/Claude-CCW/issues)
-- [文档 Wiki](https://github.com/catlog22/Claude-CCW/wiki)
-- [讨论](https://github.com/catlog22/Claude-CCW/discussions)
-- [版本发布说明](https://github.com/catlog22/Claude-CCW/releases)
+7. **监控进度**：
+```bash
+/workflow:context --detailed
+/task:context IMPL-1.2
+```
+
+8. **审查与完成**：
+```bash
+/workflow:review
+```
+
+## 🎯 关键命令
+
+| 命令 | 用途 |
+|---------|---------|
+| `/workflow:session` | 管理工作流会话 |
+| `/brainstorm` | 多视角概念规划 |
+| `/workflow:action-plan` | 将概念转化为实施计划 |
+| `/task:breakdown` | 将任务分解为可执行单元 |
+| `/task:execute` | 执行特定任务 |
+| `/workflow:issue` | 管理问题和变更 |
+| `/gemini-execute` | 增强的 Gemini CLI 集成 |
+| `/update_dms` | 维护分布式记忆系统 |
+
+## 🔧 技术亮点
+
+- **智能上下文处理**：基于技术栈检测的动态上下文构建
+- **模板驱动架构**：通过模板实现高度可定制和可扩展性
+- **质量保证集成**：内置代码审查和测试策略阶段
+- **分布式记忆系统 (DMS)**：通过 CLAUDE.md 文件维护项目级共享记忆
+- **CLI 优先设计**：强大、正交的命令行界面，便于自动化
+
+## 🎨 设计理念
+
+- **结构化优于自由发挥**：引导式工作流防止混乱和遗漏
+- **可追溯性与审计**：所有决策和变更的完整审计追踪
+- **自动化与人工监督**：在关键决策点保持人工确认的高度自动化
+- **关注点分离**：清晰的架构，职责分明
+- **可扩展性**：易于通过新的智能体、命令和模板进行扩展
+
+## 📚 文档
+
+- **工作流指南**：查看 `workflows/` 目录获取详细的流程文档
+- **智能体定义**：检查 `agents/` 了解 AI 智能体规范
+- **模板库**：探索 `planning-templates/` 和 `prompt-templates/`
+- **集成指南**：查阅 `workflows/gemini-*.md` 中的 Gemini CLI 集成
+
+## 🤝 贡献
+
+1. Fork 此仓库
+2. 创建功能分支：`git checkout -b feature/amazing-feature`
+3. 提交更改：`git commit -m 'Add amazing feature'`
+4. 推送到分支：`git push origin feature/amazing-feature`
+5. 打开 Pull Request
+
+## 📄 许可证
+
+此项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
+
+## 🔮 未来路线图
+
+- 增强多语言支持
+- 与其他 AI 模型集成
+- 高级项目分析和洞察
+- 实时协作功能
+- 扩展的 CI/CD 管道集成
 
 ---
 
-**Claude Code Workflow System** - 智能开发，Agent 协调和自动化质量治理
\ No newline at end of file
+**Claude Code Workflow (CCW)** - 通过智能自动化和结构化工作流变革软件开发。
\ No newline at end of file