Claude Code Workflow — 编程工作流

将Claude Code核心工作流整合到QClaw，包括项目文件自动扫描、多文件编辑协作、Git操作、测试驱动修改。

<div align="center">

<!-- Animated Header --> <img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,11,20&height=180&section=header&text=Claude%20Code%20Workflow&fontSize=42&fontColor=fff&animation=twinkling&fontAlignY=32&desc=Multi-Agent%20AI%20Development%20Framework&descAlignY=52&descSize=18"/>

<!-- Badges --> <p> <a href="https://github.com/catlog22/Claude-Code-Workflow/releases"><img src="https://img.shields.io/badge/version-v7.0.0-6366F1?style=flat-square" alt="Version"/></a> <a href="https://www.npmjs.com/package/claude-code-workflow"><img src="https://img.shields.io/npm/v/claude-code-workflow?style=flat-square&color=cb3837" alt="npm"/></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-10B981?style=flat-square" alt="License"/></a> <a href="https://github.com/catlog22/Claude-Code-Workflow/stargazers"><img src="https://img.shields.io/github/stars/catlog22/Claude-Code-Workflow?style=flat-square&color=F59E0B" alt="Stars"/></a> <a href="https://github.com/catlog22/Claude-Code-Workflow/issues"><img src="https://img.shields.io/github/issues/catlog22/Claude-Code-Workflow?style=flat-square&color=EF4444" alt="Issues"/></a> </p>

[English](README.md) | [中文](README_CN.md)

<br/>

<!-- Typing Animation --> <a href="https://git.io/typing-svg"><img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=600&size=22&pause=1000&color=6366F1&center=true&vCenter=true&random=false&width=600&lines=JSON-Driven+Multi-Agent+Framework;Skill-based+Workflow+System;Semantic+CLI+Orchestration;Gemini+%7C+Codex+%7C+OpenCode+%7C+Qwen+%7C+Claude" alt="Typing SVG" /></a>

</div>

<br/>

<!-- Quick Links --> <div align="center"> <a href="#-quick-start"><img src="https://img.shields.io/badge/🚀_Quick_Start-4285F4?style=flat-square" alt="Quick Start"/></a> <a href="WORKFLOW_GUIDE.md"><img src="https://img.shields.io/badge/📖_Workflow_Guide-34A853?style=flat-square" alt="Guide"/></a> <a href="#-cli-tool-installation"><img src="https://img.shields.io/badge/🛠️_CLI_Tools-EA4335?style=flat-square" alt="CLI Tools"/></a> <a href="#-architecture"><img src="https://img.shields.io/badge/🏗️_Architecture-FBBC05?style=flat-square" alt="Architecture"/></a> </div>

<br/>

---

✨ Key Features

<div align="center"> <table> <tr> <td width="50%">

🎯 Skill-based Workflows

From lite-plan (lightweight) to brainstorm (multi-role analysis)

🔄 Multi-CLI Orchestration

Gemini, Qwen, Codex, Claude - auto-select or manual

⚡ Team Architecture v2

Role-based agents with inner loop execution

🔧 Queue Scheduler

Background queue execution service

</td> <td width="50%">

📦 Session Lifecycle

start/resume/complete/sync workflow sessions

🖥️ Terminal Dashboard

Multi-terminal grid with execution monitor

🎨 Orchestrator Editor

Template-based workflow visual editing

💬 A2UI

Agent-to-User interactive interface

</td> </tr> </table> </div>

> 📖 New? See [Workflow Guide](WORKFLOW_GUIDE.md) for complete workflow documentation.

---

🚀 Quick Start

Install CCW

npm install -g claude-code-workflow
ccw install -m Global

Codex Configuration (Required for .codex/skills/)

If you use Codex CLI with the .codex/skills/ workflow skills, add these required features to your ~/.codex/config.toml:

[features]
default_mode_request_user_input = true   # Enable request_user_input tool for interactive confirmations
multi_agent = true                       # Enable multi-agent coordination (spawn_agent, wait, etc.)
multi_agent_v2 = true                    # Enable v4 agent API (fork_context, task_name, send_message, assign_task, list_agents)
enable_fanout = true                     # Enable spawn_agents_on_csv for parallel wave execution

> These features are required for workflow skills to function properly. Without them, interactive confirmation gates (request_user_input), subagent orchestration, and CSV-driven parallel execution will not work.

Workflow Skills vs Commands

CCW uses two types of invocations:

| Type | Format | Examples |

|------|--------|----------|

| Skills | Trigger phrase (no slash) | workflow-lite-plan, brainstorm, workflow-plan |

| Commands | Slash command | /ccw, /workflow/session:start, /issue/new |

Choose Your Workflow Skill

<div align="center"> <table> <tr><th>Skill Trigger</th><th>Use Case</th></tr> <tr><td><code>workflow-lite-plan</code></td><td>Lightweight planning, single-module features (hands off to lite-execute)</td></tr> <tr><td><code>workflow-multi-cli-plan</code></td><td>Multi-CLI collaborative analysis</td></tr> <tr><td><code>workflow-plan</code></td><td>Full planning with session persistence</td></tr> <tr><td><code>workflow-tdd-plan</code></td><td>Test-driven development</td></tr> <tr><td><code>workflow-test-fix</code></td><td>Test generation and fix cycles</td></tr> <tr><td><code>brainstorm</code></td><td>Multi-role brainstorming analysis</td></tr> </table> </div>

Workflow Examples

# Skill triggers (no slash - just describe what you want)
workflow-lite-plan "Add JWT authentication"
workflow-plan "Implement payment gateway integration"
workflow-execute

# Brainstorming
brainstorm "Design real-time collaboration system"

# Slash commands for session management
/workflow/session:start
/workflow/session:resume
/workflow/session:complete

---

🛠️ CLI Tool Installation

<div align="center"> <table> <tr><th>CLI</th><th>Description</th><th>Official Docs</th></tr> <tr><td><b>Gemini</b></td><td>Google AI analysis</td><td><a href="https://github.com/google-gemini/gemini-cli">google-gemini/gemini-cli</a></td></tr> <tr><td><b>Codex</b></td><td>OpenAI autonomous coding</td><td><a href="https://github.com/openai/codex">openai/codex</a></td></tr> <tr><td><b>OpenCode</b></td><td>Open-source multi-model</td><td><a href="https://github.com/opencode-ai/opencode">opencode-ai/opencode</a></td></tr> <tr><td><b>Qwen</b></td><td>Alibaba Qwen-Code</td><td><a href="https://github.com/QwenLM">QwenLM/Qwen</a></td></tr> </table> </div>

---

🎭 Semantic CLI Invocation

<div align="center"> <img src="https://img.shields.io/badge/Just_Describe-What_You_Want-6366F1?style=flat-square"/> <img src="https://img.shields.io/badge/CCW_Handles-The_Rest-10B981?style=flat-square"/> </div>

<br/>

Users can semantically specify CLI tools in prompts - the system automatically invokes the corresponding CLI.

Basic Invocation

<div align="center">

| User Prompt | System Action |

|-------------|---------------|

| "Use Gemini to analyze the auth module" | Auto-invoke gemini CLI for analysis |

| "Let Codex review this code" | Auto-invoke codex CLI for review |

| "Ask Qwen about performance optimization" | Auto-invoke qwen CLI for consultation |

</div>

Multi-CLI Orchestration

<div align="center">

| Pattern | User Prompt Example |

|---------|---------------------|

| Collaborative | "Use Gemini and Codex to collaboratively analyze security vulnerabilities" |

| Parallel | "Have Gemini, Codex, and Qwen analyze the architecture in parallel" |

| Iterative | "Use Gemini to diagnose, then Codex to fix, iterate until resolved" |

| Pipeline | "Gemini designs the solution, Codex implements, Claude reviews" |

</div>

---

🔍 ACE Tool Configuration

ACE (Augment Context Engine) provides powerful semantic code search.

<div ali

（内容节选自官方 README）

安装

# 安装到当前项目
npx skills add claude-code-workflow

# 全局安装
npx skills add claude-code-workflow -g

来源

• 作者：dyw
• 仓库：https://github.com/catlog22/Claude-Code-Workflow
• npm 包：claude-code-workflow