catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-05 01:50:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: Transform README files with vivid storytelling and emphasize Codex --full-auto mode

Browse Source 
## Major Documentation Updates:

### README Transformation:
- **English README.md**: Rewritten as "The Neural Network for Software Development" with compelling storytelling, vivid metaphors, and emotional connection
- **Chinese README_CN.md**: Culturally adapted with engaging Chinese expressions while maintaining technical accuracy
- Added "AI Dream Team" concept, real-world scenarios, and developer transformation narratives
- Enhanced visual hierarchy with rich emojis and progressive disclosure of complex concepts

### Codex CLI Guidelines Enhancement:
- **Emphasized --full-auto as PRIMARY mode**: Added prominent golden rule section for autonomous development
- **Updated all examples**: Every code sample now leads with --full-auto approach, alternatives moved to secondary position
- **Critical guidance added**: Clear 90% usage recommendation for autonomous mode with explicit exception criteria
- **Comprehensive workflow updates**: Multi-phase development, quality assurance, and cross-project learning all prioritize autonomous execution

### Key Improvements:
- Transformed technical specifications into compelling developer stories
- Made complex architecture concepts accessible through analogies
- Added emotional resonance for both English and Chinese audiences
- Strengthened autonomous development workflow recommendations
- Enhanced developer experience focus with before/after scenarios

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
2025-09-10 23:16:58 +08:00
parent 6a7b187587
commit 2564d3180e
3 changed files with 724 additions and 611 deletions
Download Patch File Download Diff File Expand all files Collapse all files

159
.claude/workflows/codex-unified.md
View File

@@ -8,7 +8,7 @@ type: technical-guideline
- **Purpose**: An AI-powered CLI tool for automated codebase analysis, intelligent code generation, and autonomous development workflows.
- **Key Characteristic**: **No `--all-files` flag** - requires explicit `@` pattern references for file inclusion.
- **Default Mode**: `--full-auto` automation mode for autonomous task execution.
- **Default Mode**: `--full-auto` autonomous development mode (RECOMMENDED for all tasks).
- **Primary Triggers**:
- When user needs automated code generation or refactoring.
- When task requires intelligent analysis with autonomous execution.
@@ -19,34 +19,50 @@ type: technical-guideline
- Context-aware feature implementation.
- Autonomous debugging and problem-solving.
### ⭐ **CRITICAL: Default to `--full-auto` Mode**
> **🎯 Golden Rule**: Always start with `codex --full-auto "your task description"` for maximum autonomous capabilities. This is the recommended approach for 90% of development tasks.
**Why `--full-auto` Should Be Your Default:**
- **🧠 Intelligent File Discovery**: Codex automatically identifies relevant files without manual `@` patterns
- **🎯 Context-Aware Execution**: Understands project structure and dependencies autonomously
- **⚡ Streamlined Workflow**: No need to specify file patterns - just describe what you want
- **🚀 Maximum Automation**: Leverages full autonomous development capabilities
- **📚 Smart Documentation**: Automatically includes relevant CLAUDE.md files and project context
**When to Use `codex exec` Instead:**
- ✅ When you need precise control over which files are included
- ✅ When working with specific file patterns that require manual specification
- ✅ When debugging issues with file discovery in `--full-auto` mode
- ❌ **NOT as a default choice** - reserve for special circumstances
### ⚙️ Command Syntax & Arguments
- **Basic Structure**:
- **Basic Structure** (Priority Order):
```bash
codex exec "prompt with @{patterns}"
codex --full-auto "automated development task"
codex --full-auto "autonomous development task" # DEFAULT & RECOMMENDED
codex exec "prompt with @{patterns}" # For specific control needs
```
- **Key Commands**:
- `codex exec "..."` ≡ `gemini -p "..."` (non-interactive automation mode)
- `codex --full-auto "..."` (default autonomous development mode)
- `codex --cd /path "..."` (specify working directory)
- **Key Commands** (In Order of Preference):
- `codex --full-auto "..."` ⭐ **PRIMARY MODE** - Full autonomous development
- `codex exec "..."` - Controlled execution when you need specific patterns
- `codex --cd /path --full-auto "..."` - Directory-specific autonomous development
- **Template Usage**:
- **Template Usage** (Preferred Approaches):
```bash
# Direct execution (most common)
# RECOMMENDED: Full autonomous mode (let Codex handle file discovery)
codex --full-auto "Refactor authentication system using best practices"
# Alternative: Direct execution with explicit patterns
codex exec "@{src/**/*} @{CLAUDE.md} Refactor authentication system"
# With template injection
codex exec "@{src/**/*} @{CLAUDE.md} $(cat ~/.claude/workflows/cli-templates/prompts/development/feature.txt)"
# Advanced: Template injection with autonomous mode
codex --full-auto "$(cat ~/.claude/workflows/cli-templates/prompts/development/feature.txt)
# Multi-template composition
codex exec "@{src/**/*} @{CLAUDE.md} $(cat <<'EOF'
$(cat ~/.claude/workflows/cli-templates/prompts/analysis/architecture.txt)
Development Focus:
$(cat ~/.claude/workflows/cli-templates/prompts/development/component.txt)
EOF
)"
## Task: Authentication System Refactoring
- Apply modern security patterns
- Improve code organization
- Add comprehensive tests"
```
### 📂 File Pattern Rules - **CRITICAL FOR CODEX**
@@ -77,46 +93,62 @@ type: technical-guideline
### 📦 Standard Command Structures
- **Module-Specific Development (Folder Analysis Required)**
- **Module-Specific Development**
```bash
# MUST use @{folder/**/*} pattern since codex has no --all-files
# RECOMMENDED: Full autonomous mode with directory context
codex --cd src/auth --full-auto "Refactor authentication module using latest patterns"
# Alternative: Full autonomous mode with explicit task description
codex --full-auto "Refactor the authentication module in src/auth/ using latest security patterns"
# Fallback: Explicit patterns when autonomous mode needs guidance
codex exec "@{src/auth/**/*,CLAUDE.md} Refactor authentication module using latest patterns"
# Alternative: use --cd flag to navigate + include folder
codex --cd src/auth exec "@{**/*,../../CLAUDE.md} Implement JWT refresh token functionality"
# Template-enhanced development (see shared-template-system.md for all available templates)
codex exec "@{backend/services/**/*,package.json,CLAUDE.md} $(cat ~/.claude/workflows/cli-templates/prompts/development/refactor.txt)"
```
- **Basic Development Task**
```bash
# RECOMMENDED: Let Codex handle everything autonomously
codex --full-auto "Implement user authentication with JWT tokens"
# Alternative: Explicit file patterns if needed
codex exec "@{src/**/*,*.json,CLAUDE.md} Implement user authentication with JWT"
```
- **Template-Enhanced Development**
```bash
codex exec "@{src/**/*,CLAUDE.md} $(cat ~/.claude/workflows/cli-templates/prompts/development/feature.txt)
# RECOMMENDED: Autonomous mode with template guidance
codex --full-auto "$(cat ~/.claude/workflows/cli-templates/prompts/development/feature.txt)
## Task: User Authentication System
- JWT token management
- Role-based access control
- Password reset functionality"
# Alternative: Explicit patterns with templates
codex exec "@{src/**/*,CLAUDE.md} $(cat ~/.claude/workflows/cli-templates/prompts/development/feature.txt)"
```
- **Full Auto Mode (Default)**
- **Full Auto Mode (PRIMARY RECOMMENDATION)**
```bash
# OPTIMAL: Let Codex discover files and handle everything
codex --full-auto "Create a complete todo application with React and TypeScript"
# Alternative: Explicit patterns if you want to control file scope
codex --full-auto "@{**/*} Create a complete todo application with React and TypeScript"
```
- **Debugging & Analysis**
```bash
codex exec "@{src/**/*,package.json,CLAUDE.md} $(cat ~/.claude/workflows/cli-templates/prompts/development/debugging.txt)
# RECOMMENDED: Autonomous debugging mode
codex --full-auto "$(cat ~/.claude/workflows/cli-templates/prompts/development/debugging.txt)
## Issue: Performance degradation in user dashboard
- Identify bottlenecks
- Propose optimizations
- Implement solutions"
- Identify bottlenecks in the codebase
- Propose and implement optimizations
- Add performance monitoring"
# Alternative: Explicit patterns for controlled analysis
codex exec "@{src/**/*,package.json,CLAUDE.md} $(cat ~/.claude/workflows/cli-templates/prompts/development/debugging.txt)"
```
### ⭐ Best Practices & Rules
@@ -129,10 +161,11 @@ type: technical-guideline
- **Be comprehensive**: Use `@{**/*}` for full codebase context when needed
- **Be selective**: Use specific patterns like `@{src/**/*.ts}` for targeted analysis
**Default Automation Mode:**
- **`--full-auto` is preferred**: Maximizes autonomous capabilities
- **`codex exec` for specific tasks**: Use when you need precise control
- **Let codex decide**: Trust the AI's architectural decisions in auto mode
**Default Automation Mode (CRITICAL GUIDANCE):**
- **`--full-auto` is the PRIMARY choice**: Use for 90% of all tasks - maximizes autonomous capabilities
- **`codex exec` only when necessary**: Reserve for cases where you need explicit file pattern control
- **Trust the autonomous intelligence**: Codex excels at file discovery, context gathering, and architectural decisions
- **Start with `--full-auto` always**: If it doesn't meet needs, then consider `exec` mode
#### 📋 CLAUDE.md Loading Rules
@@ -179,45 +212,65 @@ type: technical-guideline
**Pre-Development Analysis:**
```bash
# Understand existing patterns before implementing
# RECOMMENDED: Autonomous pattern analysis
codex --full-auto "$(cat ~/.claude/workflows/cli-templates/prompts/analysis/pattern.txt)
Analyze the existing codebase patterns and conventions before implementing new features."
# Alternative: Explicit patterns if needed
codex exec "@{src/**/*,CLAUDE.md} $(cat ~/.claude/workflows/cli-templates/prompts/analysis/pattern.txt)"
```
**Feature Development:**
```bash
# Implement new feature with full context
codex exec "@{**/*,CLAUDE.md} $(cat ~/.claude/workflows/cli-templates/prompts/development/feature.txt)
# RECOMMENDED: Full autonomous feature development
codex --full-auto "$(cat ~/.claude/workflows/cli-templates/prompts/development/feature.txt)
## Feature: Advanced Search Functionality
- Full-text search capabilities
- Filter and sort options
- Performance optimization"
- Performance optimization
- Integration with existing UI components"
# Alternative: Explicit patterns when needed
codex exec "@{**/*,CLAUDE.md} $(cat ~/.claude/workflows/cli-templates/prompts/development/feature.txt)"
```
**Quality Assurance:**
```bash
# Comprehensive testing and validation
# RECOMMENDED: Autonomous testing and validation
codex --full-auto "$(cat ~/.claude/workflows/cli-templates/prompts/development/testing.txt)
Generate comprehensive tests and perform validation for the entire codebase."
# Alternative: Specific test scope control
codex exec "@{src/**/*,test/**/*,CLAUDE.md} $(cat ~/.claude/workflows/cli-templates/prompts/development/testing.txt)"
```
### 🎨 Advanced Usage Patterns
**Multi-Phase Development:**
**Multi-Phase Development (Full Autonomous Workflow):**
```bash
# Phase 1: Analysis
# Phase 1: Autonomous Analysis
codex --full-auto "Analyze current architecture for payment system integration"
# Phase 2: Autonomous Implementation (RECOMMENDED APPROACH)
codex --full-auto "Implement Stripe payment integration based on the analyzed architecture"
# Phase 3: Autonomous Testing
codex --full-auto "Generate comprehensive tests for the payment system implementation"
# Alternative: Explicit control when needed
codex exec "@{**/*,CLAUDE.md} Analyze current architecture for payment system integration"
# Phase 2: Implementation
codex --full-auto "@{**/*,CLAUDE.md} Implement Stripe payment integration with the analyzed architecture"
# Phase 3: Testing
codex exec "@{**/*,CLAUDE.md} Generate comprehensive tests for the payment system"
```
**Cross-Project Learning:**
```bash
# Learn from similar implementations
# RECOMMENDED: Autonomous cross-project pattern learning
codex --full-auto "Implement feature X by learning patterns from ../other-project/ and applying them to the current codebase"
# Alternative: Explicit pattern specification
codex exec "@{../other-project/src/**/*,src/**/*,CLAUDE.md} Implement feature X using patterns from other-project"
```
Remember: **Codex excels at autonomous development** - trust its intelligence while providing comprehensive context through proper `@` pattern usage.
Remember: **Codex excels at autonomous development** - `--full-auto` mode should be your default choice. Trust its intelligence for file discovery, context gathering, and implementation decisions. Use explicit `@` patterns only when you need precise control over file scope.

589
README.md
View File

@@ -1,4 +1,5 @@
# Claude Code Workflow (CCW)
# 🚀 Claude Code Workflow (CCW)
*The Neural Network for Software Development*
<div align="right">
@@ -6,318 +7,346 @@
</div>
A sophisticated multi-agent automation workflow framework that transforms complex software development tasks from conceptualization to implementation review into manageable, trackable, AI-orchestrated processes.
<div align="center">
> **🎉 v1.1 Release**: Unified CLI architecture with both Gemini (analysis) and Codex (development) integration, shared template system, comprehensive workflow documentation, and autonomous development capabilities. See [CHANGELOG.md](CHANGELOG.md) for details.
**Transform your development chaos into orchestrated brilliance**
## 🏗️ Architecture Overview
*Where AI agents collaborate, complexity becomes clarity, and your codebase evolves into living documentation*
Claude Code Workflow (CCW) is built on three foundational pillars:
</div>
### **JSON-Only Data Model**
- **Single Source of Truth**: All task states stored exclusively in `.task/impl-*.json` files
- **Dynamic Document Generation**: Markdown files generated on-demand as read-only views
- **Zero Synchronization**: Eliminates data consistency issues and sync complexity
- **Performance**: Direct JSON operations with <1ms query times
---
### **Marker File Session Management**
- **Ultra-Fast Operations**: Session switching through atomic file operations (`.workflow/.active-[session]`)
- **Self-Healing**: Automatic detection and resolution of session conflicts
- **Visual Management**: `ls .workflow/.active-*` shows current active session
- **Scalability**: Supports hundreds of concurrent sessions without performance degradation
## 🌟 What Makes CCW Revolutionary?
### **Progressive Complexity**
CCW intelligently adapts its file structure and workflow processes based on unified task-count thresholds:
- **Simple workflows** (<5 tasks): Minimal structure, single-level hierarchy
- **Medium workflows** (5-15 tasks): Enhanced structure with progress tracking
- **Complex workflows** (>15 tasks): Complete document suite with 3-level task decomposition
Imagine having a **team of expert AI developers** working alongside you 24/7. CCW isn't just another workflow tool—it's a **living, breathing development ecosystem** that thinks, learns, and adapts to your project's DNA.
## 🚀 Core Features
### 🎭 Meet Your AI Dream Team
- **🧠 Conceptual Planning Agent**: Your visionary architect who sees the big picture
- **⚡ Action Planning Agent**: The strategic executor who turns dreams into roadmaps
- **💻 Code Developer**: Your tireless coding companion who implements with precision
- **🔍 Code Review Agent**: The perfectionist who ensures quality never slips
- **📚 Memory Gemini Bridge**: Your project historian who keeps everything documented
### 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**: Intelligent CLAUDE.md documentation system with context-aware updates
### 🎯 The Magic Happens in Three Layers
### Unified CLI Integration (v1.1)
- **Gemini & Codex Unified**: Comprehensive CLI integration with both analysis (`gemini`) and development (`codex`) workflows
- **Dynamic Template Discovery**: Automatically detects and loads templates from `~/.claude/workflows/cli-templates/`
- **Intelligent Auto-Selection**: Matches user input against template keywords and descriptions
- **Template System**: Analysis, development, planning, and specialized templates
- **Streamlined Commands**: Unified documentation architecture with shared templates
#### **🗂️ JSON-Only Data Model: Your Project's Brain**
Think of it as your project's **neural memory**—every decision, every task, every plan lives in pure, lightning-fast JSON. No more out-of-sync documentation nightmares!
### 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]/`)
- ⚡ **Sub-millisecond queries**: Your project responds faster than you can think
- 🔄 **Zero synchronization issues**: Single source of truth, always
- 🎯 **Pure data architecture**: Clean, fast, reliable
### 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
#### **🎪 Marker File Session Management: Instant Context Switching**
Like having **multiple development personalities** you can switch between instantly:
### 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/ # Core system architecture (v2.0)
│ ├── system-architecture.md # 🆕 Unified architecture overview
│ ├── data-model.md # 🆕 JSON-only task management spec
│ ├── complexity-rules.md # 🆕 Unified complexity standards
│ ├── session-management-principles.md # Marker file session system
│ ├── file-structure-standards.md # Progressive structure definitions
│ └── [gemini-*.md] # Gemini CLI integration templates
└── settings.local.json # Local configuration
.workflow/ # 🆕 Session workspace (auto-generated)
├── .active-[session-name] # 🆕 Active session marker file
└── WFS-[topic-slug]/ # Individual session directories
├── workflow-session.json # Session metadata
├── .task/impl-*.json # 🆕 JSON-only task definitions
├── IMPL_PLAN.md # Generated planning document
└── .summaries/ # Generated completion summaries
```bash
ls .workflow/.active-* # See your active sessions at a glance
```
## 🚀 Quick Start
- 🏃‍♂️ **Atomic operations**: Session switching in microseconds
- 🔧 **Self-healing**: Automatic conflict resolution
- 📈 **Infinite scalability**: Hundreds of concurrent sessions, zero performance hit
### Prerequisites
Install and configure [Gemini CLI](https://github.com/google-gemini/gemini-cli) for optimal workflow integration.
#### **🧬 Progressive Complexity: Grows With Your Ambitions**
### Installation
**One-liner installation:**
CCW **reads your project's mind** and adapts its sophistication:
| Your Project | CCW's Response | What You Get |
|-------------|----------------|--------------|
| **Quick fix** (<5 tasks) | 🎯 Minimal mode | Streamlined, no-nonsense workflow |
| **Feature work** (5-15 tasks) | ⚙️ Enhanced mode | Smart tracking + automated documentation |
| **Major project** (>15 tasks) | 🏰 Full suite | Complete orchestration + multi-level planning |
---
## 🎨 The Developer Experience Revolution
### 🌊 From Chaos to Flow State
**Before CCW:**
```
😰 "Where did I leave off?"
📝 "Is my documentation current?"
🤔 "What was the architecture again?"
⏰ "I've been stuck on this for hours..."
```
**After CCW:**
```bash
/workflow:session:resume "oauth-implementation" # Instant context recovery
/context --format=hierarchy # See everything, beautifully organized
/gemini:analyze "authentication flow patterns" # AI-powered insights
/codex:exec "@{src/auth/**/*} implement JWT refresh tokens" # Autonomous execution
```
### 🎭 Your Workflow Becomes a Story
#### 🎪 **Act I: The Brainstorming Symphony**
```bash
/workflow:brainstorm "Payment gateway integration" \
--perspectives=system-architect,security-expert,data-architect
```
Watch as **multiple AI experts** collaborate in real-time, each bringing their specialized knowledge to create a comprehensive foundation.
#### 🎯 **Act II: The Strategic Phase**
```bash
/workflow:plan --from-brainstorming
```
Your brainstorming insights transform into **crystal-clear implementation roadmaps** with dependency tracking and risk analysis.
#### ⚡ **Act III: The Execution Ballet**
```bash
/task:execute IMPL-1 --mode=auto
/gemini:execute IMPL-2.1 # Analysis-focused tasks
/codex:exec "@{src/api/**/*} implement payment validation" # Development tasks
```
Watch your code **write itself** while maintaining the highest quality standards.
---
## 🛠️ Dual-CLI Superpowers
### 🔍 **Gemini: Your Project Detective**
*"Tell me everything about this codebase"*
```bash
gemini --all-files -p "@{src/**/*} @{CLAUDE.md}
Analyze the authentication patterns and security implications"
```
**Gemini sees patterns you've never noticed**, understands architectural decisions, and provides insights that would take hours to discover manually.
### 🤖 **Codex: Your Autonomous Developer**
*"Build this feature while I grab coffee"*
```bash
codex --full-auto "@{**/*} Create a complete user dashboard with
real-time notifications and responsive design"
```
**Codex doesn't just suggest—it implements**, tests, documents, and even handles edge cases you forgot to mention.
---
## 🏗️ Architecture That Scales With Your Dreams
### 🌳 Living Documentation System
Forget static README files. CCW creates a **living, breathing documentation ecosystem**:
```
📁 Your Project/
├── CLAUDE.md # 🌍 Project Universe View
├── src/
│ ├── CLAUDE.md # 🏢 Domain Architecture
│ ├── components/
│ │ ├── CLAUDE.md # 🧩 Component Patterns
│ │ └── auth/
│ │ └── CLAUDE.md # 🔐 Implementation Details
```
**Each layer knows exactly what it should contain**—no more, no less. Your documentation **updates itself** as your code evolves.
### 🧠 Intelligence That Never Sleeps
#### 🎯 **Context-Aware Updates**
```bash
/update-memory-related # "What changed? Let me update the docs intelligently"
```
CCW uses **git-aware change detection** to update only what matters, keeping your documentation **fresh and relevant**.
#### 🌊 **Full Project Synchronization**
```bash
/update-memory-full # "Let me refresh everything from scratch"
```
Perfect for onboarding new team members or after major architectural changes.
---
## ⚡ Quick Start: From Zero to Hero
### 🚀 One-Line Installation
```powershell
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1" -UseBasicParsing).Content
```
**Verify installation:**
```bash
/workflow:session list
```
### Essential Configuration
For Gemini CLI integration, configure your `settings.json` file:
### 🎯 Essential Setup
Configure Gemini CLI integration:
```json
{
"contextFileName": "CLAUDE.md"
"contextFileName": "CLAUDE.md" // The magic connection
}
```
> **⚠️ Important**: Set `"contextFileName": "CLAUDE.md"` in your Gemini CLI `settings.json` to ensure proper integration with CCW's intelligent documentation system. This can be set in your user settings (`~/.gemini/settings.json`) or project settings (`.gemini/settings.json`).
## 📚 Complete Command Reference
### CLI Tool Guidelines
- **Gemini Commands**: For analysis, investigation, and understanding codebase patterns
- **Codex Commands**: For autonomous development, code generation, and implementation
- **Unified Templates**: Shared template system at `~/.claude/workflows/cli-templates/`
### Core Commands
| Command | Syntax | Description |
|---------|--------|-------------|
| `/enhance-prompt` | `/enhance-prompt <input>` | Enhance and structure user inputs with technical context |
| `/gemini:analyze` | `/gemini:analyze <inquiry> [--all-files] [--save-session]` | Direct codebase analysis and investigation |
| `/gemini:chat` | `/gemini:chat <inquiry> [--all-files] [--save-session]` | Simple direct interaction with Gemini CLI without templates |
| `/gemini:execute` | `/gemini:execute <task-id\|description> [--yolo] [--debug]` | Intelligent executor with automatic file context inference |
| `/gemini:mode:auto` | `/gemini:mode:auto "<description>"` | Auto-select and execute appropriate template based on user input analysis |
| `/gemini:mode:bug-index` | `/gemini:mode:bug-index <bug-description>` | Bug analysis using specialized diagnostic template |
| `/gemini:mode:plan` | `/gemini:mode:plan <planning-topic>` | Project planning using specialized architecture template |
| `/codex:exec` | `/codex:exec "@{patterns} prompt"` | 🆕 Autonomous development with explicit file pattern references |
| `/codex:mode:auto` | `/codex:mode:auto "task description"` | Full automation mode for complex development workflows |
| `/update-memory-full` | `/update-memory-full` | Complete project-wide CLAUDE.md documentation update with depth-parallel execution |
| `/update-memory-related` | `/update-memory-related` | Context-aware documentation updates for modules affected by recent changes |
### Workflow Management
| Command | Syntax | Description |
|---------|--------|-------------|
| `/workflow:session:*` | `/workflow:session:start\|pause\|resume\|list\|switch\|status "task"` | Session lifecycle management with complexity adaptation |
| `/workflow:brainstorm` | `/workflow:brainstorm <topic> [--perspectives=role1,role2]` | Multi-agent conceptual planning from different expert perspectives |
| `/workflow:plan` | `[--from-brainstorming] [--skip-brainstorming]` | Convert concepts to executable implementation plans |
| `/workflow:plan-deep` | `<topic> [--complexity=high] [--depth=3]` | Deep architectural planning with comprehensive analysis |
| `/workflow:execute` | `[--type=simple\|medium\|complex] [--auto-create-tasks]` | Enter implementation phase with complexity-based organization |
| `/workflow:review` | `[--auto-fix]` | Final quality assurance with automated testing and validation |
| `/workflow:issue:*` | `create\|list\|update\|close [options]` | 🆕 Dynamic issue and change request management |
| `/context` | `[task-id\|--filter] [--analyze] [--format=tree\|list\|json]` | Unified task and workflow context with automatic data consistency |
### Task Execution
| Command | Syntax | Description |
|---------|--------|-------------|
| `/task:create` | `"<title>" [--type=type] [--priority=level]` | Create hierarchical implementation tasks with auto-generated IDs |
| `/task:breakdown` | `<task-id> [--strategy=auto\|interactive] [--depth=1-3]` | Intelligent task decomposition into manageable sub-tasks |
| `/task:execute` | `<task-id> [--mode=auto\|guided] [--agent=type]` | Execute tasks with automatic agent selection |
| `/task:replan` | `[task-id\|--all] [--reason] [--strategy=adjust\|rebuild]` | Dynamic task re-planning for changing requirements |
## 🎯 Usage Workflows
### Complex Feature Development
### 🎪 Your First Workflow
```bash
# 1. Start sophisticated workflow with full documentation
/workflow:session:start "Implement OAuth2 authentication system"
# 1. 🎭 Start with vision
/workflow:session:start "Build an AI-powered todo app"
# 2. Multi-perspective brainstorming
/workflow:brainstorm "OAuth2 architecture design" --perspectives=system-architect,security-expert,data-architect
# 2. 🧠 Gather perspectives
/workflow:brainstorm "Todo app architecture" \
--perspectives=ui-designer,system-architect,data-architect
# 3. Create detailed implementation plan
# 3. 📋 Create the master plan
/workflow:plan --from-brainstorming
# 4. Break down into manageable tasks
/task:create "Backend API development"
/task:breakdown IMPL-1 --strategy=auto
# 4. ⚡ Execute with precision
/workflow:execute --type=complex --auto-create-tasks
# 5. Execute with intelligent automation
/gemini:execute IMPL-1.1
/gemini:execute IMPL-1.2
# 6. Handle dynamic changes and issues
/workflow:issue:create "Add social login support"
/workflow:issue:list
/workflow:issue:update 1 --status=in-progress
# 7. Monitor and review
# 5. 🎯 Watch the magic happen
/context --format=hierarchy
/workflow:review --auto-fix
```
### Quick Bug Fix
```bash
# 1. Lightweight session for simple tasks
/workflow:session:start "Fix login button alignment"
# 2. Direct analysis and implementation
/gemini:analyze "Analyze login button CSS issues in @{src/components/Login.js}"
# 3. Create and execute single task
/task:create "Apply CSS fix to login button"
/task:execute IMPL-1 --mode=auto
# 4. Quick review
/workflow:review
```
### Smart Template Auto-Selection (v1.0)
```bash
# 1. Automatic template selection based on keywords
/gemini:mode:auto "React component not rendering after state update"
# → Auto-selects bug-fix template
# 2. Planning template for architecture work
/gemini:mode:auto "design microservices architecture for user management"
# → Auto-selects planning template
# 3. Manual template override when needed
/gemini:mode:auto "authentication issues" --template plan.md
# 4. List available templates
/gemini:mode:auto --list-templates
```
### Intelligent Documentation Management
```bash
# 1. Daily development - context-aware updates
/update-memory-related # Context-aware updates based on recent changes
# 2. After working in specific module
cd src/api && /update-memory-related # Updates API module and parent hierarchy
# 3. Periodic full refresh
/update-memory-full # Complete project-wide documentation update
# 4. Post-refactoring documentation sync
git commit -m "Major refactoring"
/update-memory-related # Intelligently updates all affected areas with git-aware detection
# 5. Project initialization or major architectural changes
/update-memory-full # Complete baseline documentation creation
```
#### Update Mode Comparison
| Command | Trigger | Complexity Threshold | Best Use Case |
|---------|---------|---------------------|---------------|
| `/update-memory-related` | Git changes + recent files | >15 modules | Daily development, feature work |
| `/update-memory-full` | Complete project scan | >20 modules | Initial setup, major refactoring |
## 📊 Complexity-Based Strategies
| Complexity | Task Count | Hierarchy Depth | File Structure | Command Strategy |
|------------|------------|----------------|----------------|------------------|
| **Simple** | <5 tasks | 1 level (impl-N) | Minimal structure | Skip brainstorming → Direct implementation |
| **Medium** | 5-15 tasks | 2 levels (impl-N.M) | Enhanced + auto-generated TODO_LIST.md | Optional brainstorming → Action plan → Progress tracking |
| **Complex** | >15 tasks | 3 levels (impl-N.M.P) | Complete document suite | Required brainstorming → Multi-agent orchestration → Deep context analysis |
### 🚀 v1.1 Release Benefits
- **Unified CLI Architecture**: Seamless integration of analysis (`gemini`) and development (`codex`) workflows
- **Smart Automation**: Intelligent template selection with autonomous development capabilities
- **Shared Template System**: Unified template library with cross-tool compatibility
- **Enhanced Documentation**: Comprehensive workflow guides with best practices
- **Cross-Platform**: Unified path handling for Windows/Linux compatibility
- **Developer Experience**: Powerful automation with human oversight control
## 🔧 Technical Highlights
- **Dual CLI Integration**: Seamless `gemini` (analysis) and `codex` (development) workflow coordination
- **Intelligent Context Processing**: Dynamic context construction with technology stack detection
- **Template-Driven Architecture**: Highly customizable and extensible through unified shared templates
- **Quality Assurance Integration**: Built-in code review and testing strategy phases
- **Intelligent Documentation System**: 4-layer hierarchical CLAUDE.md system with:
- **Dual-mode Operations**: `related` (git-aware change detection) and `full` (complete project scan)
- **Complexity-adaptive Execution**: Auto-delegation to memory-gemini-bridge for complex projects (>15/20 modules)
- **Depth-parallel Processing**: Bottom-up execution ensuring child context availability for parent updates
- **Git Integration**: Smart change detection with fallback strategies and comprehensive status reporting
- **CLI-First Design**: Powerful, orthogonal command-line interface for automation and autonomous development
## 🎨 Design Philosophy
- **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
## 📚 Documentation
- **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
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
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)** - Transforming software development through intelligent automation and structured workflows.
## 🎭 Command Arsenal
### 🧠 **Intelligence Commands**
| Command | Superpower | Example |
|---------|------------|---------|
| `/gemini:mode:auto` | 🎯 **Smart Template Selection** | Auto-detects bug reports, feature requests, architecture questions |
| `/codex:mode:auto` | 🤖 **Autonomous Development** | Full-stack feature implementation while you focus on strategy |
| `/enhance-prompt` | 💡 **Context Amplification** | Transforms vague requests into precise technical specifications |
### 🎪 **Workflow Orchestration**
| Command | Magic | Result |
|---------|-------|---------|
| `/workflow:brainstorm` | 🎭 **Multi-Expert Collaboration** | 5 AI specialists collaborate on your challenge |
| `/workflow:plan-deep` | 🏗️ **Architectural Mastery** | 3-level deep planning with dependency mapping |
| `/workflow:execute` | ⚡ **Intelligent Automation** | Complexity-aware task orchestration |
### 🔧 **Task Mastery**
| Command | Power | Impact |
|---------|-------|---------|
| `/task:breakdown` | 🧩 **Smart Decomposition** | Complex tasks → manageable chunks |
| `/task:replan` | 🔄 **Adaptive Intelligence** | Requirements changed? No problem. |
| `/context` | 🎯 **Omniscient Awareness** | See everything, understand everything |
---
## 🌟 Real-World Scenarios
### 🚀 **Scenario: Building a SaaS Platform**
```bash
# Day 1: Vision
/workflow:session:start "Multi-tenant SaaS platform with real-time collaboration"
/workflow:brainstorm "SaaS architecture design" --perspectives=business-analyst,system-architect,security-expert
# Day 2: Foundation
/workflow:plan-deep --complexity=high --depth=3
/task:create "Authentication & Authorization System"
/task:create "Multi-tenant Database Architecture"
/task:create "Real-time Communication Layer"
# Week 1-4: Implementation
/codex:mode:auto "Implement JWT-based authentication with role management"
/codex:mode:auto "Create tenant isolation middleware"
/codex:mode:auto "Build WebSocket-based collaboration features"
# Ongoing: Maintenance
/update-memory-related # After each feature
/workflow:issue:create "Add OAuth2 integration"
/workflow:review --auto-fix
```
### 🐛 **Scenario: Emergency Bug Fix**
```bash
# The Crisis
/workflow:session:start "Critical payment processing bug in production"
# The Investigation
/gemini:analyze "Payment flow failures in @{src/payments/**/*} - analyze error patterns"
# The Solution
/codex:exec "@{src/payments/**/*} Fix payment validation race condition"
# The Recovery
/workflow:review --auto-fix
/update-memory-related
```
### 🔒 **Scenario: Security Audit**
```bash
# The Audit
/workflow:brainstorm "Security vulnerability assessment" --perspectives=security-expert,penetration-tester
# The Analysis
/gemini:mode:auto "Comprehensive security analysis of authentication system"
# The Remediation
/codex:mode:auto "Implement security fixes for identified vulnerabilities"
# The Documentation
/update-memory-full # Complete security documentation update
```
---
## 🎯 Why Developers Are Obsessed
### 🧠 **Cognitive Superpowers**
- **🔮 Perfect Memory**: Never lose context again
- **⚡ Instant Expertise**: AI specialists at your fingertips
- **🎯 Laser Focus**: Complex projects become manageable steps
- **📚 Living Knowledge**: Documentation that grows with your code
### 💪 **Productivity Amplification**
- **10x Faster Planning**: Multi-agent brainstorming in minutes
- **5x Better Code Quality**: Built-in review and testing integration
- **Zero Documentation Debt**: Self-updating project knowledge
- **Infinite Scalability**: Handle projects of any complexity
### 🎨 **Developer Joy**
- **Flow State Preservation**: Never lose your train of thought
- **Complexity Mastery**: Big problems become small wins
- **Autonomous Assistance**: AI that actually helps, doesn't hinder
- **Professional Growth**: Learn from AI experts in real-time
---
## 🚀 The Future is Now
CCW represents the **evolution of software development**—from manual, error-prone processes to **intelligent, adaptive workflows** that scale with your ambitions.
### 🌟 **What's Next?**
- 🤝 **Enhanced Multi-AI Collaboration**: Even more specialized agents
- 🌍 **Real-time Team Synchronization**: Distributed teams, unified flow
- 📊 **Predictive Project Analytics**: AI that predicts and prevents issues
- 🔧 **Custom Agent Training**: Teach CCW your unique patterns
---
## 🤝 Join the Revolution
```bash
# Fork the future
git clone https://github.com/catlog22/Claude-Code-Workflow.git
cd Claude-Code-Workflow
# Make it yours
git checkout -b feature/my-amazing-contribution
# Share the magic
git push origin feature/my-amazing-contribution
```
---
<div align="center">
**🎭 Claude Code Workflow (CCW)**
*Where software development becomes an art form*
**Transform • Orchestrate • Elevate**
---
*Licensed under MIT • Built with ❤️ by the community • Powered by AI*
[⭐ Star us on GitHub](https://github.com/catlog22/Claude-Code-Workflow) • [📖 Full Documentation](https://github.com/catlog22/Claude-Code-Workflow/wiki) • [💬 Join Our Community](https://github.com/catlog22/Claude-Code-Workflow/discussions)
</div>

587
README_CN.md
View File

@@ -1,4 +1,5 @@
# Claude Code Workflow (CCW)
# 🚀 Claude Code Workflow (CCW)
*软件开发的神经网络*
<div align="right">
@@ -6,316 +7,346 @@
</div>
一个精密的多智能体自动化工作流框架，将复杂的软件开发任务从概念构思到实现审查转化为可管理、可追踪、AI协调的流程。
<div align="center">
> **🎉 v1.1 版本发布**：统一的 CLI 架构，集成 Gemini（分析）和 Codex（开发），共享模板系统，全面的工作流文档和自主开发能力。详见 [CHANGELOG.md](CHANGELOG.md)。
**将你的开发混乱转化为精心编排的辉煌**
## 🏗️ 架构概览
*在这里，AI智能体协作共事，复杂性变为清晰，你的代码库进化为活文档*
Claude Code Workflow (CCW) 建立在三大基础支柱之上：
</div>
### **JSON纯数据模型**
- **单一数据源**：所有任务状态专门存储在 `.task/impl-*.json` 文件中
- **动态文档生成**：Markdown文件按需生成为只读视图
- **零同步开销**：消除数据一致性问题和同步复杂性
- **高性能**：直接JSON操作，查询时间<1毫秒
---
### **标记文件会话管理**
- **超高速操作**：通过原子文件操作进行会话切换（`.workflow/.active-[session]`）
- **自修复能力**：自动检测和解决会话冲突
- **可视化管理**：`ls .workflow/.active-*` 显示当前活跃会话
- **可扩展性**：支持数百个并发会话而无性能下降
## 🌟 是什么让CCW如此革命性？
### **渐进式复杂度**
CCW 根据统一的任务数量阈值智能调整其文件结构和工作流程：
- **简单工作流** (<5个任务)：最小结构，单级层次结构
- **中等工作流** (5-15个任务)：增强结构，带进度跟踪
- **复杂工作流** (>15个任务)：完整文档套件，3级任务分解
想象一下，有一个**专业AI开发团队**24/7与你并肩作战。CCW不仅仅是另一个工作流工具——它是一个**活生生的、会呼吸的开发生态系统**，能够思考、学习并适应你项目的DNA。
## 🚀 核心功能
### 🎭 认识你的AI梦之队
- **🧠 概念规划智能体**: 看得见大局的远见架构师
- **⚡ 行动规划智能体**: 将梦想转化为路线图的战略执行者
- **💻 代码开发智能体**: 精准实现的不知疲倦编程伙伴
- **🔍 代码审查智能体**: 确保质量永不下滑的完美主义者
- **📚 记忆桥接智能体**: 保持一切文档化的项目史学家
### 多智能体系统
- **概念规划智能体**：多视角头脑风暴和概念规划
- **行动规划智能体**：将高层概念转化为可执行的实施计划
- **代码开发智能体**：基于计划实现代码
- **代码审查智能体**：审查代码质量和合规性
- **记忆桥接智能体**：智能 CLAUDE.md 文档系统，提供上下文感知更新
### 🎯 魔法在三个层面发生
### 统一 CLI 集成 (v1.1)
- **Gemini & Codex 统一**：全面的 CLI 集成，支持分析（`gemini`）和开发（`codex`）工作流
- **动态模板发现**：自动检测和加载来自 `~/.claude/workflows/cli-templates/` 的模板
- **智能自动选择**：根据模板关键词和描述匹配用户输入
- **模板系统**：分析、开发、规划和专用模板
- **统一命令架构**：统一的文档架构，共享模板系统
#### **🗂️ JSON纯数据模型：你项目的大脑**
把它想象为你项目的**神经记忆**——每个决策、每个任务、每个计划都存活在纯粹、闪电般快速的JSON中。不再有不同步的文档噩梦！
### 工作流会话管理
- 创建、暂停、恢复、列出和切换工作流会话
- 自动初始化所需的文件和目录结构
- 层次化工作流文件系统 (`.workflow/WFS-[topic-slug]/`)
- ⚡ **亚毫秒查询**: 你的项目响应比你思考还快
- 🔄 **零同步问题**: 单一真相来源，永远如此
- 🎯 **纯数据架构**: 干净、快速、可靠
### 智能上下文生成
- 基于技术栈检测的动态上下文构建
- 项目结构分析和领域关键词提取
- 为 Gemini CLI 集成优化的文件定位
#### **🎪 标记文件会话管理：瞬间上下文切换**
就像拥有**多重开发人格**，你可以即刻切换：
### 动态变更管理
- 问题跟踪和集成 (`/workflow:issue`)
- 自动重新规划能力 (`/task:replan`)
- 无缝适应需求变更
## 📁 目录结构
```
.claude/
├── agents/ # AI 智能体定义和行为
├── commands/ # CLI 命令实现
├── output-styles/ # 输出格式模板
├── planning-templates/ # 角色特定的规划方法
├── prompt-templates/ # AI 交互模板
├── scripts/ # 自动化脚本
├── tech-stack-templates/ # 技术栈特定模板
├── workflows/ # 核心系统架构 (v2.0)
│ ├── system-architecture.md # 🆕 统一架构概览
│ ├── data-model.md # 🆕 JSON纯任务管理规范
│ ├── complexity-rules.md # 🆕 统一复杂度标准
│ ├── session-management-principles.md # 标记文件会话系统
│ ├── file-structure-standards.md # 渐进式结构定义
│ └── [gemini-*.md] # Gemini CLI 集成模板
└── settings.local.json # 本地配置
.workflow/ # 🆕 会话工作空间 (自动生成)
├── .active-[session-name] # 🆕 活跃会话标记文件
└── WFS-[topic-slug]/ # 个别会话目录
├── workflow-session.json # 会话元数据
├── .task/impl-*.json # 🆕 JSON纯任务定义
├── IMPL_PLAN.md # 生成的规划文档
└── .summaries/ # 生成的完成摘要
```bash
ls .workflow/.active-* # 一目了然地查看你的活跃会话
```
## 🚀 快速开始
- 🏃‍♂️ **原子操作**: 微秒级会话切换
- 🔧 **自愈能力**: 自动冲突解决
- 📈 **无限可扩展性**: 数百个并发会话，零性能影响
### 前置条件
安装并配置 [Gemini CLI](https://github.com/google-gemini/gemini-cli) 以实现最佳工作流集成。
#### **🧬 渐进式复杂度：与你的雄心共同成长**
### 安装
**一键安装：**
CCW **读懂你项目的心思**并调整其精密程度：
| 你的项目 | CCW的回应 | 你得到的 |
|-------------|----------------|--------------|
| **快速修复** (<5个任务) | 🎯 极简模式 | 简化、直接的工作流 |
| **功能开发** (5-15个任务) | ⚙️ 增强模式 | 智能跟踪 + 自动文档 |
| **主要项目** (>15个任务) | 🏰 完整套件 | 完全编排 + 多级规划 |
---
## 🎨 开发者体验革命
### 🌊 从混乱到心流状态
**使用CCW之前:**
```
😰 "我上次做到哪里了？"
📝 "我的文档是最新的吗？"
🤔 "架构又是怎样的？"
⏰ "我已经被困在这里几小时了..."
```
**使用CCW之后:**
```bash
/workflow:session:resume "oauth-implementation" # 瞬间上下文恢复
/context --format=hierarchy # 美观地看到一切
/gemini:analyze "authentication flow patterns" # AI驱动的洞察
/codex:exec "@{src/auth/**/*} implement JWT refresh tokens" # 自主执行
```
### 🎭 你的工作流成为故事
#### 🎪 **第一幕：头脑风暴交响曲**
```bash
/workflow:brainstorm "支付网关集成" \
--perspectives=system-architect,security-expert,data-architect
```
观看**多个AI专家**实时协作，每个都带来专业知识，创建一个全面的基础。
#### 🎯 **第二幕：战略阶段**
```bash
/workflow:plan --from-brainstorming
```
你的头脑风暴洞察转化为**清晰明确的实现路线图**，带有依赖跟踪和风险分析。
#### ⚡ **第三幕：执行芭蕾**
```bash
/task:execute IMPL-1 --mode=auto
/gemini:execute IMPL-2.1 # 分析导向任务
/codex:exec "@{src/api/**/*} implement payment validation" # 开发任务
```
观看你的代码**自我编写**，同时保持最高质量标准。
---
## 🛠️ 双CLI超能力
### 🔍 **Gemini：你的项目侦探**
*"告诉我这个代码库的一切"*
```bash
gemini --all-files -p "@{src/**/*} @{CLAUDE.md}
分析认证模式和安全影响"
```
**Gemini看见你从未注意到的模式**，理解架构决策，并提供需要数小时才能手工发现的洞察。
### 🤖 **Codex：你的自主开发者**
*"趁我去喝咖啡时构建这个功能"*
```bash
codex --full-auto "@{**/*} 创建一个完整的用户仪表板，
具有实时通知和响应式设计"
```
**Codex不仅仅建议——它实现**，测试、文档化，甚至处理你忘记提及的边缘情况。
---
## 🏗️ 与你梦想共同扩展的架构
### 🌳 活文档系统
忘记静态README文件。CCW创建一个**活生生的、会呼吸的文档生态系统**：
```
📁 你的项目/
├── CLAUDE.md # 🌍 项目宇宙视图
├── src/
│ ├── CLAUDE.md # 🏢 领域架构
│ ├── components/
│ │ ├── CLAUDE.md # 🧩 组件模式
│ │ └── auth/
│ │ └── CLAUDE.md # 🔐 实现细节
```
**每一层都确切知道它应该包含什么**——不多不少。你的文档随着代码的发展**自我更新**。
### 🧠 永不休眠的智能
#### 🎯 **上下文感知更新**
```bash
/update-memory-related # "什么改变了？让我智能地更新文档"
```
CCW使用**git感知变更检测**来只更新重要的内容，保持你的文档**新鲜和相关**。
#### 🌊 **完整项目同步**
```bash
/update-memory-full # "让我从头开始刷新一切"
```
完美适用于新团队成员入职或重大架构更改后。
---
## ⚡ 快速开始：从零到英雄
### 🚀 一行安装
```powershell
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1" -UseBasicParsing).Content
```
**验证安装：**
```bash
/workflow:session list
```
### 重要配置
为了实现 Gemini CLI 集成，请配置您的 `settings.json` 文件：
### 🎯 关键设置
配置Gemini CLI集成：
```json
{
"contextFileName": "CLAUDE.md"
"contextFileName": "CLAUDE.md" // 神奇的连接
}
```
> **⚠️ 重要提示**：在您的 Gemini CLI `settings.json` 中设置 `"contextFileName": "CLAUDE.md"` 以确保与 CCW 的智能文档系统正确集成。这可以在用户设置 (`~/.gemini/settings.json`) 或项目设置 (`.gemini/settings.json`) 中设置。
## 📚 完整命令参考
### CLI 工具指南
- **Gemini 命令**：用于分析、调查和理解代码库模式
- **Codex 命令**：用于自主开发、代码生成和实现
- **统一模板**：共享模板系统位于 `~/.claude/workflows/cli-templates/`
### 核心命令
| 命令 | 语法 | 描述 |
|---------|--------|-------------|
| `/enhance-prompt` | `/enhance-prompt <输入>` | 增强和构造用户输入，添加技术上下文 |
| `/gemini:chat` | `/gemini:chat <查询> [--all-files] [--save-session]` | 与 Gemini CLI 的简单直接交互，不使用模板 |
| `/gemini:analyze` | `/gemini:analyze <查询> [--all-files] [--save-session]` | 直接代码库分析和调查 |
| `/gemini:execute` | `/gemini:execute <任务ID\|描述> [--yolo] [--debug]` | 智能执行器，自动推断文件上下文 |
| `/gemini:mode:auto` | `/gemini:mode:auto "<描述>"` | 基于用户输入分析自动选择和执行合适的模板 |
| `/gemini:mode:bug-index` | `/gemini:mode:bug-index <错误描述>` | 使用专门的诊断模板进行错误分析 |
| `/gemini:mode:plan` | `/gemini:mode:plan <规划主题>` | 使用专门的架构模板进行项目规划 |
| `/codex:exec` | `/codex:exec "@{patterns} prompt"` | 🆕 带显式文件模式引用的自主开发 |
| `/codex:mode:auto` | `/codex:mode:auto "任务描述"` | 复杂开发工作流的全自动化模式 |
| `/update-memory-full` | `/update-memory-full` | 完整的项目级 CLAUDE.md 文档更新，采用深度并行执行 |
| `/update-memory-related` | `/update-memory-related` | 基于近期变更的上下文感知文档更新 |
### 工作流管理
| 命令 | 语法 | 描述 |
|---------|--------|-------------|
| `/workflow:session:*` | `/workflow:session:start\|pause\|resume\|list\|switch\|status "任务"` | 会话生命周期管理，支持复杂度自适应 |
| `/workflow:brainstorm` | `/workflow:brainstorm <主题> [--perspectives=角色1,角色2]` | 多智能体概念规划，提供不同专家视角 |
| `/workflow:plan` | `[--from-brainstorming] [--skip-brainstorming]` | 将概念转化为可执行的实施计划 |
| `/workflow:plan-deep` | `<主题> [--complexity=high] [--depth=3]` | 深度架构规划与全面分析 |
| `/workflow:execute` | `[--type=simple\|medium\|complex] [--auto-create-tasks]` | 进入实施阶段，基于复杂度组织流程 |
| `/workflow:review` | `[--auto-fix]` | 最终质量保证，自动化测试和验证 |
| `/workflow:issue` | `create\|list\|update\|integrate\|close [选项]` | 动态问题和变更请求管理 |
| `/context` | `[任务ID\|--filter] [--analyze] [--format=tree\|list\|json]` | 统一的任务和工作流上下文，自动数据一致性 |
### 任务执行
| 命令 | 语法 | 描述 |
|---------|--------|-------------|
| `/task:create` | `"<标题>" [--type=类型] [--priority=级别]` | 创建层级化实施任务，自动生成 ID |
| `/task:breakdown` | `<任务ID> [--strategy=auto\|interactive] [--depth=1-3]` | 智能任务分解为可管理的子任务 |
| `/task:execute` | `<任务ID> [--mode=auto\|guided] [--agent=类型]` | 执行任务，自动选择智能体 |
| `/task:replan` | `[任务ID\|--all] [--reason] [--strategy=adjust\|rebuild]` | 动态任务重新规划，适应需求变更 |
## 🎯 使用工作流
### 复杂功能开发
### 🎪 你的第一个工作流
```bash
# 1. 启动完整文档的复杂工作流
/workflow:session:start "实现 OAuth2 认证系统"
# 1. 🎭 从愿景开始
/workflow:session:start "构建一个AI驱动的待办事项应用"
# 2. 多视角头脑风暴
/workflow:brainstorm "OAuth2 架构设计" --perspectives=system-architect,security-expert,data-architect
# 2. 🧠 收集观点
/workflow:brainstorm "待办应用架构" \
--perspectives=ui-designer,system-architect,data-architect
# 3. 创建详细实施计划
# 3. 📋 创建主计划
/workflow:plan --from-brainstorming
# 4. 分解为可管理的任务
/task:create "后端 API 开发"
/task:breakdown IMPL-1 --strategy=auto
# 4. ⚡ 精准执行
/workflow:execute --type=complex --auto-create-tasks
# 5. 智能自动化执行
/gemini:execute IMPL-1.1
/gemini:execute IMPL-1.2
# 6. 处理动态变更和问题
/workflow:issue:create "添加社交登录支持"
/workflow:issue:list
/workflow:issue:update 1 --status=in-progress
# 7. 监控和审查
# 5. 🎯 观看魔法发生
/context --format=hierarchy
/workflow:review --auto-fix
```
### 快速Bug修复
```bash
# 1. 简单任务的轻量级会话
/workflow:session:start "修复登录按钮对齐问题"
# 2. 直接分析和实施
/gemini:analyze "分析 @{src/components/Login.js} 中登录按钮的 CSS 问题"
# 3. 创建并执行单一任务
/task:create "应用登录按钮的 CSS 修复"
/task:execute IMPL-1 --mode=auto
# 4. 快速审查
/workflow:review
```
### 高级代码分析
```bash
# 1. 安全审计
/gemini-mode security "扫描认证模块的安全漏洞"
# 2. 架构分析
/gemini-mode architecture "分析组件依赖和数据流"
# 3. 性能优化
/gemini-mode performance "识别 React 渲染的瓶颈"
# 4. 模式识别
/gemini-mode pattern "提取可重用的组件模式"
```
### 智能文档管理
```bash
# 1. 日常开发 - 上下文感知更新
/update-memory-related # 基于近期变更的上下文感知更新
# 2. 在特定模块中工作后
cd src/api && /update-memory-related # 更新 API 模块和父级层次结构
# 3. 定期完整刷新
/update-memory-full # 完整的项目级文档更新
# 4. 重构后的文档同步
git commit -m "重大重构"
/update-memory-related # 通过 git 感知检测智能更新所有受影响区域
# 5. 项目初始化或重大架构变更
/update-memory-full # 完整的基准文档创建
```
#### 更新模式比较
| 命令 | 触发器 | 复杂度阈值 | 最佳使用场景 |
|---------|---------|-----------|--------------|
| `/update-memory-related` | Git 变更 + 近期文件 | >15个模块 | 日常开发、功能开发 |
| `/update-memory-full` | 完整项目扫描 | >20个模块 | 初始设置、重大重构 |
## 📊 基于复杂度的策略
| 复杂度 | 任务数量 | 层次深度 | 文件结构 | 命令策略 |
|------------|------------|----------------|----------------|------------------|
| **简单** | <5个任务 | 1级 (impl-N) | 最小结构 | 跳过头脑风暴 → 直接实施 |
| **中等** | 5-15个任务 | 2级 (impl-N.M) | 增强 + 自动生成TODO_LIST.md | 可选头脑风暴 → 行动计划 → 进度跟踪 |
| **复杂** | >15个任务 | 3级 (impl-N.M.P) | 完整文档套件 | 必需头脑风暴 → 多智能体编排 → 深度上下文分析 |
### 🚀 v1.1 版本优势
- **统一 CLI 架构**：分析（`gemini`）和开发（`codex`）工作流的无缝集成
- **智能自动化**：具备自主开发能力的智能模板选择
- **共享模板系统**：统一的模板库，支持跨工具兼容性
- **增强文档**：包含最佳实践的全面工作流指南
- **跨平台支持**：统一的 Windows/Linux 路径处理
- **开发体验**：强大的自动化与人工监督控制
## 🔧 技术亮点
- **双 CLI 集成**：无缝的 `gemini`（分析）和 `codex`（开发）工作流协调
- **智能上下文处理**：基于技术栈检测的动态上下文构建
- **模板驱动架构**：通过统一共享模板实现高度可定制和可扩展性
- **质量保证集成**：内置代码审查和测试策略阶段
- **智能文档系统**：4层分层 CLAUDE.md 系统，具有：
- **双模式操作**：`related`（git感知变更检测）和 `full`（完整项目扫描）
- **复杂度自适应执行**：复杂项目（>15/20个模块）自动委托给 memory-gemini-bridge
- **深度并行处理**：自下而上执行，确保子上下文可用于父级更新
- **Git集成**：智能变更检测，带回退策略和综合状态报告
- **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 (CCW)** - 通过智能自动化和结构化工作流变革软件开发。
## 🎭 命令武器库
### 🧠 **智能命令**
| 命令 | 超能力 | 示例 |
|---------|------------|---------|
| `/gemini:mode:auto` | 🎯 **智能模板选择** | 自动检测错误报告、功能请求、架构问题 |
| `/codex:mode:auto` | 🤖 **自主开发** | 全栈功能实现，你专注于策略 |
| `/enhance-prompt` | 💡 **上下文放大** | 将模糊请求转化为精确技术规范 |
### 🎪 **工作流编排**
| 命令 | 魔法 | 结果 |
|---------|-------|---------|
| `/workflow:brainstorm` | 🎭 **多专家协作** | 5个AI专家在你的挑战上协作 |
| `/workflow:plan-deep` | 🏗️ **架构精通** | 3级深度规划与依赖映射 |
| `/workflow:execute` | ⚡ **智能自动化** | 复杂度感知任务编排 |
### 🔧 **任务掌控**
| 命令 | 力量 | 影响 |
|---------|-------|---------|
| `/task:breakdown` | 🧩 **智能分解** | 复杂任务 → 可管理块 |
| `/task:replan` | 🔄 **适应性智能** | 需求改变？没问题。 |
| `/context` | 🎯 **全知觉察** | 看见一切，理解一切 |
---
## 🌟 真实世界场景
### 🚀 **场景：构建SaaS平台**
```bash
# 第1天：愿景
/workflow:session:start "具有实时协作的多租户SaaS平台"
/workflow:brainstorm "SaaS架构设计" --perspectives=business-analyst,system-architect,security-expert
# 第2天：基础
/workflow:plan-deep --complexity=high --depth=3
/task:create "认证与授权系统"
/task:create "多租户数据库架构"
/task:create "实时通信层"
# 第1-4周：实现
/codex:mode:auto "实现基于JWT的身份验证与角色管理"
/codex:mode:auto "创建租户隔离中间件"
/codex:mode:auto "构建基于WebSocket的协作功能"
# 持续：维护
/update-memory-related # 每个功能后
/workflow:issue:create "添加OAuth2集成"
/workflow:review --auto-fix
```
### 🐛 **场景：紧急Bug修复**
```bash
# 危机
/workflow:session:start "生产环境中的关键支付处理错误"
# 调查
/gemini:analyze "@{src/payments/**/*}中的支付流程失败 - 分析错误模式"
# 解决方案
/codex:exec "@{src/payments/**/*} 修复支付验证竞态条件"
# 恢复
/workflow:review --auto-fix
/update-memory-related
```
### 🔒 **场景：安全审计**
```bash
# 审计
/workflow:brainstorm "安全漏洞评估" --perspectives=security-expert,penetration-tester
# 分析
/gemini:mode:auto "认证系统的全面安全分析"
# 补救
/codex:mode:auto "实现已识别漏洞的安全修复"
# 文档
/update-memory-full # 完整安全文档更新
```
---
## 🎯 为什么开发者为之疯狂
### 🧠 **认知超能力**
- **🔮 完美记忆**: 再也不会丢失上下文
- **⚡ 即时专业知识**: AI专家触手可及
- **🎯 激光聚焦**: 复杂项目变成可管理的步骤
- **📚 活知识**: 与代码共同成长的文档
### 💪 **生产力放大**
- **10倍更快规划**: 分钟内多智能体头脑风暴
- **5倍更好代码质量**: 内置审查和测试集成
- **零文档债务**: 自更新的项目知识
- **无限可扩展性**: 处理任何复杂度的项目
### 🎨 **开发者之乐**
- **心流状态保持**: 永不失去思路
- **复杂度掌控**: 大问题变成小胜利
- **自主协助**: 真正帮助而非阻碍的AI
- **专业成长**: 实时向AI专家学习
---
## 🚀 未来就在现在
CCW代表了**软件开发的进化**——从手工、易错的过程转向**智能、适应性工作流**，与你的雄心共同扩展。
### 🌟 **接下来是什么？**
- 🤝 **增强多AI协作**: 更多专业化智能体
- 🌍 **实时团队同步**: 分布式团队，统一流程
- 📊 **预测项目分析**: 预测和预防问题的AI
- 🔧 **定制智能体训练**: 教CCW你的独特模式
---
## 🤝 加入革命
```bash
# Fork未来
git clone https://github.com/catlog22/Claude-Code-Workflow.git
cd Claude-Code-Workflow
# 让它成为你的
git checkout -b feature/my-amazing-contribution
# 分享魔法
git push origin feature/my-amazing-contribution
```
---
<div align="center">
**🎭 Claude Code Workflow (CCW)**
*软件开发变成艺术形式的地方*
**转化 • 编排 • 提升**
---
*MIT许可 • 由社区用❤️构建 • AI驱动*
[⭐ 在GitHub上给我们星标](https://github.com/catlog22/Claude-Code-Workflow) • [📖 完整文档](https://github.com/catlog22/Claude-Code-Workflow/wiki) • [💬 加入我们的社区](https://github.com/catlog22/Claude-Code-Workflow/discussions)
</div>