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

docs: update README and WORKFLOW_GUIDE with simplified content

Browse Source 
- Streamline README documentation
- Update workflow guide with current best practices
This commit is contained in:
catlog22
2026-02-27 22:52:28 +08:00
parent b02c8497c7
commit d319587b33
4 changed files with 644 additions and 1752 deletions
Download Patch File Download Diff File Expand all files Collapse all files

242
README.md
View File

@@ -17,7 +17,7 @@
<br/> <br/>
<!-- Typing Animation --> <!-- 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;4-Level+Workflow+System;Semantic+CLI+Orchestration;Gemini+%7C+Codex+%7C+OpenCode+%7C+Qwen+%7C+Claude" alt="Typing SVG" /></a> <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> </div>
@@ -42,8 +42,8 @@
<tr> <tr>
<td width="50%"> <td width="50%">
### 🎯 4-Level Workflows ### 🎯 Skill-based Workflows
From `lite-lite-lite` (instant) to `brainstorm` (multi-role analysis) From `lite-plan` (lightweight) to `brainstorm` (multi-role analysis)
### 🔄 Multi-CLI Orchestration ### 🔄 Multi-CLI Orchestration
Gemini, Qwen, Codex, Claude - auto-select or manual Gemini, Qwen, Codex, Claude - auto-select or manual
@@ -57,8 +57,8 @@ Background queue execution service
</td> </td>
<td width="50%"> <td width="50%">
### 📦 Workflow Session Commands ### 📦 Session Lifecycle
start/resume/complete/sync sessions start/resume/complete/sync workflow sessions
### 🖥️ Terminal Dashboard ### 🖥️ Terminal Dashboard
Multi-terminal grid with execution monitor Multi-terminal grid with execution monitor
@@ -74,7 +74,7 @@ Agent-to-User interactive interface
</table> </table>
</div> </div>
> 📖 **New?** See [Workflow Guide](WORKFLOW_GUIDE.md) for the complete 4-level workflow system. > 📖 **New?** See [Workflow Guide](WORKFLOW_GUIDE.md) for complete workflow documentation.
--- ---
@@ -87,37 +87,44 @@ npm install -g claude-code-workflow
ccw install -m Global ccw install -m Global
``` ```
> **Troubleshooting**: If you see `NODE_MODULE_VERSION` mismatch errors for `better-sqlite3`, run `npm rebuild better-sqlite3`. See [FAQ - Troubleshooting](FAQ.md#better-sqlite3-node_module_version-mismatch) for details. ### Workflow Skills vs Commands
### Choose Your Workflow Level 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"> <div align="center">
<table> <table>
<tr><th>Level</th><th>Command</th><th>Use Case</th></tr> <tr><th>Skill Trigger</th><th>Use Case</th></tr>
<tr><td><b>2</b></td><td><code>/workflow:lite-plan</code></td><td>Quick fixes, single-module features</td></tr> <tr><td><code>workflow:lite-plan</code></td><td>Lightweight planning, single-module features</td></tr>
<tr><td><b>2</b></td><td><code>/workflow:lite-fix</code></td><td>Bug diagnosis and fix</td></tr> <tr><td><code>workflow:multi-cli-plan</code></td><td>Multi-CLI collaborative analysis</td></tr>
<tr><td><b>2</b></td><td><code>/workflow:multi-cli-plan</code></td><td>Multi-perspective analysis</td></tr> <tr><td><code>workflow:plan</code></td><td>Full planning with session persistence</td></tr>
<tr><td><b>3</b></td><td><code>/workflow:plan</code></td><td>Multi-module development</td></tr> <tr><td><code>workflow:tdd-plan</code></td><td>Test-driven development</td></tr>
<tr><td><b>3</b></td><td><code>/workflow:tdd-plan</code></td><td>Test-driven development</td></tr> <tr><td><code>workflow:test-fix-gen</code></td><td>Test generation and fix cycles</td></tr>
<tr><td><b>4</b></td><td><code>/workflow:brainstorm:auto-parallel</code></td><td>New features, architecture design</td></tr> <tr><td><code>brainstorm</code></td><td>Multi-role brainstorming analysis</td></tr>
</table> </table>
</div> </div>
### Workflow Examples ### Workflow Examples
```bash ```bash
# Level 2: Lightweight planning (recommended for most tasks) # Skill triggers (no slash - just describe what you want)
/workflow:lite-plan "Add JWT authentication" workflow:lite-plan "Add JWT authentication"
/workflow:lite-fix "User upload fails with 413 error" workflow:plan "Implement payment gateway integration"
workflow:execute
# Level 3: Standard planning with session # Brainstorming
/workflow:plan "Implement payment gateway integration" brainstorm "Design real-time collaboration system"
/workflow:execute
# Level 4: Multi-role brainstorming # Slash commands for session management
/workflow:brainstorm:auto-parallel "Design real-time collaboration system" --count 5 /workflow/session:start
/workflow:plan --session WFS-xxx /workflow/session:resume
/workflow:execute /workflow/session:complete
``` ```
--- ---
@@ -172,49 +179,6 @@ Users can **semantically specify CLI tools** in prompts - the system automatical
</div> </div>
<details>
<summary><b>📝 More Examples</b></summary>
```text
# Single CLI invocation
User: "Use Gemini to analyze the database query performance"
→ System auto-calls: gemini CLI with analysis task
# Collaborative analysis
User: "Use Gemini and Codex to collaboratively review the authentication flow"
→ System auto-calls: gemini + codex CLIs, synthesizes results
# Parallel multi-perspective
User: "Have all available CLIs analyze this architecture design in parallel"
→ System auto-calls: gemini, codex, qwen in parallel → merged report
# Sequential pipeline
User: "Use Gemini to plan the refactoring, then Codex to implement it"
→ System auto-calls: gemini (plan) → codex (implement) sequentially
```
</details>
### Custom CLI Registration
Register **any API as a custom CLI** via Dashboard interface:
```bash
ccw view # Open Dashboard → Status → API Settings → Add Custom CLI
```
<div align="center">
| Field | Example |
|-------|---------|
| **Name** | `deepseek` |
| **Endpoint** | `https://api.deepseek.com/v1/chat` |
| **API Key** | `your-api-key` |
</div>
> ⚙️ Register once, invoke semantically forever - no code changes needed.
--- ---
## 🔍 ACE Tool Configuration ## 🔍 ACE Tool Configuration
@@ -245,42 +209,24 @@ ACE (Augment Context Engine) provides powerful semantic code search.
</table> </table>
</div> </div>
<details>
<summary><b>📦 Installation</b></summary>
```bash
# Enter codex-lens directory
cd codex-lens
# Install dependencies
pip install -e .
# Initialize index
codexlens index /path/to/project
```
Open Dashboard via `ccw view`, manage indexes and execute searches in **CodexLens Manager**.
</details>
--- ---
## 💻 CCW CLI Commands ## 💻 CCW CLI Commands
### 🌟 Recommended Commands (Main Features) ### 🌟 Recommended Commands
<div align="center"> <div align="center">
<table> <table>
<tr><th>Command</th><th>Description</th><th>When to Use</th></tr> <tr><th>Command</th><th>Description</th><th>When to Use</th></tr>
<tr> <tr>
<td><b>/ccw</b></td> <td><b>/ccw</b></td>
<td>Auto workflow orchestrator - analyzes intent, selects workflow level, executes command chain in main process</td> <td>Auto workflow orchestrator - analyzes intent, selects workflow, executes</td>
<td>✅ General tasks, auto workflow selection, quick development</td> <td>✅ General tasks, auto workflow selection</td>
</tr> </tr>
<tr> <tr>
<td><b>/ccw-coordinator</b></td> <td><b>/ccw-coordinator</b></td>
<td>Smart orchestrator - intelligently recommends command chains, allows manual adjustment, executes via external CLI with state persistence</td> <td>Smart orchestrator - recommends command chains, allows manual adjustment</td>
<td>🔧 Complex multi-step workflows, customizable chains, resumable sessions</td> <td>🔧 Complex multi-step workflows</td>
</tr> </tr>
</table> </table>
</div> </div>
@@ -288,25 +234,33 @@ Open Dashboard via `ccw view`, manage indexes and execute searches in **CodexLen
**Quick Examples**: **Quick Examples**:
```bash ```bash
# /ccw - Auto workflow selection (Main Process) # /ccw - Auto workflow selection
/ccw "Add user authentication" # Auto-selects workflow based on intent /ccw "Add user authentication"
/ccw "Fix memory leak in WebSocket" # Detects bugfix workflow /ccw "Fix memory leak in WebSocket"
/ccw "Implement with TDD" # Routes to TDD workflow /ccw "Implement with TDD"
# /ccw-coordinator - Manual chain orchestration (External CLI) # /ccw-coordinator - Manual chain orchestration
/ccw-coordinator "Implement OAuth2 system" # Analyzes → Recommends chain → User confirms → Executes /ccw-coordinator "Implement OAuth2 system"
``` ```
**Key Differences**: ### Session Management Commands
| Aspect | /ccw | /ccw-coordinator | ```bash
|--------|------|------------------| /workflow:session:start # Start new workflow session
| **Execution** | Main process (SlashCommand) | External CLI (background tasks) | /workflow:session:resume # Resume paused session
| **Selection** | Auto intent-based | Smart recommendation + optional adjustment | /workflow:session:list # List all sessions
| **State** | TodoWrite tracking | Persistent state.json | /workflow:session:sync # Sync session work
| **Use Case** | General tasks, quick dev | Complex chains, resumable | /workflow:session:complete # Complete session
```
--- ### Issue Workflow Commands
```bash
/issue/new # Create new issue
/issue/plan # Plan issue resolution
/issue/queue # Form execution queue
/issue/execute # Execute issue queue
```
### Other CLI Commands ### Other CLI Commands
@@ -317,45 +271,17 @@ ccw cli -p "..." # Execute CLI tools (Gemini/Qwen/Codex)
ccw upgrade -a # Upgrade all installations ccw upgrade -a # Upgrade all installations
``` ```
### Dashboard Features
<div align="center">
<table>
<tr><th>Feature</th><th>Description</th></tr>
<tr><td><b>Session Overview</b></td><td>Track workflow sessions and progress</td></tr>
<tr><td><b>CodexLens</b></td><td>FTS + Semantic + Hybrid code search</td></tr>
<tr><td><b>Graph Explorer</b></td><td>Interactive code relationship visualization</td></tr>
<tr><td><b>CLI Manager</b></td><td>Execution history with session resume</td></tr>
</table>
</div>
---
## 📖 Documentation
<div align="center">
| Document | Description |
|----------|-------------|
| [**Workflow Guide**](WORKFLOW_GUIDE.md) | 4-level workflow system (recommended) |
| [**Getting Started**](GETTING_STARTED.md) | 5-minute quick start |
| [**Dashboard Guide**](DASHBOARD_GUIDE.md) | Dashboard user guide |
| [**FAQ**](FAQ.md) | Common questions |
| [**Changelog**](CHANGELOG.md) | Version history |
</div>
--- ---
## 🏗️ Architecture ## 🏗️ Architecture
``` ```
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ Main Workflow (4 Levels) │ │ Workflow Skills │
│ ⚡ Level 1: lite-lite-lite (instant execution) │ │ 📝 workflow:lite-plan / workflow:multi-cli-plan (lightweight) │
│ 📝 Level 2: lite-plan / lite-fix / multi-cli-plan (→ execute) │ │ 📊 workflow:plan / workflow:tdd-plan (session-based) │
│ 📊 Level 3: plan / tdd-plan / test-fix-gen (session persist) │ │ 🧪 workflow:test-fix-gen / workflow:test-cycle-execute │
│ 🧠 Level 4: brainstorm:auto-parallel → plan → execute │ │ 🧠 brainstorm (multi-role analysis) │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
↓ ↓
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
@@ -380,13 +306,6 @@ ccw upgrade -a # Upgrade all installations
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
``` ```
**Core Principles:**
- ⚡ **Dependency Analysis** solves parallelism - no worktree needed for main workflow
- 🤖 **Team Architecture v2** provides unified role-based agent execution with inner loop
- 🔧 **Queue Scheduler** handles background task execution with unified settings
- 🖥️ **Terminal Dashboard** provides real-time monitoring and control
- 🎯 Select workflow level based on complexity - avoid over-engineering
--- ---
## 📦 Project Structure ## 📦 Project Structure
@@ -396,27 +315,26 @@ Claude-Code-Workflow/
├── .claude/ ├── .claude/
│ ├── agents/ # 22 specialized agents (team-worker, cli-discuss, etc.) │ ├── agents/ # 22 specialized agents (team-worker, cli-discuss, etc.)
│ ├── commands/ # Slash commands (5 categories) │ ├── commands/ # Slash commands (5 categories)
│ │ ├── root/ # Root commands (/ccw, /ccw-coordinator) │ │ ├── ccw.md # Main orchestrator
│ │ ├── ccw-coordinator.md
│ │ ├── cli/ # CLI commands (cli-init, codex-review) │ │ ├── cli/ # CLI commands (cli-init, codex-review)
│ │ ├── issue/ # Issue management (plan, execute, queue) │ │ ├── issue/ # Issue management (plan, execute, queue)
│ │ ├── memory/ # Memory commands (prepare, style-skill-memory) │ │ ├── memory/ # Memory commands (prepare, style-skill-memory)
│ │ └── workflow/ # Workflow commands (brainstorm, plan, session) │ │ └── workflow/ # Workflow commands (session, ui-design, etc.)
│ └── skills/ # 37 modular skills │ └── skills/ # 37 modular skills
│ ├── review-code/ # Code review with rule-based analysis │ ├── workflow-lite-plan/
│ ├── skill-tuning/ # Skill diagnosis and optimization │ ├── workflow-plan/
│ ├── skill-generator/ # Skill scaffolding and generation │ ├── workflow-tdd/
│ ├── spec-generator/ # Product specification generation │ ├── workflow-test-fix/
│ ├── memory-*/ # Memory management skills │ ├── brainstorm/
│ ├── workflow-*/ # Workflow orchestration skills │ ├── team-*/ # Team coordination skills
│ ├── team-*/ # Team coordination skills
│ └── ... │ └── ...
├── ccw/ ├── ccw/
│ ├── src/ # TypeScript source code │ ├── src/ # TypeScript source code
│ │ ├── commands/ # CLI command implementations │ │ ├── commands/ # CLI command implementations
│ │ ├── core/ # Core services (a2ui, auth, hooks, routes) │ │ ├── core/ # Core services (a2ui, auth, hooks, routes)
│ │ ├── mcp-server/ # MCP server implementation │ │ ├── mcp-server/ # MCP server implementation
│ │ ├── tools/ # Tool implementations │ │ └── tools/ # Tool implementations
│ │ └── utils/ # Utility functions
│ └── frontend/ # React frontend (Terminal Dashboard, Orchestrator) │ └── frontend/ # React frontend (Terminal Dashboard, Orchestrator)
├── codex-lens/ # Local semantic code search engine ├── codex-lens/ # Local semantic code search engine
└── docs/ # Documentation └── docs/ # Documentation
@@ -445,13 +363,6 @@ Beat Cycle (single beat)
callback <-----------------------------------------+ callback <-----------------------------------------+
(next beat) SendMessage + TaskUpdate(completed) (next beat) SendMessage + TaskUpdate(completed)
====================================================================== ======================================================================
Fast-Advance (skips coordinator for simple linear successors)
======================================================================
[Worker A] Phase 5 complete
+- 1 ready task? simple successor? --> spawn team-worker B directly
+- complex case? --> SendMessage to coordinator
======================================================================
``` ```
**Key Benefits:** **Key Benefits:**
@@ -485,10 +396,6 @@ Visual workflow template editor with drag-drop.
- 🔧 Property panel for node configuration - 🔧 Property panel for node configuration
- ⚡ Slash command integration - ⚡ Slash command integration
### Analysis Viewer
Grid layout for analysis sessions with filtering and fullscreen mode.
--- ---
## 🤝 Contributing ## 🤝 Contributing
@@ -496,7 +403,6 @@ Grid layout for analysis sessions with filtering and fullscreen mode.
<div align="center"> <div align="center">
<a href="https://github.com/catlog22/Claude-Code-Workflow"><img src="https://img.shields.io/badge/GitHub-Repository-181717?style=flat-square" alt="GitHub"/></a> <a href="https://github.com/catlog22/Claude-Code-Workflow"><img src="https://img.shields.io/badge/GitHub-Repository-181717?style=flat-square" alt="GitHub"/></a>
<a href="https://github.com/catlog22/Claude-Code-Workflow/issues"><img src="https://img.shields.io/badge/Issues-Report_Bug-EF4444?style=flat-square" alt="Issues"/></a> <a href="https://github.com/catlog22/Claude-Code-Workflow/issues"><img src="https://img.shields.io/badge/Issues-Report_Bug-EF4444?style=flat-square" alt="Issues"/></a>
<a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/Contributing-Guide-10B981?style=flat-square" alt="Contributing"/></a>
</div> </div>
--- ---

242
README_CN.md
View File

@@ -17,7 +17,7 @@
<br/> <br/>
<!-- Typing Animation --> <!-- 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+驱动的多智能体框架;4+级工作流系统;语义化+CLI+编排;Gemini+%7C+Codex+%7C+OpenCode+%7C+Qwen+%7C+Claude" alt="Typing SVG" /></a> <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+驱动的多智能体框架;Skill+工作流系统;语义化+CLI+编排;Gemini+%7C+Codex+%7C+OpenCode+%7C+Qwen+%7C+Claude" alt="Typing SVG" /></a>
</div> </div>
@@ -42,8 +42,8 @@
<tr> <tr>
<td width="50%"> <td width="50%">
### 🎯 4 级工作流 ### 🎯 Skill 工作流
从 `lite-lite-lite`（即时执行）到 `brainstorm`（多角色分析） 从 `lite-plan`（轻量规划）到 `brainstorm`（多角色分析）
### 🔄 多 CLI 编排 ### 🔄 多 CLI 编排
Gemini、Qwen、Codex、Claude - 自动选择或手动指定 Gemini、Qwen、Codex、Claude - 自动选择或手动指定
@@ -57,8 +57,8 @@ Gemini、Qwen、Codex、Claude - 自动选择或手动指定
</td> </td>
<td width="50%"> <td width="50%">
### 📦 工作流会话命令 ### 📦 会话生命周期
启动/恢复/完成/同步会话 启动/恢复/完成/同步工作流会话
### 🖥️ 终端仪表板 ### 🖥️ 终端仪表板
多终端网格带执行监控器 多终端网格带执行监控器
@@ -74,7 +74,7 @@ Gemini、Qwen、Codex、Claude - 自动选择或手动指定
</table> </table>
</div> </div>
> 📖 **新用户？** 查看 [工作流指南](WORKFLOW_GUIDE_CN.md) 了解完整的 4 级工作流系统。 > 📖 **新用户？** 查看 [工作流指南](WORKFLOW_GUIDE_CN.md) 了解完整的工作流文档。
--- ---
@@ -87,35 +87,44 @@ npm install -g claude-code-workflow
ccw install -m Global ccw install -m Global
``` ```
### 选择工作流级别 ### 工作流 Skill 与命令
CCW 使用两种调用方式：
| 类型 | 格式 | 示例 |
|------|------|------|
| **Skills** | 触发短语（无斜杠） | `workflow:lite-plan`, `brainstorm`, `workflow:plan` |
| **Commands** | 斜杠命令 | `/ccw`, `/workflow/session:start`, `/issue/new` |
### 选择工作流 Skill
<div align="center"> <div align="center">
<table> <table>
<tr><th>级别</th><th>命令</th><th>使用场景</th></tr> <tr><th>Skill 触发词</th><th>使用场景</th></tr>
<tr><td><b>2</b></td><td><code>/workflow:lite-plan</code></td><td>快速修复、单模块功能</td></tr> <tr><td><code>workflow:lite-plan</code></td><td>轻量规划、单模块功能</td></tr>
<tr><td><b>2</b></td><td><code>/workflow:lite-fix</code></td><td>Bug 诊断修复</td></tr> <tr><td><code>workflow:multi-cli-plan</code></td><td>多 CLI 协同分析</td></tr>
<tr><td><b>2</b></td><td><code>/workflow:multi-cli-plan</code></td><td>多视角分析</td></tr> <tr><td><code>workflow:plan</code></td><td>完整规划与会话持久化</td></tr>
<tr><td><b>3</b></td><td><code>/workflow:plan</code></td><td>多模块开发</td></tr> <tr><td><code>workflow:tdd-plan</code></td><td>测试驱动开发</td></tr>
<tr><td><b>3</b></td><td><code>/workflow:tdd-plan</code></td><td>测试驱动开发</td></tr> <tr><td><code>workflow:test-fix-gen</code></td><td>测试生成与修复循环</td></tr>
<tr><td><b>4</b></td><td><code>/workflow:brainstorm:auto-parallel</code></td><td>新功能、架构设计</td></tr> <tr><td><code>brainstorm</code></td><td>多角色头脑风暴分析</td></tr>
</table> </table>
</div> </div>
### 工作流示例 ### 工作流示例
```bash ```bash
# Level 2: 轻量规划 (推荐用于大多数任务) # Skill 触发（无斜杠 - 直接描述你想做什么）
/workflow:lite-plan "添加 JWT 认证" workflow:lite-plan "添加 JWT 认证"
/workflow:lite-fix "用户上传失败返回 413 错误" workflow:plan "实现支付网关集成"
workflow:execute
# Level 3: 标准规划 + Session # 头脑风暴
/workflow:plan "实现支付网关集成" brainstorm "设计实时协作系统"
/workflow:execute
# Level 4: 多角色头脑风暴 # 会话管理命令
/workflow:brainstorm:auto-parallel "设计实时协作系统" --count 5 /workflow:session:start
/workflow:plan --session WFS-xxx /workflow:session:resume
/workflow:execute /workflow:session:complete
``` ```
--- ---
@@ -170,49 +179,6 @@ ccw install -m Global
</div> </div>
<details>
<summary><b>📝 更多示例</b></summary>
```text
# 单 CLI 调用
用户: "使用 Gemini 分析数据库查询性能"
→ 系统自动调用: gemini CLI 执行分析任务
# 协同分析
用户: "使用 Gemini 和 Codex 协同审查认证流程"
→ 系统自动调用: gemini + codex CLI，综合分析结果
# 并行多视角
用户: "让所有可用的 CLI 并行分析这个架构设计"
→ 系统自动调用: gemini, codex, qwen 并行执行 → 合并报告
# 顺序流水线
用户: "用 Gemini 规划重构方案，然后 Codex 实现"
→ 系统自动调用: gemini（规划）→ codex（实现）顺序执行
```
</details>
### 自定义 CLI 注册
通过 Dashboard 界面 **注册任意 API 为自定义 CLI**：
```bash
ccw view # 打开 Dashboard → Status → API Settings → 添加自定义 CLI
```
<div align="center">
| 字段 | 示例 |
|------|------|
| **名称** | `deepseek` |
| **端点** | `https://api.deepseek.com/v1/chat` |
| **API Key** | `your-api-key` |
</div>
> ⚙️ 注册一次，永久语义调用 - 无需修改代码。
--- ---
## 🔍 ACE Tool 配置 ## 🔍 ACE Tool 配置
@@ -243,42 +209,24 @@ ACE (Augment Context Engine) 提供强大的语义代码搜索能力。
</table> </table>
</div> </div>
<details>
<summary><b>📦 安装</b></summary>
```bash
# 进入 codex-lens 目录
cd codex-lens
# 安装依赖
pip install -e .
# 初始化索引
codexlens index /path/to/project
```
通过 `ccw view` 打开 Dashboard，在 **CodexLens Manager** 中管理索引和执行搜索。
</details>
--- ---
## 💻 CCW CLI 命令 ## 💻 CCW CLI 命令
### 🌟 推荐命令（核心功能） ### 🌟 推荐命令
<div align="center"> <div align="center">
<table> <table>
<tr><th>命令</th><th>说明</th><th>适用场景</th></tr> <tr><th>命令</th><th>说明</th><th>适用场景</th></tr>
<tr> <tr>
<td><b>/ccw</b></td> <td><b>/ccw</b></td>
<td>自动工作流编排器 - 分析意图、自动选择工作流级别、在主进程中执行命令链</td> <td>自动工作流编排器 - 分析意图、选择工作流、执行</td>
<td>✅ 通用任务、自动选择工作流、快速开发</td> <td>✅ 通用任务、自动选择工作流</td>
</tr> </tr>
<tr> <tr>
<td><b>/ccw-coordinator</b></td> <td><b>/ccw-coordinator</b></td>
<td>智能编排器 - 智能推荐命令链、支持手动调整、通过外部 CLI 执行、持久化状态</td> <td>智能编排器 - 推荐命令链、支持手动调整</td>
<td>🔧 复杂多步骤工作流、可自定义链、可恢复会话</td> <td>🔧 复杂多步骤工作流</td>
</tr> </tr>
</table> </table>
</div> </div>
@@ -286,25 +234,33 @@ codexlens index /path/to/project
**快速示例**： **快速示例**：
```bash ```bash
# /ccw - 自动工作流选择（主进程） # /ccw - 自动工作流选择
/ccw "添加用户认证" # 自动根据意图选择工作流 /ccw "添加用户认证"
/ccw "修复 WebSocket 中的内存泄漏" # 识别为 bugfix 工作流 /ccw "修复 WebSocket 中的内存泄漏"
/ccw "使用 TDD 方式实现" # 路由到 TDD 工作流 /ccw "使用 TDD 方式实现"
# /ccw-coordinator - 手动链编排（外部 CLI） # /ccw-coordinator - 手动链编排
/ccw-coordinator "实现 OAuth2 系统" # 分析 → 推荐链 → 用户确认 → 执行 /ccw-coordinator "实现 OAuth2 系统"
``` ```
**主要区别**： ### 会话管理命令
| 方面 | /ccw | /ccw-coordinator | ```bash
|------|------|------------------| /workflow:session:start # 启动新工作流会话
| **执行方式** | 主进程（SlashCommand） | 外部 CLI（后台任务） | /workflow:session:resume # 恢复暂停的会话
| **选择方式** | 自动基于意图识别 | 智能推荐 + 可选调整 | /workflow:session:list # 列出所有会话
| **状态管理** | TodoWrite 跟踪 | 持久化 state.json | /workflow:session:sync # 同步会话工作
| **适用场景** | 通用任务、快速开发 | 复杂链条、可恢复 | /workflow:session:complete # 完成会话
```
--- ### Issue 工作流命令
```bash
/issue/new # 创建新 issue
/issue/plan # 规划 issue 解决方案
/issue/queue # 形成执行队列
/issue/execute # 执行 issue 队列
```
### 其他 CLI 命令 ### 其他 CLI 命令
@@ -315,45 +271,17 @@ ccw cli -p "..." # 执行 CLI 工具 (Gemini/Qwen/Codex)
ccw upgrade -a # 升级所有安装 ccw upgrade -a # 升级所有安装
``` ```
### Dashboard 功能
<div align="center">
<table>
<tr><th>功能</th><th>说明</th></tr>
<tr><td><b>会话概览</b></td><td>跟踪工作流会话和进度</td></tr>
<tr><td><b>CodexLens</b></td><td>FTS + 语义 + 混合代码搜索</td></tr>
<tr><td><b>图浏览器</b></td><td>交互式代码关系可视化</td></tr>
<tr><td><b>CLI 管理器</b></td><td>执行历史与会话恢复</td></tr>
</table>
</div>
---
## 📖 文档
<div align="center">
| 文档 | 说明 |
|------|------|
| [**工作流指南**](WORKFLOW_GUIDE_CN.md) | 4 级工作流系统（推荐） |
| [**快速开始**](GETTING_STARTED_CN.md) | 5 分钟快速入门 |
| [**Dashboard 指南**](DASHBOARD_GUIDE.md) | Dashboard 用户指南 |
| [**常见问题**](FAQ.md) | 常见问题解答 |
| [**更新日志**](CHANGELOG.md) | 版本历史 |
</div>
--- ---
## 🏗️ 架构概览 ## 🏗️ 架构概览
``` ```
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ 主干工作流 (4 级) │ │ 工作流 Skills │
│ ⚡ Level 1: lite-lite-lite (即时执行) │ │ 📝 workflow:lite-plan / workflow:multi-cli-plan (轻量级) │
│ 📝 Level 2: lite-plan / lite-fix / multi-cli-plan (→ execute) │ │ 📊 workflow:plan / workflow:tdd-plan (会话式) │
│ 📊 Level 3: plan / tdd-plan / test-fix-gen (Session 持久化) │ │ 🧪 workflow:test-fix-gen / workflow:test-cycle-execute │
│ 🧠 Level 4: brainstorm:auto-parallel → plan → execute │ │ 🧠 brainstorm (多角色分析) │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
↓ ↓
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
@@ -378,13 +306,6 @@ ccw upgrade -a # 升级所有安装
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
``` ```
**核心原则：**
- ⚡ **依赖分析** 解决并行问题 - 主干工作流无需 worktree
- 🤖 **Team 架构 v2** 提供统一的基于角色的智能体执行与内循环
- 🔧 **队列调度器** 处理后台任务执行与统一设置
- 🖥️ **终端仪表板** 提供实时监控和控制
- 🎯 根据复杂度选择工作流级别 - 避免过度工程化
--- ---
## 📦 项目结构 ## 📦 项目结构
@@ -394,27 +315,26 @@ Claude-Code-Workflow/
├── .claude/ ├── .claude/
│ ├── agents/ # 22 个专业化智能体 (team-worker, cli-discuss 等) │ ├── agents/ # 22 个专业化智能体 (team-worker, cli-discuss 等)
│ ├── commands/ # 斜杠命令（5 个类别） │ ├── commands/ # 斜杠命令（5 个类别）
│ │ ├── root/ # 根命令 (/ccw, /ccw-coordinator) │ │ ├── ccw.md # 主编排器
│ │ ├── ccw-coordinator.md
│ │ ├── cli/ # CLI 命令 (cli-init, codex-review) │ │ ├── cli/ # CLI 命令 (cli-init, codex-review)
│ │ ├── issue/ # Issue 管理 (plan, execute, queue) │ │ ├── issue/ # Issue 管理 (plan, execute, queue)
│ │ ├── memory/ # 内存命令 (prepare, style-skill-memory) │ │ ├── memory/ # 内存命令 (prepare, style-skill-memory)
│ │ └── workflow/ # 工作流命令 (brainstorm, plan, session) │ │ └── workflow/ # 工作流命令 (session, ui-design 等)
│ └── skills/ # 37 个模块化技能 │ └── skills/ # 37 个模块化技能
│ ├── review-code/ # 基于规则的代码审查 │ ├── workflow-lite-plan/
│ ├── skill-tuning/ # 技能诊断与优化 │ ├── workflow-plan/
│ ├── skill-generator/ # 技能脚手架与生成 │ ├── workflow-tdd/
│ ├── spec-generator/ # 产品规格生成 │ ├── workflow-test-fix/
│ ├── memory-*/ # 内存管理技能 │ ├── brainstorm/
│ ├── workflow-*/ # 工作流编排技能 │ ├── team-*/ # 团队协调技能
│ ├── team-*/ # 团队协调技能
│ └── ... │ └── ...
├── ccw/ ├── ccw/
│ ├── src/ # TypeScript 源码 │ ├── src/ # TypeScript 源码
│ │ ├── commands/ # CLI 命令实现 │ │ ├── commands/ # CLI 命令实现
│ │ ├── core/ # 核心服务 (a2ui, auth, hooks, routes) │ │ ├── core/ # 核心服务 (a2ui, auth, hooks, routes)
│ │ ├── mcp-server/ # MCP 服务器实现 │ │ ├── mcp-server/ # MCP 服务器实现
│ │ ├── tools/ # 工具实现 │ │ └── tools/ # 工具实现
│ │ └── utils/ # 工具函数
│ └── frontend/ # React 前端（终端仪表板、编排器） │ └── frontend/ # React 前端（终端仪表板、编排器）
├── codex-lens/ # 本地语义代码搜索引擎 ├── codex-lens/ # 本地语义代码搜索引擎
└── docs/ # 文档 └── docs/ # 文档
@@ -443,13 +363,6 @@ v2 团队架构引入了**事件驱动的节拍模型**，实现高效编排：
回调 <--------------------------------------+ 回调 <--------------------------------------+
(下一节拍) SendMessage + TaskUpdate(completed) (下一节拍) SendMessage + TaskUpdate(completed)
====================================================================== ======================================================================
快速推进 (简单线性后继跳过协调器)
======================================================================
[工作者 A] 阶段 5 完成
+- 1个就绪任务？简单后继？ --> 直接生成 team-worker B
+- 复杂情况？ --> SendMessage 给协调器
======================================================================
``` ```
**核心优势：** **核心优势：**
@@ -483,10 +396,6 @@ v2 团队架构引入了**事件驱动的节拍模型**，实现高效编排：
- 🔧 节点配置属性面板 - 🔧 节点配置属性面板
- ⚡ 斜杠命令集成 - ⚡ 斜杠命令集成
### 分析查看器 (Analysis Viewer)
带过滤功能的分析会话网格布局，支持全屏模式。
--- ---
## 🤝 贡献 ## 🤝 贡献
@@ -494,7 +403,6 @@ v2 团队架构引入了**事件驱动的节拍模型**，实现高效编排：
<div align="center"> <div align="center">
<a href="https://github.com/catlog22/Claude-Code-Workflow"><img src="https://img.shields.io/badge/GitHub-仓库-181717?style=flat-square" alt="GitHub"/></a> <a href="https://github.com/catlog22/Claude-Code-Workflow"><img src="https://img.shields.io/badge/GitHub-仓库-181717?style=flat-square" alt="GitHub"/></a>
<a href="https://github.com/catlog22/Claude-Code-Workflow/issues"><img src="https://img.shields.io/badge/Issues-报告问题-EF4444?style=flat-square" alt="Issues"/></a> <a href="https://github.com/catlog22/Claude-Code-Workflow/issues"><img src="https://img.shields.io/badge/Issues-报告问题-EF4444?style=flat-square" alt="Issues"/></a>
<a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/贡献-指南-10B981?style=flat-square" alt="Contributing"/></a>
</div> </div>
--- ---

948
WORKFLOW_GUIDE.md
View File

File diff suppressed because it is too large Load Diff

964
WORKFLOW_GUIDE_CN.md
View File

File diff suppressed because it is too large Load Diff