mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
docs: Update README files for v3.2.2 release
Update both English and Chinese README files to reflect v3.2.2 changes: Version Updates: - Bump version badge from v3.2.1 to v3.2.2 - Update "What's New" section with v3.2.2 features Key Documentation Changes: - Independent test session architecture (WFS-test-[source]) - Automatic cross-session context gathering via metadata - Integrated concept-enhanced analysis (Gemini + Codex parallel) - Reuses IMPL-*.json format with meta.type="test-fix" - 4-phase workflow: session → context → analysis → task generation Command Reference Updates: - Updated /workflow:test-gen description to reflect independent workflow creation - Updated Phase 4 examples to show new usage: /workflow:test-gen WFS-auth Changes in Both Files: - README.md: English version updated - README_CN.md: Chinese version updated with matching content 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
63
README.md
63
README.md
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
[](https://github.com/catlog22/Claude-Code-Workflow/releases)
|
[](https://github.com/catlog22/Claude-Code-Workflow/releases)
|
||||||
[](LICENSE)
|
[](LICENSE)
|
||||||
[]()
|
[]()
|
||||||
[](https://github.com/modelcontextprotocol)
|
[](https://github.com/modelcontextprotocol)
|
||||||
@@ -15,13 +15,14 @@
|
|||||||
|
|
||||||
**Claude Code Workflow (CCW)** is a next-generation multi-agent automation framework that orchestrates complex software development tasks through intelligent workflow management and autonomous execution.
|
**Claude Code Workflow (CCW)** is a next-generation multi-agent automation framework that orchestrates complex software development tasks through intelligent workflow management and autonomous execution.
|
||||||
|
|
||||||
> **🎉 Latest: v3.2.0** - Simplified agent architecture with "Tests Are the Review" philosophy. See [CHANGELOG.md](CHANGELOG.md) for details.
|
> **🎉 Latest: v3.2.2** - Independent test-gen workflow with cross-session context. See [CHANGELOG.md](CHANGELOG.md) for details.
|
||||||
>
|
>
|
||||||
> **What's New in v3.2.0**:
|
> **What's New in v3.2.2**:
|
||||||
> - 🔄 Simplified from 3 agents to 2 core agents (`@code-developer`, `@test-fix-agent`)
|
> - 🔄 Independent test session architecture (WFS-test-[source])
|
||||||
> - ✅ "Tests Are the Review" - Passing tests = approved code
|
> - 🤖 Automatic cross-session context gathering via metadata
|
||||||
> - 🧪 Enhanced test-fix workflow with automatic execution and fixing
|
> - 🧪 Integrated concept-enhanced analysis (Gemini + Codex parallel execution)
|
||||||
> - 📦 Interactive installation with version selection menu
|
> - 📦 Reuses IMPL-*.json format with meta.type="test-fix" (zero breaking changes)
|
||||||
|
> - ⚡ 4-phase workflow: session → context → analysis → task generation
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -94,17 +95,51 @@ Select version to install (1-3, default: 1):
|
|||||||
|
|
||||||
> 💡 **Pro Tip**: The installer automatically detects and displays the latest version numbers and release dates from GitHub. Just press Enter to select the recommended stable release.
|
> 💡 **Pro Tip**: The installer automatically detects and displays the latest version numbers and release dates from GitHub. Just press Enter to select the recommended stable release.
|
||||||
|
|
||||||
|
### **📦 Local Installation (Install-Claude.ps1)**
|
||||||
|
|
||||||
|
For local installation without network access, use the bundled PowerShell installer:
|
||||||
|
|
||||||
|
**Installation Modes:**
|
||||||
|
```powershell
|
||||||
|
# Interactive mode with prompts (recommended)
|
||||||
|
.\Install-Claude.ps1
|
||||||
|
|
||||||
|
# Quick install with automatic backup
|
||||||
|
.\Install-Claude.ps1 -Force -BackupAll
|
||||||
|
|
||||||
|
# Non-interactive install
|
||||||
|
.\Install-Claude.ps1 -NonInteractive -Force
|
||||||
|
```
|
||||||
|
|
||||||
|
**Installation Options:**
|
||||||
|
|
||||||
|
| Mode | Description | Installs To |
|
||||||
|
|------|-------------|-------------|
|
||||||
|
| **Global** | System-wide installation (default) | `~/.claude/`, `~/.codex/`, `~/.gemini/` |
|
||||||
|
| **Path** | Custom directory + global hybrid | Local: `agents/`, `commands/`<br>Global: `workflows/`, `scripts/` |
|
||||||
|
|
||||||
|
**Backup Behavior:**
|
||||||
|
- **Default**: Automatic backup enabled (`-BackupAll`)
|
||||||
|
- **Disable**: Use `-NoBackup` flag (⚠️ overwrites without backup)
|
||||||
|
- **Backup location**: `claude-backup-{timestamp}/` in installation directory
|
||||||
|
|
||||||
|
**⚠️ Important Warnings:**
|
||||||
|
- `-Force -BackupAll`: Silent file overwrite (with backup)
|
||||||
|
- `-NoBackup -Force`: Permanent file overwrite (no recovery)
|
||||||
|
- Global mode modifies user profile directories
|
||||||
|
|
||||||
### **✅ Verify Installation**
|
### **✅ Verify Installation**
|
||||||
After installation, run the following command to ensure CCW is working:
|
After installation, run the following command to ensure CCW is working:
|
||||||
```bash
|
```bash
|
||||||
/workflow:session:list
|
/workflow:session:list
|
||||||
```
|
```
|
||||||
|
|
||||||
> **📝 Important Notes:**
|
> **📝 Installation Notes:**
|
||||||
> - The installer will automatically install/update `.codex/` and `.gemini/` directories
|
> - The installer will automatically install/update `.codex/` and `.gemini/` directories
|
||||||
> - **Global mode**: Installs to `~/.codex` and `~/.gemini`
|
> - **Global mode**: Installs to `~/.codex` and `~/.gemini`
|
||||||
> - **Path mode**: Installs to your specified directory (e.g., `project/.codex`, `project/.gemini`)
|
> - **Path mode**: Installs to your specified directory (e.g., `project/.codex`, `project/.gemini`)
|
||||||
> - Existing files will be backed up automatically before installation
|
> - **Backup**: Existing files are backed up by default to `claude-backup-{timestamp}/`
|
||||||
|
> - **Safety**: Use interactive mode for first-time installation to review changes
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -142,9 +177,9 @@ After installation, run the following command to ensure CCW is working:
|
|||||||
|
|
||||||
**Phase 4: Testing & Quality Assurance**
|
**Phase 4: Testing & Quality Assurance**
|
||||||
```bash
|
```bash
|
||||||
# Generate comprehensive test suite (standard workflow)
|
# Generate independent test-fix workflow (v3.2.2+)
|
||||||
/workflow:test-gen
|
/workflow:test-gen WFS-auth # Creates WFS-test-auth session
|
||||||
/workflow:execute
|
/workflow:execute # Runs test validation
|
||||||
|
|
||||||
# OR verify TDD compliance (TDD workflow)
|
# OR verify TDD compliance (TDD workflow)
|
||||||
/workflow:tdd-verify
|
/workflow:tdd-verify
|
||||||
@@ -217,7 +252,7 @@ After installation, run the following command to ensure CCW is working:
|
|||||||
| `/workflow:tdd-plan` | Create a Test-Driven Development workflow with Red-Green-Refactor cycles. |
|
| `/workflow:tdd-plan` | Create a Test-Driven Development workflow with Red-Green-Refactor cycles. |
|
||||||
| `/workflow:execute` | Execute the current workflow plan autonomously. |
|
| `/workflow:execute` | Execute the current workflow plan autonomously. |
|
||||||
| `/workflow:status` | Display the current status of the workflow. |
|
| `/workflow:status` | Display the current status of the workflow. |
|
||||||
| `/workflow:test-gen` | Automatically generate a test plan from the implementation. |
|
| `/workflow:test-gen` | Create independent test-fix workflow for validating completed implementation. |
|
||||||
| `/workflow:tdd-verify` | Verify TDD compliance and generate quality report. |
|
| `/workflow:tdd-verify` | Verify TDD compliance and generate quality report. |
|
||||||
| `/workflow:review` | **Optional** manual review (only use when explicitly needed - passing tests = approved code). |
|
| `/workflow:review` | **Optional** manual review (only use when explicitly needed - passing tests = approved code). |
|
||||||
|
|
||||||
@@ -275,7 +310,7 @@ Configure Gemini CLI for optimal integration:
|
|||||||
```json
|
```json
|
||||||
// ~/.gemini/settings.json
|
// ~/.gemini/settings.json
|
||||||
{
|
{
|
||||||
"contextFileName": "CLAUDE.md"
|
"contextFileName": ["CLAUDE.md", "GEMINI.md"]
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
66
README_CN.md
66
README_CN.md
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
[](https://github.com/catlog22/Claude-Code-Workflow/releases)
|
[](https://github.com/catlog22/Claude-Code-Workflow/releases)
|
||||||
[](LICENSE)
|
[](LICENSE)
|
||||||
[]()
|
[]()
|
||||||
[](https://github.com/modelcontextprotocol)
|
[](https://github.com/modelcontextprotocol)
|
||||||
@@ -15,13 +15,14 @@
|
|||||||
|
|
||||||
**Claude Code Workflow (CCW)** 是一个新一代的多智能体自动化开发框架,通过智能工作流管理和自主执行来协调复杂的软件开发任务。
|
**Claude Code Workflow (CCW)** 是一个新一代的多智能体自动化开发框架,通过智能工作流管理和自主执行来协调复杂的软件开发任务。
|
||||||
|
|
||||||
> **🎉 最新版本: v3.2.0** - 采用"测试即审查"理念简化智能体架构。详见 [CHANGELOG.md](CHANGELOG.md)。
|
> **🎉 最新版本: v3.2.2** - 独立测试生成工作流,支持跨会话上下文。详见 [CHANGELOG.md](CHANGELOG.md)。
|
||||||
>
|
>
|
||||||
> **v3.2.0 版本新特性**:
|
> **v3.2.2 版本新特性**:
|
||||||
> - 🔄 从 3 个智能体简化为 2 个核心智能体(`@code-developer`、`@test-fix-agent`)
|
> - 🔄 独立测试会话架构(WFS-test-[source])
|
||||||
> - ✅ "测试即审查" - 测试通过 = 代码批准
|
> - 🤖 通过元数据自动跨会话上下文收集
|
||||||
> - 🧪 增强的测试修复工作流,支持自动执行和修复
|
> - 🧪 集成 concept-enhanced 分析(Gemini + Codex 并行执行)
|
||||||
> - 📦 交互式安装,包含版本选择菜单
|
> - 📦 复用 IMPL-*.json 格式,meta.type="test-fix"(零破坏性更改)
|
||||||
|
> - ⚡ 4 阶段工作流:会话 → 上下文 → 分析 → 任务生成
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -94,17 +95,51 @@ bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflo
|
|||||||
|
|
||||||
> 💡 **提示**:安装程序会自动从 GitHub 检测并显示最新的版本号和发布日期。只需按 Enter 键即可选择推荐的稳定版本。
|
> 💡 **提示**:安装程序会自动从 GitHub 检测并显示最新的版本号和发布日期。只需按 Enter 键即可选择推荐的稳定版本。
|
||||||
|
|
||||||
|
### **📦 本地安装 (Install-Claude.ps1)**
|
||||||
|
|
||||||
|
无需网络访问时,使用内置的 PowerShell 安装脚本:
|
||||||
|
|
||||||
|
**安装模式:**
|
||||||
|
```powershell
|
||||||
|
# 交互式安装(推荐)
|
||||||
|
.\Install-Claude.ps1
|
||||||
|
|
||||||
|
# 快速安装(自动备份)
|
||||||
|
.\Install-Claude.ps1 -Force -BackupAll
|
||||||
|
|
||||||
|
# 非交互式安装
|
||||||
|
.\Install-Claude.ps1 -NonInteractive -Force
|
||||||
|
```
|
||||||
|
|
||||||
|
**安装选项:**
|
||||||
|
|
||||||
|
| 模式 | 描述 | 安装位置 |
|
||||||
|
|------|------|----------|
|
||||||
|
| **Global** | 系统级安装(默认) | `~/.claude/`、`~/.codex/`、`~/.gemini/` |
|
||||||
|
| **Path** | 自定义目录 + 全局混合 | 本地:`agents/`、`commands/`<br>全局:`workflows/`、`scripts/` |
|
||||||
|
|
||||||
|
**备份行为:**
|
||||||
|
- **默认**:自动备份启用(`-BackupAll`)
|
||||||
|
- **禁用**:使用 `-NoBackup` 标志(⚠️ 无备份覆盖)
|
||||||
|
- **备份位置**:安装目录中的 `claude-backup-{timestamp}/`
|
||||||
|
|
||||||
|
**⚠️ 重要警告:**
|
||||||
|
- `-Force -BackupAll`:静默文件覆盖(带备份)
|
||||||
|
- `-NoBackup -Force`:永久文件覆盖(无法恢复)
|
||||||
|
- Global 模式会修改用户配置目录
|
||||||
|
|
||||||
### **✅ 验证安装**
|
### **✅ 验证安装**
|
||||||
安装后,运行以下命令以确保 CCW 正常工作:
|
安装后,运行以下命令以确保 CCW 正常工作:
|
||||||
```bash
|
```bash
|
||||||
/workflow:session:list
|
/workflow:session:list
|
||||||
```
|
```
|
||||||
|
|
||||||
> **📝 重要说明:**
|
> **📝 安装说明:**
|
||||||
> - 安装程序将自动安装/更新 `.codex/` 和 `.gemini/` 目录
|
> - 安装程序将自动安装/更新 `.codex/` 和 `.gemini/` 目录
|
||||||
> - **全局模式**:安装到 `~/.codex` 和 `~/.gemini`
|
> - **全局模式**:安装到 `~/.codex` 和 `~/.gemini`
|
||||||
> - **路径模式**:安装到指定目录(例如 `project/.codex`、`project/.gemini`)
|
> - **路径模式**:安装到指定目录(例如 `project/.codex`、`project/.gemini`)
|
||||||
> - 安装前会自动备份现有文件
|
> - **备份**:默认自动备份现有文件到 `claude-backup-{timestamp}/`
|
||||||
|
> - **安全**:首次安装建议使用交互式模式以审查更改
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -142,15 +177,12 @@ bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflo
|
|||||||
|
|
||||||
**阶段 4:测试与质量保证**
|
**阶段 4:测试与质量保证**
|
||||||
```bash
|
```bash
|
||||||
# 生成全面测试套件(标准工作流)
|
# 生成独立测试修复工作流(v3.2.2+)
|
||||||
/workflow:test-gen
|
/workflow:test-gen WFS-auth # 创建 WFS-test-auth 会话
|
||||||
/workflow:execute
|
/workflow:execute # 运行测试验证
|
||||||
|
|
||||||
# 或验证 TDD 合规性(TDD 工作流)
|
# 或验证 TDD 合规性(TDD 工作流)
|
||||||
/workflow:tdd-verify
|
/workflow:tdd-verify
|
||||||
|
|
||||||
# 可选:手动审查(仅在明确需要时使用)
|
|
||||||
# /workflow:review # 测试通过 = 代码已批准
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### 简单任务快速入门
|
### 简单任务快速入门
|
||||||
@@ -220,7 +252,7 @@ bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflo
|
|||||||
| `/workflow:tdd-plan` | 创建测试驱动开发工作流,包含 Red-Green-Refactor 循环。 |
|
| `/workflow:tdd-plan` | 创建测试驱动开发工作流,包含 Red-Green-Refactor 循环。 |
|
||||||
| `/workflow:execute` | 自主执行当前的工作流计划。 |
|
| `/workflow:execute` | 自主执行当前的工作流计划。 |
|
||||||
| `/workflow:status` | 显示工作流的当前状态。 |
|
| `/workflow:status` | 显示工作流的当前状态。 |
|
||||||
| `/workflow:test-gen` | 从实现中自动生成测试计划。 |
|
| `/workflow:test-gen` | 创建独立测试修复工作流,用于验证已完成的实现。 |
|
||||||
| `/workflow:tdd-verify` | 验证 TDD 合规性并生成质量报告。 |
|
| `/workflow:tdd-verify` | 验证 TDD 合规性并生成质量报告。 |
|
||||||
| `/workflow:review` | **可选** 手动审查(仅在明确需要时使用,测试通过即代表代码已批准)。 |
|
| `/workflow:review` | **可选** 手动审查(仅在明确需要时使用,测试通过即代表代码已批准)。 |
|
||||||
|
|
||||||
@@ -278,7 +310,7 @@ npm install -g @google/gemini-cli @openai/codex @qwen-code/qwen-code
|
|||||||
```json
|
```json
|
||||||
// ~/.gemini/settings.json
|
// ~/.gemini/settings.json
|
||||||
{
|
{
|
||||||
"contextFileName": "CLAUDE.md"
|
"contextFileName": ["CLAUDE.md", "GEMINI.md"]
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user