catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-04 01:40:45 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
445ac823ba8b7fb495b709c4294a1c14e7c25a1c
Claude-Code-Workflow/UNIFIED_TASK_MANAGEMENT.md
catlog22 445ac823ba 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>
2025-09-07 17:39:54 +08:00

8.9 KiB
Raw Blame History

统一任务管理流程

架构概述

┌─────────────────────────────────────────────┐
│           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

{
  "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

{
  "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修复）

# 初始化并开始
/workflow:session start simple "修复登录按钮样式"
→ 创建 workflow-session.json
→ 设置复杂度: simple

# 直接实施（跳过规划）
/workflow:implement --type=simple
→ TodoWrite: 3-4项
→ Agent: code-developer → code-review-agent
→ 自动完成

中等复杂度流程（新特性）

# 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

复杂系统流程（架构变更）

# 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. 统一流程：标准化的项目管理流程

快速开始

# 简单任务（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/     # 会话工作空间

此统一任务管理流程提供了清晰、高效、智能的项目管理体系。

Reference in New Issue View Git Blame Copy Permalink