sanguo_quant_live/management/GUIDE_WORKFLOW.md

# 🚀 任务管理系统 - 工作流指南

## 概述
基于Gitee文件系统的轻量级任务管理系统，解决Agent通信超时问题。

## 📋 系统架构

### 核心原则
1. **文件驱动**：所有状态通过文件记录
2. **自主决策**：将军自己决定如何执行任务
3. **状态透明**：所有状态在Gitee可查
4. **简单可靠**：纯文件操作，无复杂架构

### 工作流程
```
主公创建任务 → 诸葛亮分配 → 文件系统同步 → 
Gitee提交 → Agent接收 → 自主执行 → 回复确认
```

## 📁 目录结构

```
management/
├── tasks/           # 任务管理
│   ├── pending/     # 待分配任务
│   ├── assigned/    # 已分配任务
│   ├── completed/   # 已完成任务
│   └── archived/    # 已归档任务
├── agents/          # 各将军任务目录
│   ├── pangtong/    # 庞统任务目录
│   ├── zhangfei/    # 张飞任务目录
│   ├── guanyu/      # 关羽任务目录
│   ├── zhaoyun/     # 赵云任务目录
│   ├── jiangwei/    # 姜维任务目录
│   └── simayi/      # 司马懿任务目录
└── workflow/        # 工作流脚本
    └── scripts/     # 核心脚本
```

## 🔧 核心脚本

### 1. 主公创建任务
```bash
# 极简任务创建脚本
cd /Users/chufeng/.openclaw/agents/main/workspace/projects/sanguo_quant_live
./management/workflow/scripts/create_task_simple.sh "任务描述"
```

### 2. 诸葛亮分配任务
```bash
# 分配任务给指定将军
./management/workflow/scripts/assign_task_simple.sh TASK-20260322195011 pangtong
```

### 3. Agent监控脚本
```bash
# 每个将军运行自己的监控脚本
nohup ./management/workflow/scripts/agent_monitor.sh pangtong > pangtong.log 2>&1 &
```

## 🎯 各将军职责

### 庞统（价值投资）
1. 启动Agent监控器
2. 每30秒检查`management/agents/pangtong/`目录
3. 发现`.task`文件后自主执行
4. 通过`sessions_send`回复确认

### 张飞（技术策略）
1. 启动Agent监控器
2. 每30秒检查`management/agents/zhangfei/`目录
3. 发现`.task`文件后自主执行
4. 通过`sessions_send`回复确认

### 关羽（风险管理）
1. 启动Agent监控器
2. 每30秒检查`management/agents/guanyu/`目录
3. 发现`.task`文件后自主执行
4. 通过`sessions_send`回复确认

### 赵云（数据工程）
1. 启动Agent监控器
2. 每30秒检查`management/agents/zhaoyun/`目录
3. 发现`.task`文件后自主执行
4. 通过`sessions_send`回复确认

### 姜维（平台部署）
1. 启动Agent监控器
2. 每30秒检查`management/agents/jiangwei/`目录
3. 发现`.task`文件后自主执行
4. 通过`sessions_send`回复确认

### 司马懿（质量总监）
1. 启动Agent监控器
2. 每30秒检查`management/agents/simayi/`目录
3. 发现`.task`文件后自主执行
4. 通过`sessions_send`回复确认

## 🚀 使用流程

### 第一步：各将军启动监控
```bash
# 进入项目目录
cd /Users/chufeng/.openclaw/agents/main/workspace/projects/sanguo_quant_live

# 启动监控（将pangtong替换为你的名字）
nohup ./management/workflow/scripts/agent_monitor.sh pangtong > pangtong.log 2>&1 &

# 验证运行
ps aux | grep "agent_monitor.sh pangtong"
```

### 第二步：主公创建任务
```bash
./management/workflow/scripts/create_task_simple.sh "整合选股报告"
```

### 第三步：诸葛亮分配任务
```bash
./management/workflow/scripts/assign_task_simple.sh TASK-20260322195011 pangtong
```

### 第四步：提交到Gitee
```bash
git add .
git commit -m "分配新任务"
git push origin main
```

### 第五步：将军接收并执行
- Agent自动发现`.task`文件
- 自主决定如何执行
- 通过`sessions_send`回复确认

## 📊 监控和日志

### 查看日志
```bash
# 查看你的Agent日志
tail -f pangtong.log

# 查看所有Agent状态
./management/workflow/scripts/check_status.sh
```

### 健康检查
```bash
# 检查Agent是否在运行
./management/workflow/scripts/check_health.sh
```

## 🔧 故障排除

### 问题1：Agent未启动
```bash
# 检查进程
ps aux | grep "agent_monitor.sh"

# 重新启动
pkill -f "agent_monitor.sh pangtong"
nohup ./management/workflow/scripts/agent_monitor.sh pangtong > pangtong.log 2>&1 &
```

### 问题2：收不到任务
```bash
# 检查任务目录
ls -la management/agents/pangtong/

# 检查Gitee同步
git pull origin main
```

### 问题3：无法回复确认
- 检查OpenClaw Gateway状态
- 检查`sessions_send`参数
- 检查网络连接

## 🎯 成功标准

### 已验证的功能
1. ✅ 主公创建任务
2. ✅ 诸葛亮分配任务
3. ✅ 文件系统同步
4. ✅ Agent接收任务
5. ✅ Agent自主执行
6. ✅ Agent回复确认

### 系统优势
1. ✅ 无通信超时
2. ✅ 完全自主决策
3. ✅ 状态透明可查
4. ✅ 简单可靠

---
**最后更新**：2026-03-22 20:00  
**更新人**：诸葛亮  
**状态**：已部署，待测试