mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
b65977d8dc
- 添加 Gemini/Codex/OpenCode/Qwen CLI 安装说明 - 添加 ACE Tool 配置（官方和代理方式） - 添加 CodexLens 开发状态说明 - 精简文档结构与英文版保持一致 - 更新 4 级工作流系统说明
Claude Code Workflow (CCW)
CCW is a JSON-driven multi-agent development framework with intelligent CLI orchestration. It provides 4-level workflow system from rapid execution to full brainstorming, transforming AI development into powerful orchestration.
Key Features
| Feature | Description |
|---|---|
| 4-Level Workflows | From lite-lite-lite (instant) to brainstorm (multi-role analysis) |
| Multi-CLI Orchestration | Gemini, Qwen, Codex, Claude - auto-select or manual |
| Dependency-Aware Parallelism | Agent parallel execution without worktree complexity |
| Issue Workflow | Post-development maintenance with optional worktree isolation |
| JSON-First State | .task/IMPL-*.json as single source of truth |
| Dashboard | Visual session management, CodexLens search, graph explorer |
📖 New? See Workflow Guide for the complete 4-level workflow system.
Quick Start
Install
npm install -g claude-code-workflow
ccw install -m Global
Choose Your Workflow Level
| Level | Command | Use Case |
|---|---|---|
| 1 | /workflow:lite-lite-lite |
Quick fixes, config changes |
| 2 | /workflow:lite-plan |
Clear single-module features |
| 2 | /workflow:lite-fix |
Bug diagnosis and fix |
| 2 | /workflow:multi-cli-plan |
Multi-perspective analysis |
| 3 | /workflow:plan |
Multi-module development |
| 3 | /workflow:tdd-plan |
Test-driven development |
| 4 | /workflow:brainstorm:auto-parallel |
New features, architecture design |
Example Workflows
# Level 1: Instant execution
/workflow:lite-lite-lite "Fix typo in README"
# Level 2: Lightweight planning
/workflow:lite-plan "Add JWT authentication"
/workflow:lite-fix "User upload fails with 413 error"
# Level 3: Standard planning with session
/workflow:plan "Implement payment gateway integration"
/workflow:execute
# Level 4: Multi-role brainstorming
/workflow:brainstorm:auto-parallel "Design real-time collaboration system" --count 5
/workflow:plan --session WFS-xxx
/workflow:execute
CLI Tool
ccw install # Install workflow files
ccw view # Open dashboard
ccw cli -p "..." # Execute CLI tools (Gemini/Qwen/Codex)
ccw upgrade -a # Upgrade all installations
Dashboard Features
- Session Overview - Track workflow sessions and progress
- CodexLens - FTS + Semantic + Hybrid code search
- Graph Explorer - Interactive code relationship visualization
- CLI Manager - Execution history with session resume
Documentation
| Document | Description |
|---|---|
| Workflow Guide | 4-level workflow system (recommended) |
| Getting Started | 5-minute quick start |
| Dashboard Guide | Dashboard user guide |
| FAQ | Common questions |
| Changelog | Version history |
Architecture
┌─────────────────────────────────────────────────────────────────┐
│ Main Workflow (4 Levels) │
│ Level 1: lite-lite-lite (instant, no artifacts) │
│ Level 2: lite-plan / lite-fix / multi-cli-plan (→ lite-execute)│
│ Level 3: plan / tdd-plan / test-fix-gen (session persistence) │
│ Level 4: brainstorm:auto-parallel → plan → execute │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ Issue Workflow (Supplement) │
│ discover → plan → queue → execute (worktree isolation) │
└─────────────────────────────────────────────────────────────────┘
Core Principles:
- Dependency Analysis solves parallelism - no worktree needed for main workflow
- Issue Workflow supplements main workflow for post-development maintenance
- Select workflow level based on complexity - avoid over-engineering
Contributing
- Repository: GitHub
- Issues: Report bugs or request features
- Contributing: See CONTRIBUTING.md
License
MIT License - see LICENSE