Skip to content

Commit 8c062f3

Browse files
catlog22claude
andcommitted
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>
1 parent 2efd45b commit 8c062f3

File tree

2 files changed

+98
-31
lines changed

2 files changed

+98
-31
lines changed

README.md

Lines changed: 49 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
<div align="center">
44

5-
[![Version](https://img.shields.io/badge/version-v3.2.1-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases)
5+
[![Version](https://img.shields.io/badge/version-v3.2.2-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases)
66
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
77
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()
88
[![MCP Tools](https://img.shields.io/badge/🔧_MCP_Tools-Experimental-orange.svg)](https://github.com/modelcontextprotocol)
@@ -15,13 +15,14 @@
1515

1616
**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.
1717

18-
> **🎉 Latest: v3.2.0** - Simplified agent architecture with "Tests Are the Review" philosophy. See [CHANGELOG.md](CHANGELOG.md) for details.
18+
> **🎉 Latest: v3.2.2** - Independent test-gen workflow with cross-session context. See [CHANGELOG.md](CHANGELOG.md) for details.
1919
>
20-
> **What's New in v3.2.0**:
21-
> - 🔄 Simplified from 3 agents to 2 core agents (`@code-developer`, `@test-fix-agent`)
22-
> - ✅ "Tests Are the Review" - Passing tests = approved code
23-
> - 🧪 Enhanced test-fix workflow with automatic execution and fixing
24-
> - 📦 Interactive installation with version selection menu
20+
> **What's New in v3.2.2**:
21+
> - 🔄 Independent test session architecture (WFS-test-[source])
22+
> - 🤖 Automatic cross-session context gathering via metadata
23+
> - 🧪 Integrated concept-enhanced analysis (Gemini + Codex parallel execution)
24+
> - 📦 Reuses IMPL-*.json format with meta.type="test-fix" (zero breaking changes)
25+
> - ⚡ 4-phase workflow: session → context → analysis → task generation
2526
2627
---
2728

@@ -94,17 +95,51 @@ Select version to install (1-3, default: 1):
9495

9596
> 💡 **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.
9697
98+
### **📦 Local Installation (Install-Claude.ps1)**
99+
100+
For local installation without network access, use the bundled PowerShell installer:
101+
102+
**Installation Modes:**
103+
```powershell
104+
# Interactive mode with prompts (recommended)
105+
.\Install-Claude.ps1
106+
107+
# Quick install with automatic backup
108+
.\Install-Claude.ps1 -Force -BackupAll
109+
110+
# Non-interactive install
111+
.\Install-Claude.ps1 -NonInteractive -Force
112+
```
113+
114+
**Installation Options:**
115+
116+
| Mode | Description | Installs To |
117+
|------|-------------|-------------|
118+
| **Global** | System-wide installation (default) | `~/.claude/`, `~/.codex/`, `~/.gemini/` |
119+
| **Path** | Custom directory + global hybrid | Local: `agents/`, `commands/`<br>Global: `workflows/`, `scripts/` |
120+
121+
**Backup Behavior:**
122+
- **Default**: Automatic backup enabled (`-BackupAll`)
123+
- **Disable**: Use `-NoBackup` flag (⚠️ overwrites without backup)
124+
- **Backup location**: `claude-backup-{timestamp}/` in installation directory
125+
126+
**⚠️ Important Warnings:**
127+
- `-Force -BackupAll`: Silent file overwrite (with backup)
128+
- `-NoBackup -Force`: Permanent file overwrite (no recovery)
129+
- Global mode modifies user profile directories
130+
97131
### **✅ Verify Installation**
98132
After installation, run the following command to ensure CCW is working:
99133
```bash
100134
/workflow:session:list
101135
```
102136

103-
> **📝 Important Notes:**
137+
> **📝 Installation Notes:**
104138
> - The installer will automatically install/update `.codex/` and `.gemini/` directories
105139
> - **Global mode**: Installs to `~/.codex` and `~/.gemini`
106140
> - **Path mode**: Installs to your specified directory (e.g., `project/.codex`, `project/.gemini`)
107-
> - Existing files will be backed up automatically before installation
141+
> - **Backup**: Existing files are backed up by default to `claude-backup-{timestamp}/`
142+
> - **Safety**: Use interactive mode for first-time installation to review changes
108143
109144
---
110145

@@ -142,9 +177,9 @@ After installation, run the following command to ensure CCW is working:
142177

143178
**Phase 4: Testing & Quality Assurance**
144179
```bash
145-
# Generate comprehensive test suite (standard workflow)
146-
/workflow:test-gen
147-
/workflow:execute
180+
# Generate independent test-fix workflow (v3.2.2+)
181+
/workflow:test-gen WFS-auth # Creates WFS-test-auth session
182+
/workflow:execute # Runs test validation
148183

149184
# OR verify TDD compliance (TDD workflow)
150185
/workflow:tdd-verify
@@ -217,7 +252,7 @@ After installation, run the following command to ensure CCW is working:
217252
| `/workflow:tdd-plan` | Create a Test-Driven Development workflow with Red-Green-Refactor cycles. |
218253
| `/workflow:execute` | Execute the current workflow plan autonomously. |
219254
| `/workflow:status` | Display the current status of the workflow. |
220-
| `/workflow:test-gen` | Automatically generate a test plan from the implementation. |
255+
| `/workflow:test-gen` | Create independent test-fix workflow for validating completed implementation. |
221256
| `/workflow:tdd-verify` | Verify TDD compliance and generate quality report. |
222257
| `/workflow:review` | **Optional** manual review (only use when explicitly needed - passing tests = approved code). |
223258

@@ -275,7 +310,7 @@ Configure Gemini CLI for optimal integration:
275310
```json
276311
// ~/.gemini/settings.json
277312
{
278-
"contextFileName": "CLAUDE.md"
313+
"contextFileName": ["CLAUDE.md", "GEMINI.md"]
279314
}
280315
```
281316

README_CN.md

Lines changed: 49 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
<div align="center">
44

5-
[![Version](https://img.shields.io/badge/version-v3.2.1-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases)
5+
[![Version](https://img.shields.io/badge/version-v3.2.2-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases)
66
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
77
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()
88
[![MCP工具](https://img.shields.io/badge/🔧_MCP工具-实验性-orange.svg)](https://github.com/modelcontextprotocol)
@@ -15,13 +15,14 @@
1515

1616
**Claude Code Workflow (CCW)** 是一个新一代的多智能体自动化开发框架,通过智能工作流管理和自主执行来协调复杂的软件开发任务。
1717

18-
> **🎉 最新版本: v3.2.0** - 采用"测试即审查"理念简化智能体架构。详见 [CHANGELOG.md](CHANGELOG.md)
18+
> **🎉 最新版本: v3.2.2** - 独立测试生成工作流,支持跨会话上下文。详见 [CHANGELOG.md](CHANGELOG.md)
1919
>
20-
> **v3.2.0 版本新特性**:
21-
> - 🔄 从 3 个智能体简化为 2 个核心智能体(`@code-developer``@test-fix-agent`
22-
> - ✅ "测试即审查" - 测试通过 = 代码批准
23-
> - 🧪 增强的测试修复工作流,支持自动执行和修复
24-
> - 📦 交互式安装,包含版本选择菜单
20+
> **v3.2.2 版本新特性**:
21+
> - 🔄 独立测试会话架构(WFS-test-[source]
22+
> - 🤖 通过元数据自动跨会话上下文收集
23+
> - 🧪 集成 concept-enhanced 分析(Gemini + Codex 并行执行)
24+
> - 📦 复用 IMPL-*.json 格式,meta.type="test-fix"(零破坏性更改)
25+
> - ⚡ 4 阶段工作流:会话 → 上下文 → 分析 → 任务生成
2526
2627
---
2728

@@ -94,17 +95,51 @@ bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflo
9495

9596
> 💡 **提示**:安装程序会自动从 GitHub 检测并显示最新的版本号和发布日期。只需按 Enter 键即可选择推荐的稳定版本。
9697
98+
### **📦 本地安装 (Install-Claude.ps1)**
99+
100+
无需网络访问时,使用内置的 PowerShell 安装脚本:
101+
102+
**安装模式:**
103+
```powershell
104+
# 交互式安装(推荐)
105+
.\Install-Claude.ps1
106+
107+
# 快速安装(自动备份)
108+
.\Install-Claude.ps1 -Force -BackupAll
109+
110+
# 非交互式安装
111+
.\Install-Claude.ps1 -NonInteractive -Force
112+
```
113+
114+
**安装选项:**
115+
116+
| 模式 | 描述 | 安装位置 |
117+
|------|------|----------|
118+
| **Global** | 系统级安装(默认) | `~/.claude/``~/.codex/``~/.gemini/` |
119+
| **Path** | 自定义目录 + 全局混合 | 本地:`agents/``commands/`<br>全局:`workflows/``scripts/` |
120+
121+
**备份行为:**
122+
- **默认**:自动备份启用(`-BackupAll`
123+
- **禁用**:使用 `-NoBackup` 标志(⚠️ 无备份覆盖)
124+
- **备份位置**:安装目录中的 `claude-backup-{timestamp}/`
125+
126+
**⚠️ 重要警告:**
127+
- `-Force -BackupAll`:静默文件覆盖(带备份)
128+
- `-NoBackup -Force`:永久文件覆盖(无法恢复)
129+
- Global 模式会修改用户配置目录
130+
97131
### **✅ 验证安装**
98132
安装后,运行以下命令以确保 CCW 正常工作:
99133
```bash
100134
/workflow:session:list
101135
```
102136

103-
> **📝 重要说明**
137+
> **📝 安装说明**
104138
> - 安装程序将自动安装/更新 `.codex/``.gemini/` 目录
105139
> - **全局模式**:安装到 `~/.codex``~/.gemini`
106140
> - **路径模式**:安装到指定目录(例如 `project/.codex``project/.gemini`
107-
> - 安装前会自动备份现有文件
141+
> - **备份**:默认自动备份现有文件到 `claude-backup-{timestamp}/`
142+
> - **安全**:首次安装建议使用交互式模式以审查更改
108143
109144
---
110145

@@ -142,15 +177,12 @@ bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflo
142177

143178
**阶段 4:测试与质量保证**
144179
```bash
145-
# 生成全面测试套件(标准工作流
146-
/workflow:test-gen
147-
/workflow:execute
180+
# 生成独立测试修复工作流(v3.2.2+
181+
/workflow:test-gen WFS-auth # 创建 WFS-test-auth 会话
182+
/workflow:execute # 运行测试验证
148183

149184
# 或验证 TDD 合规性(TDD 工作流)
150185
/workflow:tdd-verify
151-
152-
# 可选:手动审查(仅在明确需要时使用)
153-
# /workflow:review # 测试通过 = 代码已批准
154186
```
155187

156188
### 简单任务快速入门
@@ -220,7 +252,7 @@ bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflo
220252
| `/workflow:tdd-plan` | 创建测试驱动开发工作流,包含 Red-Green-Refactor 循环。 |
221253
| `/workflow:execute` | 自主执行当前的工作流计划。 |
222254
| `/workflow:status` | 显示工作流的当前状态。 |
223-
| `/workflow:test-gen` | 从实现中自动生成测试计划|
255+
| `/workflow:test-gen` | 创建独立测试修复工作流,用于验证已完成的实现|
224256
| `/workflow:tdd-verify` | 验证 TDD 合规性并生成质量报告。 |
225257
| `/workflow:review` | **可选** 手动审查(仅在明确需要时使用,测试通过即代表代码已批准)。 |
226258

@@ -278,7 +310,7 @@ npm install -g @google/gemini-cli @openai/codex @qwen-code/qwen-code
278310
```json
279311
// ~/.gemini/settings.json
280312
{
281-
"contextFileName": "CLAUDE.md"
313+
"contextFileName": ["CLAUDE.md", "GEMINI.md"]
282314
}
283315
```
284316

0 commit comments

Comments
 (0)