Initial release: Claude Code Workflow (CCW) v2.0

🚀 Revolutionary AI-powered development workflow orchestration system ## 🔥 Core Innovations - **Document-State Separation**: Markdown for planning, JSON for execution state - **Progressive Complexity Management**: Level 0-2 adaptive workflow depth - **5-Agent Orchestration**: Specialized AI agents with context preservation - **Session-First Architecture**: Auto-discovery and state inheritance ## 🏗️ Key Features - Intelligent workflow orchestration (Simple/Medium/Complex patterns) - Real-time document-state synchronization with conflict resolution - Hierarchical task management with 3-level JSON structure - Gemini CLI integration with 12+ specialized templates - Comprehensive file output generation for all workflow commands ## 📦 Installation Remote one-liner installation: ``` iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1) ``` ## 🎯 System Architecture 4-layer intelligent development architecture: 1. Command Layer - Smart routing and version management 2. Agent Layer - 5 specialized development agents 3. Workflow Layer - Gemini templates and task orchestration 4. Memory Layer - Distributed documentation and auto-sync 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
2026-02-13 02:41:50 +08:00 · 2025-09-07 17:39:54 +08:00
commit 445ac823ba
87 changed files with 19076 additions and 0 deletions
--- a/UNIFIED_TASK_MANAGEMENT.md
+++ b/UNIFIED_TASK_MANAGEMENT.md
@@ -0,0 +1,308 @@
+# 统一任务管理流程
+
+## 架构概述
+
+```
+┌─────────────────────────────────────────────┐
+│           Workflow Layer (宏观)              │
+│  /workflow:init → plan → implement → review  │
+│           workflow-session.json              │
+└────────────────┬────────────────────────────┘
+                 │ 双向同步
+┌────────────────┴────────────────────────────┐
+│            Task Layer (微观)                 │
+│   /task:create → execute → status → sync     │
+│              tasks.json                      │
+└─────────────────────────────────────────────┘
+```
+
+## 核心改进
+
+### 1. 命令体系（精简版）
+**Workflow命令**（11个核心命令）：
+
+**Session管理**：
+- `/workflow:session start` - 初始化并开始会话（含原init功能）
+- `/workflow:session pause` - 暂停当前会话
+- `/workflow:session resume` - 恢复会话
+
+**阶段管理**：
+- `/workflow:plan` - 规划阶段（根据复杂度可选）
+- `/workflow:implement` - 实施阶段（集成simple/medium/complex模式）
+- `/workflow:review` - 评审阶段
+
+**辅助功能**：
+- `/workflow:status` - 统一状态查看（含session状态）
+- `/workflow:sync` - 数据同步
+- `/workflow:context` - 上下文分析
+- `/workflow:issue` - Issue管理
+- `/workflow:replan` - 重新规划
+
+**Task命令**（保持7个核心命令）：
+- `/task:create` - 创建任务
+- `/task:execute` - 执行任务
+- `/task:status` - 查看状态
+- `/task:replan` - 重新规划
+- `/task:sync` - 同步数据
+- `/task:breakdown` - 任务分解
+- `/task:context` - 上下文分析
+
+### 2. JSON管理体系
+
+#### workflow-session.json
+```json
+{
+  "session_id": "WFS-2025-001",
+  "project": "项目名称",
+  "type": "simple|medium|complex",
+  "current_phase": "PLAN|IMPLEMENT|REVIEW",
+  "created": "2025-01-16T10:00:00Z",
+  "phases": {
+    "PLAN": {
+      "status": "pending|active|completed",
+      "output": "PLAN.md"
+    },
+    "IMPLEMENT": {
+      "status": "pending|active|completed",
+      "tasks": ["IMPL-001", "IMPL-002"],
+      "completed_tasks": ["IMPL-001"],
+      "progress": 50
+    },
+    "REVIEW": {
+      "status": "pending|active|completed",
+      "output": "REVIEW.md"
+    }
+  },
+  "context": {
+    "requirements": [],
+    "scope": [],
+    "issues": []
+  }
+}
+```
+
+#### tasks.json
+```json
+{
+  "session_id": "WFS-2025-001",
+  "tasks": {
+    "IMPL-001": {
+      "id": "IMPL-001",
+      "title": "任务标题",
+      "status": "pending|in_progress|completed|blocked",
+      "type": "feature|bugfix|refactor",
+      "agent": "code-developer",
+      "context": {},
+      "created_at": "2025-01-16T12:00:00Z"
+    }
+  },
+  "next_id": 2
+}
+```
+
+### 3. 双向同步机制
+
+#### 自动同步点
+- Task创建 → 更新workflow tasks数组
+- Task完成 → 更新workflow progress
+- Workflow context变更 → 传播到tasks
+- Issue创建 → 关联到相关tasks
+
+#### 同步命令
+- `/workflow:sync` - 全局文档同步
+- `/task:sync` - Task层同步
+
+### 4. 统一执行流程
+
+#### 简单任务流程（Bug修复）
+```bash
+# 初始化并开始
+/workflow:session start simple "修复登录按钮样式"
+→ 创建 workflow-session.json
+→ 设置复杂度: simple
+
+# 直接实施（跳过规划）
+/workflow:implement --type=simple
+→ TodoWrite: 3-4项
+→ Agent: code-developer → code-review-agent
+→ 自动完成
+```
+
+#### 中等复杂度流程（新特性）
+```bash
+# Step 1: 开始会话
+/workflow:session start medium "添加用户资料编辑功能"
+→ 创建 workflow-session.json
+→ 设置复杂度: medium
+
+# Step 2: 轻量规划
+/workflow:plan
+→ 生成简单PLAN.md
+
+# Step 3: 实施
+/workflow:implement --type=medium
+→ TodoWrite: 5-7项
+→ Agent: planning-agent → code-developer → code-review-agent
+
+# Step 4: 暂停/恢复（如需要）
+/workflow:session pause
+/workflow:session resume
+
+# Step 5: 评审
+/workflow:review
+```
+
+#### 复杂系统流程（架构变更）
+```bash
+# Step 1: 开始复杂会话
+/workflow:session start complex "实现OAuth2认证系统"
+→ 创建 workflow-session.json
+→ 设置复杂度: complex
+
+# Step 2: 详细规划
+/workflow:plan
+→ 生成: IMPLEMENTATION_PLAN.md, TASK_DECOMPOSITION.md
+→ 风险评估
+
+# Step 3: 复杂实施
+/workflow:implement --type=complex
+→ TodoWrite: 7-10项
+→ 初始化 tasks.json
+→ 启用 task 命令
+
+# Step 4: 任务管理
+/task:create "设计OAuth2架构"
+/task:breakdown IMPL-001
+/task:execute IMPL-001.1
+/task:status
+
+# Step 5: 监控和同步
+/workflow:status          # 查看整体进度
+/workflow:sync            # 确保数据一致
+/task:sync               # 任务层同步
+
+# Step 6: 处理变更（如需要）
+/workflow:issue create "安全需求变更"
+/workflow:replan
+/task:replan IMPL-003
+
+# Step 7: 评审和完成
+/workflow:review
+/workflow:session complete
+```
+
+## 关键特性
+
+### 1. 智能上下文感知
+- 基于Gemini的智能分析
+- 自动任务推荐
+- 依赖关系检测
+- 冲突预防
+
+### 2. 状态持久化
+- JSON文件持久化所有状态
+- 支持会话恢复
+- 自动备份机制
+- 版本控制友好
+
+### 3. 灵活性
+- 支持简单/中等/复杂三种模式
+- 可跳过规划直接实施
+- 支持任务重规划
+- 支持并行执行
+
+### 4. 一致性保证
+- 双向同步机制
+- 数据完整性验证
+- 冲突自动解决
+- 实时进度计算
+
+## 核心准则引用
+
+所有命令共享以下核心准则（通过@引用）：
+- `session-management-principles.md` - 会话管理
+- `todowrite-coordination-rules.md` - TodoWrite协调
+- `agent-orchestration-patterns.md` - Agent编排
+- `dynamic-change-management.md` - 动态变更
+- `complexity-decision-tree.md` - 复杂度决策
+- `task-decomposition-integration.md` - 任务分解
+- `gemini-intelligent-context.md` - 智能上下文
+
+## 优势总结
+
+1. **清晰分层**：Workflow管理宏观流程，Task处理具体执行
+2. **完整持久化**：所有状态通过JSON文件管理
+3. **自动同步**：双向同步保证数据一致性
+4. **命令精简**：减少认知负担，易于使用
+5. **智能增强**：Gemini驱动的上下文分析
+6. **统一流程**：标准化的项目管理流程
+
+## 快速开始
+
+```bash
+# 简单任务（bug修复）
+/workflow:session start simple "修复登录问题"
+/workflow:implement --type=simple
+# 自动完成
+
+# 中等任务（新特性）
+/workflow:session start medium "用户资料编辑"
+/workflow:plan                      # 轻量规划
+/workflow:implement --type=medium   # 执行实施
+/workflow:review                    # 质量评审
+
+# 复杂项目（系统级）
+/workflow:session start complex "OAuth2集成"
+/workflow:plan                      # 详细规划
+/workflow:implement --type=complex  # 复杂实施
+/task:create "设计OAuth2架构"       # 创建任务
+/task:breakdown IMPL-001            # 任务分解
+/task:execute IMPL-001.1            # 执行子任务
+/workflow:status                    # 查看状态
+/workflow:review                    # 最终评审
+```
+
+## 文件结构
+
+```
+.claude/
+├── commands/
+│   ├── workflow/
+│   │   ├── session.md     # 会话管理(start/pause/resume)
+│   │   ├── plan.md        # 规划阶段
+│   │   ├── implement.md   # 实施阶段(含3种模式)
+│   │   ├── review.md      # 评审阶段
+│   │   ├── status.md      # 统一状态
+│   │   ├── sync.md        # 数据同步
+│   │   ├── context.md     # 上下文分析
+│   │   ├── issue.md       # Issue管理
+│   │   └── replan.md      # 重新规划
+│   └── task/
+│       ├── create.md      # 创建任务
+│       ├── execute.md     # 执行任务
+│       ├── status.md      # 任务状态
+│       ├── replan.md      # 任务重规划
+│       ├── sync.md        # 任务同步
+│       ├── breakdown.md   # 任务分解
+│       └── context.md     # 任务上下文
+├── schemas/
+│   ├── workflow-session.json  # 会话schema
+│   └── task.json              # 任务schema
+└── workflows/
+    ├── session-management-principles.md
+    ├── todowrite-coordination-rules.md
+    ├── agent-orchestration-patterns.md
+    ├── task-decomposition-integration.md
+    ├── complexity-decision-tree.md
+    └── [其他核心准则]
+
+工作目录/
+├── workflow-session.json   # 会话状态
+├── tasks.json             # 任务数据
+├── PLAN.md               # 规划文档(可选)
+├── REVIEW.md             # 评审报告
+└── .workflow/            # 工作目录
+    └── WFS-2025-001/     # 会话工作空间
+```
+
+此统一任务管理流程提供了清晰、高效、智能的项目管理体系。