Claude-Code-Workflow/README_CN.md

Claude Code Workflow (CCW)

一个精密的多智能体自动化工作流框架，将复杂的软件开发任务从概念构思到实现审查转化为可管理、可追踪、AI协调的流程。

🏗️ 架构概览

Claude Code Workflow (CCW) 建立在两大基础支柱之上：

文档-状态分离

• 文档 (*.md)：存储人类可读的计划、策略、分析报告和总结
• 状态 (*.json)：管理机器可读的、动态的工作流状态和任务定义
• 这种分离确保了健壮性、可恢复性和自动化处理能力

渐进式复杂度

CCW 根据任务复杂度智能调整其文件结构和工作流程：

• 简单工作流：用于单文件 Bug 修复的轻量级结构
• 中等工作流：增强的文档和进度可视化
• 复杂工作流：完整的文档套件，包含详细的实现计划和多轮迭代

🚀 核心功能

多智能体系统

• 概念规划智能体：多视角头脑风暴和概念规划
• 行动规划智能体：将高层概念转化为可执行的实施计划
• 代码开发智能体：基于计划实现代码
• 代码审查智能体：审查代码质量和合规性
• 记忆桥接智能体：同步 Claude 和 Gemini 记忆，维护 CLAUDE.md 文件

工作流会话管理

• 创建、暂停、恢复、列出和切换工作流会话
• 自动初始化所需的文件和目录结构
• 层次化工作流文件系统 (.workflow/WFS-[topic-slug]/)

智能上下文生成

• 基于技术栈检测的动态上下文构建
• 项目结构分析和领域关键词提取
• 为 Gemini CLI 集成优化的文件定位

动态变更管理

• 问题跟踪和集成 (/workflow:issue)
• 自动重新规划能力 (/task:replan)
• 无缝适应需求变更

📁 目录结构

.claude/
├── agents/                 # AI 智能体定义和行为
├── commands/              # CLI 命令实现
├── output-styles/         # 输出格式模板
├── planning-templates/    # 角色特定的规划方法
├── prompt-templates/      # AI 交互模板
├── scripts/              # 自动化脚本
├── tech-stack-templates/ # 技术栈特定模板
├── workflows/            # 工作流定义和指南
└── settings.local.json   # 本地配置

🛠️ 安装

快速安装（推荐）

一键远程安装：

# PowerShell (Windows/Linux/macOS)
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content

带参数安装：

# 全局安装
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content | ForEach-Object { iex "$_ -Global" }

# 自定义目录安装
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content | ForEach-Object { iex "$_ -Directory 'C:\MyCustomPath'" }

# 强制安装（覆盖现有文件）
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1" -UseBasicParsing).Content | ForEach-Object { iex "$_ -Force" }

手动安装

1. 克隆此仓库：

git clone https://github.com/catlog22/Claude-CCW.git
cd Claude-CCW

2. 运行本地安装脚本：

# Windows PowerShell
.\Install-Claude.ps1

# 带参数
.\Install-Claude.ps1 -InstallMode Global -Force

3. 或手动设置环境：

# 复制到您的 Claude Code 配置目录
cp -r .claude ~/.claude/
# 或在 Windows 上
xcopy .claude %USERPROFILE%\.claude /E /I

4. 验证安装：

/workflow:session list

安装选项

参数	说明	示例
-Global	系统级安装	-Global
-Directory	自定义安装路径	-Directory "C:\CCW"
-Force	覆盖现有安装	-Force
-NoBackup	跳过现有文件备份	-NoBackup
-NonInteractive	静默安装	-NonInteractive
-Branch	从特定分支安装	-Branch "develop"

📖 使用指南

启动复杂工作流

1. 初始化会话：

/workflow:session start complex "实现 OAuth2 用户认证系统"

2. 概念规划（可选但推荐）：

/brainstorm "设计 OAuth2 认证系统架构" --perspectives=system-architect,security-expert,data-architect

3. 创建行动计划：

/workflow:action-plan --from-brainstorming

4. 任务创建与分解：

/task:create "后端 API 开发"
/task:breakdown IMPL-1

5. 执行任务：

/task:execute IMPL-1.1

6. 处理变更：

/workflow:issue create --type=bug "JWT 令牌刷新逻辑漏洞"
/workflow:issue integrate ISS-001 --position=immediate

7. 监控进度：

/workflow:context --detailed
/task:context IMPL-1.2

8. 审查与完成：

/workflow:review

🎯 关键命令

命令	用途
/workflow:session	管理工作流会话
/brainstorm	多视角概念规划
/workflow:action-plan	将概念转化为实施计划
/task:breakdown	将任务分解为可执行单元
/task:execute	执行特定任务
/workflow:issue	管理问题和变更
/gemini-execute	增强的 Gemini CLI 集成
/update_dms	维护分布式记忆系统

🔧 技术亮点

• 智能上下文处理：基于技术栈检测的动态上下文构建
• 模板驱动架构：通过模板实现高度可定制和可扩展性
• 质量保证集成：内置代码审查和测试策略阶段
• 分布式记忆系统 (DMS)：通过 CLAUDE.md 文件维护项目级共享记忆
• CLI 优先设计：强大、正交的命令行界面，便于自动化

🎨 设计理念

• 结构化优于自由发挥：引导式工作流防止混乱和遗漏
• 可追溯性与审计：所有决策和变更的完整审计追踪
• 自动化与人工监督：在关键决策点保持人工确认的高度自动化
• 关注点分离：清晰的架构，职责分明
• 可扩展性：易于通过新的智能体、命令和模板进行扩展

📚 文档

• 工作流指南：查看 workflows/ 目录获取详细的流程文档
• 智能体定义：检查 agents/ 了解 AI 智能体规范
• 模板库：探索 planning-templates/ 和 prompt-templates/
• 集成指南：查阅 workflows/gemini-*.md 中的 Gemini CLI 集成

🤝 贡献

1. Fork 此仓库
2. 创建功能分支：git checkout -b feature/amazing-feature
3. 提交更改：git commit -m 'Add amazing feature'
4. 推送到分支：git push origin feature/amazing-feature
5. 打开 Pull Request

📄 许可证

此项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🔮 未来路线图

• 增强多语言支持
• 与其他 AI 模型集成
• 高级项目分析和洞察
• 实时协作功能
• 扩展的 CI/CD 管道集成

---

Claude Code Workflow (CCW) - 通过智能自动化和结构化工作流变革软件开发。