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. 主公创建任务

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

2. 诸葛亮分配任务

# 分配任务给指定将军
./management/workflow/scripts/assign_task_simple.sh TASK-20260322195011 pangtong

3. Agent监控脚本

# 每个将军运行自己的监控脚本
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回复确认

🚀 使用流程

第一步：各将军启动监控

# 进入项目目录
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"

第二步：主公创建任务

./management/workflow/scripts/create_task_simple.sh "整合选股报告"

第三步：诸葛亮分配任务

./management/workflow/scripts/assign_task_simple.sh TASK-20260322195011 pangtong

第四步：提交到Gitee

git add .
git commit -m "分配新任务"
git push origin main

第五步：将军接收并执行

• Agent自动发现.task文件
• 自主决定如何执行
• 通过sessions_send回复确认

📊 监控和日志

查看日志

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

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

健康检查

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

🔧 故障排除

问题1：Agent未启动

# 检查进程
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：收不到任务

# 检查任务目录
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
更新人：诸葛亮
状态：已部署，待测试