mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
445ac823ba
🚀 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>
308 lines
8.9 KiB
Markdown
308 lines
8.9 KiB
Markdown
# 统一任务管理流程
|
||
|
||
## 架构概述
|
||
|
||
```
|
||
┌─────────────────────────────────────────────┐
|
||
│ 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/ # 会话工作空间
|
||
```
|
||
|
||
此统一任务管理流程提供了清晰、高效、智能的项目管理体系。 |