# 🚀 Claude Code Workflow (CCW)
*软件开发的神经网络*

<div align="right">

**语言:** [English](README.md) | [中文](README_CN.md)

</div>

<div align="center">

**将你的开发混乱转化为精心编排的辉煌**

*在这里，AI智能体协作共事，复杂性变为清晰，你的代码库进化为活文档*

</div>

---

## 🌟 是什么让CCW如此革命性？

想象一下，有一个**专业AI开发团队**24/7与你并肩作战。CCW不仅仅是另一个工作流工具——它是一个**活生生的、会呼吸的开发生态系统**，能够思考、学习并适应你项目的DNA。

### 🎭 认识你的AI梦之队
- **🧠 概念规划智能体**: 看得见大局的远见架构师
- **⚡ 行动规划智能体**: 将梦想转化为路线图的战略执行者
- **💻 代码开发智能体**: 精准实现的不知疲倦编程伙伴
- **🔍 代码审查智能体**: 确保质量永不下滑的完美主义者
- **📚 记忆桥接智能体**: 保持一切文档化的项目史学家

### 🎯 魔法在三个层面发生

#### **🗂️ JSON纯数据模型：你项目的大脑**
把它想象为你项目的**神经记忆**——每个决策、每个任务、每个计划都存活在纯粹、闪电般快速的JSON中。不再有不同步的文档噩梦！

- ⚡ **亚毫秒查询**: 你的项目响应比你思考还快
- 🔄 **零同步问题**: 单一真相来源，永远如此
- 🎯 **纯数据架构**: 干净、快速、可靠

#### **🎪 标记文件会话管理：瞬间上下文切换**
就像拥有**多重开发人格**，你可以即刻切换：

```bash
ls .workflow/.active-*  # 一目了然地查看你的活跃会话
```

- 🏃‍♂️ **原子操作**: 微秒级会话切换
- 🔧 **自愈能力**: 自动冲突解决
- 📈 **无限可扩展性**: 数百个并发会话，零性能影响

#### **🧬 渐进式复杂度：与你的雄心共同成长**

CCW **读懂你项目的心思**并调整其精密程度：

| 你的项目 | CCW的回应 | 你得到的 |
|-------------|----------------|--------------|
| **快速修复** (<5个任务) | 🎯 极简模式 | 简化、直接的工作流 |
| **功能开发** (5-15个任务) | ⚙️ 增强模式 | 智能跟踪 + 自动文档 |
| **主要项目** (>15个任务) | 🏰 完整套件 | 完全编排 + 多级规划 |

---

## 🎨 开发者体验革命

### 🌊 从混乱到心流状态

**使用CCW之前:**
```
😰 "我上次做到哪里了？"
📝 "我的文档是最新的吗？"
🤔 "架构又是怎样的？"
⏰ "我已经被困在这里几小时了..."
```

**使用CCW之后:**
```bash
/workflow:session:resume "oauth-implementation"  # 瞬间上下文恢复
/context --format=hierarchy                      # 美观地看到一切
/gemini:analyze "authentication flow patterns"   # AI驱动的洞察
/codex:exec "@{src/auth/**/*} implement JWT refresh tokens"  # 自主执行
```

### 🎭 你的工作流成为故事

#### 🎪 **第一幕：头脑风暴交响曲**
```bash
/workflow:brainstorm "支付网关集成" \
  --perspectives=system-architect,security-expert,data-architect
```
观看**多个AI专家**实时协作，每个都带来专业知识，创建一个全面的基础。

#### 🎯 **第二幕：战略阶段**
```bash
/workflow:plan --from-brainstorming
```
你的头脑风暴洞察转化为**清晰明确的实现路线图**，带有依赖跟踪和风险分析。

#### ⚡ **第三幕：执行芭蕾**
```bash
/task:execute IMPL-1 --mode=auto
/gemini:execute IMPL-2.1  # 分析导向任务
/codex:exec "@{src/api/**/*} implement payment validation"  # 开发任务
```
观看你的代码**自我编写**，同时保持最高质量标准。

---

## 🛠️ 双CLI超能力

### 🔍 **Gemini：你的项目侦探**
*"告诉我这个代码库的一切"*

```bash
gemini --all-files -p "@{src/**/*} @{CLAUDE.md} 
分析认证模式和安全影响"
```

**Gemini看见你从未注意到的模式**，理解架构决策，并提供需要数小时才能手工发现的洞察。

### 🤖 **Codex：你的自主开发者**
*"趁我去喝咖啡时构建这个功能"*

```bash
codex --full-auto "@{**/*} 创建一个完整的用户仪表板，
具有实时通知和响应式设计"
```

**Codex不仅仅建议——它实现**，测试、文档化，甚至处理你忘记提及的边缘情况。

---

## 🏗️ 与你梦想共同扩展的架构

### 🌳 活文档系统

忘记静态README文件。CCW创建一个**活生生的、会呼吸的文档生态系统**：

```
📁 你的项目/
├── CLAUDE.md                    # 🌍 项目宇宙视图
├── src/
│   ├── CLAUDE.md               # 🏢 领域架构
│   ├── components/
│   │   ├── CLAUDE.md           # 🧩 组件模式
│   │   └── auth/
│   │       └── CLAUDE.md       # 🔐 实现细节
```

**每一层都确切知道它应该包含什么**——不多不少。你的文档随着代码的发展**自我更新**。

### 🧠 永不休眠的智能

#### 🎯 **上下文感知更新**
```bash
/update-memory-related  # "什么改变了？让我智能地更新文档"
```

CCW使用**git感知变更检测**来只更新重要的内容，保持你的文档**新鲜和相关**。

#### 🌊 **完整项目同步**
```bash
/update-memory-full     # "让我从头开始刷新一切"
```

完美适用于新团队成员入职或重大架构更改后。

---

## ⚡ 快速开始：从零到英雄

### 🚀 一行安装
```powershell
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1" -UseBasicParsing).Content
```

### 🎯 关键设置
配置Gemini CLI集成：
```json
{
  "contextFileName": "CLAUDE.md"  // 神奇的连接
}
```

### 🎪 你的第一个工作流
```bash
# 1. 🎭 从愿景开始
/workflow:session:start "构建一个AI驱动的待办事项应用"

# 2. 🧠 收集观点  
/workflow:brainstorm "待办应用架构" \
  --perspectives=ui-designer,system-architect,data-architect

# 3. 📋 创建主计划
/workflow:plan --from-brainstorming

# 4. ⚡ 精准执行
/workflow:execute --type=complex --auto-create-tasks

# 5. 🎯 观看魔法发生
/context --format=hierarchy
```

---

## 🎭 命令武器库

### 🧠 **智能命令**
| 命令 | 超能力 | 示例 |
|---------|------------|---------|
| `/gemini:mode:auto` | 🎯 **智能模板选择** | 自动检测错误报告、功能请求、架构问题 |
| `/codex:mode:auto` | 🤖 **自主开发** | 全栈功能实现，你专注于策略 |
| `/enhance-prompt` | 💡 **上下文放大** | 将模糊请求转化为精确技术规范 |

### 🎪 **工作流编排**
| 命令 | 魔法 | 结果 |
|---------|-------|---------|
| `/workflow:brainstorm` | 🎭 **多专家协作** | 5个AI专家在你的挑战上协作 |
| `/workflow:plan-deep` | 🏗️ **架构精通** | 3级深度规划与依赖映射 |
| `/workflow:execute` | ⚡ **智能自动化** | 复杂度感知任务编排 |

### 🔧 **任务掌控**
| 命令 | 力量 | 影响 |
|---------|-------|---------|
| `/task:breakdown` | 🧩 **智能分解** | 复杂任务 → 可管理块 |
| `/task:replan` | 🔄 **适应性智能** | 需求改变？没问题。 |
| `/context` | 🎯 **全知觉察** | 看见一切，理解一切 |

---

## 🌟 真实世界场景

### 🚀 **场景：构建SaaS平台**
```bash
# 第1天：愿景
/workflow:session:start "具有实时协作的多租户SaaS平台"
/workflow:brainstorm "SaaS架构设计" --perspectives=business-analyst,system-architect,security-expert

# 第2天：基础  
/workflow:plan-deep --complexity=high --depth=3
/task:create "认证与授权系统"
/task:create "多租户数据库架构"
/task:create "实时通信层"

# 第1-4周：实现
/codex:mode:auto "实现基于JWT的身份验证与角色管理"
/codex:mode:auto "创建租户隔离中间件"
/codex:mode:auto "构建基于WebSocket的协作功能"

# 持续：维护
/update-memory-related  # 每个功能后
/workflow:issue:create "添加OAuth2集成"
/workflow:review --auto-fix
```

### 🐛 **场景：紧急Bug修复**
```bash
# 危机
/workflow:session:start "生产环境中的关键支付处理错误"

# 调查
/gemini:analyze "@{src/payments/**/*}中的支付流程失败 - 分析错误模式"

# 解决方案
/codex:exec "@{src/payments/**/*} 修复支付验证竞态条件"

# 恢复
/workflow:review --auto-fix
/update-memory-related
```

### 🔒 **场景：安全审计**
```bash
# 审计
/workflow:brainstorm "安全漏洞评估" --perspectives=security-expert,penetration-tester

# 分析
/gemini:mode:auto "认证系统的全面安全分析"

# 补救
/codex:mode:auto "实现已识别漏洞的安全修复"

# 文档
/update-memory-full  # 完整安全文档更新
```

---

## 🎯 为什么开发者为之疯狂

### 🧠 **认知超能力**
- **🔮 完美记忆**: 再也不会丢失上下文
- **⚡ 即时专业知识**: AI专家触手可及
- **🎯 激光聚焦**: 复杂项目变成可管理的步骤
- **📚 活知识**: 与代码共同成长的文档

### 💪 **生产力放大**
- **10倍更快规划**: 分钟内多智能体头脑风暴
- **5倍更好代码质量**: 内置审查和测试集成
- **零文档债务**: 自更新的项目知识
- **无限可扩展性**: 处理任何复杂度的项目

### 🎨 **开发者之乐**
- **心流状态保持**: 永不失去思路
- **复杂度掌控**: 大问题变成小胜利
- **自主协助**: 真正帮助而非阻碍的AI
- **专业成长**: 实时向AI专家学习

---

## 🚀 未来就在现在

CCW代表了**软件开发的进化**——从手工、易错的过程转向**智能、适应性工作流**，与你的雄心共同扩展。

### 🌟 **接下来是什么？**
- 🤝 **增强多AI协作**: 更多专业化智能体
- 🌍 **实时团队同步**: 分布式团队，统一流程
- 📊 **预测项目分析**: 预测和预防问题的AI
- 🔧 **定制智能体训练**: 教CCW你的独特模式

---

## 🤝 加入革命

```bash
# Fork未来
git clone https://github.com/catlog22/Claude-Code-Workflow.git
cd Claude-Code-Workflow

# 让它成为你的
git checkout -b feature/my-amazing-contribution

# 分享魔法
git push origin feature/my-amazing-contribution
```

---

<div align="center">

**🎭 Claude Code Workflow (CCW)**

*软件开发变成艺术形式的地方*

**转化 • 编排 • 提升**

---

*MIT许可 • 由社区用❤️构建 • AI驱动*

[⭐ 在GitHub上给我们星标](https://github.com/catlog22/Claude-Code-Workflow) • [📖 完整文档](https://github.com/catlog22/Claude-Code-Workflow/wiki) • [💬 加入我们的社区](https://github.com/catlog22/Claude-Code-Workflow/discussions)

</div>