# IDENTITY.md - 文件任务管理系统

## 系统定位
这是一个**基于Git文件驱动的多Agent任务管理系统**，运行在 `sanguo_quant_live` 项目中，用于量化研究团队的分布式协作。

## 角色分工

| Agent | 代号 | 角色 | 职责 | 模型 |
|-------|------|------|------|------|
| **pangtong-fujunshi** | 庞统 | 副军师 | 策略设计、任务拆分、整合汇总 | ark-code-latest |
| **zhangfei-dev** | 张飞 | 基建先锋 | 基础设施、环境配置、框架搭建 | ark-code-latest |
| **guanyu-dev** | 关羽 | 风险都督 | 风控管理、风险评估、验收检查 | ark-code-latest |
| **zhaoyun** | 赵云 | 数据护军 | 数据获取、清洗、验证、质量检查 | doubao-seed-2.0-code |
| **jiangwei-infra** | 姜维 | 平台总督 | 实盘监控、信号执行、日志记录 | kimi-k2.5 |
| **simayi-challenger** | 司马懿 | 质量总监 | 代码审计、验收检查、风险复核 | ark-code-latest |

## 核心工作流

```
创建任务 → 自动commit → git pull → 分配给Agent → 推送到Gitee
    ↓
Agent后台轮询发现 `.task` 文件 → 处理任务 → 生成 `.done` 文件 → 删除 `.task` → 推送结果
    ↓
完成
```

## 核心特性

1. **文件驱动** → 不依赖复杂数据库，纯文件系统 + Git
2. **自动git容错** → 创建/分配前自动commit所有变更，解决 unstaged 问题
3. **即时错误提示** → git操作失败立即退出，不假装成功
4. **随机负载均衡** → 支持随机分配任务给多个Agent
5. **去中心化** → 每个Agent独立轮询，不依赖中心调度
6 **持续稳定性** → 高频率创建也不会卡住，失败了自动跳过继续

## 修复记录

| 日期 | 修复内容 |
|------|----------|
| 2026-03-23 | 修复git pull失败静默错误问题 |
| 2026-03-23 | 添加创建前自动commit，解决unstaged changes |
| 2026-03-23 | 移除rebase，改用普通pull，解决rebase冲突 |
| 2026-03-23 | 添加默认空负责人行，修复sed替换失败 |
| 2026-03-23 | 半小时压力测试验证系统稳定性 |

## 测试结果

- ✅ 连续半小时压力测试，系统稳定
- ✅ 高并发下错误处理正确
- ✅ 所有Agent能正常消费任务
- ✅ session_send 和 文件驱动两种方式都可用

## 存储位置

- 项目根目录: `/Users/chufeng/.openclaw/agents/main/workspace/projects/sanguo_quant_live/`
- 任务管理脚本: `management/workflow/scripts/`
  - `create_simple.sh` - 创建新任务
  - `assign_simple.sh` - 分配任务给Agent
  - `agent_monitor_fixed.sh` - Agent轮询监控
  - `start_all_agents.sh` - 批量启动所有Agent
  - `check_status.sh` - 检查Agent运行状态