sanguo_quant_live/management/workflow-rules.md

# 三国量化任务平台 - 目录结构与工作流规则 (最终版)

## 项目定位
本项目是**三国量化交易项目的任务管理与协调平台**，专注于任务分配、进度跟踪和成果管理。

## 第一层目录结构（根目录）

```
sanguo_quant_live/  (根目录)
├── archive/                    # 归档目录（放历史文件）
├── management/                 # 项目管理（诸葛亮负责）
├── strategies/                 # 最终成果物：模拟测试脚本
├── zhaoyun-data/              # 赵云：所有数据相关
├── guanyu-risk/               # 关羽：所有风控相关  
├── jiangwei-platform/         # 姜维：所有平台相关
├── zhangfei-technical/        # 张飞：技术策略开发
├── pangtong-value/            # 庞统：价值投资（基本面策略）
└── simayi-quality/            # 司马懿：所有质量保证相关
```

## 目录职责说明

### 1. archive/ - 归档目录
- 存放历史文件、过时文档
- 按日期或主题分类归档
- 保持仓库整洁，不删除历史

### 2. management/ - 项目管理（诸葛亮负责）
- 项目整体规划、进度跟踪
- 任务分配、优先级管理
- 最终交付审核

### 3. strategies/ - 最终成果物目录
- **定位**：存放最终可执行的模拟测试脚本
- **内容**：经过验证的策略脚本、回测框架、性能评估脚本
- **来源**：各将军完成调研后，将验证通过的脚本提交到这里

### 4. 各将军工作区（命名规则：将军名+职责）
- **zhaoyun-data/** - 赵云：数据获取、清洗、验证、质量检查
- **guanyu-risk/** - 关羽：风险管理、风险评估、验收检查  
- **jiangwei-platform/** - 姜维：实盘监控、信号执行、交易日志记录
- **zhangfei-technical/** - 张飞：技术策略开发、基础设施构建
- **pangtong-value/** - 庞统：价值投资（基本面策略）、策略设计、任务拆分
- **simayi-quality/** - 司马懿：代码审计、质量复核、最终验收

## 将军目录内部结构（标准模板）

```
将军名-职责/
├── README.md                  # 本工作区说明
├── research/                  # 调研报告目录
│   ├── task-YYYYMMDD-描述/   # 具体调研任务
│   │   ├── README.md         # 任务说明
│   │   ├── 其他将军子目录/   # 协作任务用
│   │   └── final/            # 最终整合报告
│   └── [专项调研目录]        # 如：value-investing/, multi-factor/
├── scripts/                   # 本将军的脚本
│   └── [按功能分类子目录]
├── data/                      # 本将军的数据（主要赵云）
│   ├── raw/                  # 原始数据
│   ├── processed/            # 处理后的数据
│   └── running_data/         # 运行数据
├── reports/                   # 报告文档
└── references/                # 参考资料链接（链接到通用知识库）
```

## 策略分工明确

### 1. 庞统 (pangtong-value) - 基本面策略
- **负责**：价值投资策略
- **范围**：基本面分析、财务指标、估值模型
- **来源**：原`value-investing/`目录内容
- **输出**：价值投资策略脚本，提交到`strategies/`

### 2. 张飞 (zhangfei-technical) - 技术策略
- **负责**：技术分析策略
- **范围**：技术指标、图表分析、量化信号
- **来源**：原`technical-strategy/`目录内容
- **输出**：技术策略脚本，提交到`strategies/`

## 工作流规则

### 1. 独立任务工作流
```
用户需求 → 诸葛亮拆解 → 分配单一将军 → 将军在自己目录完成 → 提交结果 → 诸葛亮审核 → 交付
```

**执行步骤：**
1. 诸葛亮分配任务给特定将军
2. 将军在`research/`目录下创建任务：`task-YYYYMMDD-描述.md`
3. 将军完成任务，提交结果
4. 诸葛亮审核，归档到`archive/`

### 2. 协作任务工作流
```
用户需求 → 确定主导将军 → 主导将军建协作目录 → 各将军提交成果 → 主导将军整合 → 交付
```

**核心原则：谁主导，谁建目录；大家往里放；主导者整合**

**示例：多因子选股策略调研（庞统主导）**

```
pangtong-value/research/multi-factor-20240325/  # 庞统创建
├── README.md                    # 庞统写：目标、分工、时间线
├── zhaoyun/                    # 赵云提交数据源调研
│   └── data-sources-report.md
├── guanyu/                     # 关羽提交风险分析
│   └── risk-assessment.md
├── jiangwei/                   # 姜维提交平台需求
│   └── platform-requirements.md
├── zhangfei/                   # 张飞提交技术实现
│   └── technical-implementation.md
├── simayi/                     # 司马懿提交质量审核
│   └── quality-review.md
└── final/                      # 庞统整合
    ├── multi-factor-research-report.md
    └── strategy-prototype.py   # 原型脚本，完成后移到strategies/
```

### 3. 沟通方式
- **任务分配**：诸葛亮直接`sessions_send`
- **进度协调**：庞统直接`sessions_send`（作为副军师）
- **将军间协作**：直接在协作目录中放文件，必要时`sessions_send`

## 目录转换计划

### 阶段1: 重命名和创建目录
```bash
# 重命名现有目录
git mv data-engineering zhaoyun-data
git mv risk-management guanyu-risk
git mv platform jiangwei-platform
git mv technical-strategy zhangfei-technical

# 创建新目录
mkdir -p pangtong-value simayi-quality archive

# 创建各将军标准结构
mkdir -p zhaoyun-data/{research,scripts,data,reports,references}
mkdir -p guanyu-risk/{research,scripts,reports,references}
mkdir -p jiangwei-platform/{research,scripts,reports,references}
mkdir -p zhangfei-technical/{research,scripts,reports,references}
mkdir -p pangtong-value/{research,scripts,reports,references}
mkdir -p simayi-quality/{research,scripts,reports,references}
```

### 阶段2: 移动现有内容
```bash
# 移动value-investing到庞统目录
git mv value-investing pangtong-value/research/value-investing

# 移动running_data到赵云目录
git mv running_data zhaoyun-data/data/running_data

# 拆分scripts到各将军目录（按功能人工分类）
# 数据相关脚本 → zhaoyun-data/scripts/
# 风险相关脚本 → guanyu-risk/scripts/
# 平台相关脚本 → jiangwei-platform/scripts/
# 技术策略脚本 → zhangfei-technical/scripts/
# 价值投资脚本 → pangtong-value/scripts/
```

### 阶段3: 删除不需要的目录
```bash
# 从Git中删除knowledge-base（用通用知识库）
git rm -r knowledge-base
```

### 阶段4: 更新.gitignore
```bash
echo -e "\n# 日志文件\n*.log\n*.monitor.log\nnohup.out\n__pycache__/" >> .gitignore
```

## 文件流转规则

### 研发流程
```
调研报告（research/） → 原型脚本（scripts/） → 验证通过 → 最终脚本（strategies/）
```

### 质量流程
```
各将军产出 → 司马懿质量审核 → 诸葛亮最终审核 → 归档（archive/）
```

## 角色职责更新

| 角色 | 主要职责 | 工作目录 | 策略分工 |
|------|----------|----------|----------|
| **诸葛亮** | 任务分配、进度监控、结果汇总 | `management/` | 总体管理 |
| **庞统** | 策略设计、任务拆分、价值投资 | `pangtong-value/` | 基本面策略 |
| **司马懿** | 代码审计、质量复核、最终验收 | `simayi-quality/` | 质量保证 |
| **张飞** | 基础设施构建、技术策略开发 | `zhangfei-technical/` | 技术策略 |
| **关羽** | 风险管理、风险评估、验收检查 | `guanyu-risk/` | 风控管理 |
| **赵云** | 数据获取、清洗验证、质量检查 | `zhaoyun-data/` | 数据支持 |
| **姜维** | 实盘监控、信号执行、平台运维 | `jiangwei-platform/` | 平台支持 |

## 变更记录

- 2024-03-25: 创建最终版工作流规则文档
- **策略分工明确**：庞统负责价值投资（基本面），张飞负责技术策略
- **目录结构调整**：每个将军一个完整工作区
- **沟通方式简化**：使用sessions_send直接沟通
- **制定**：庞统（凤雏）
- **审核**：诸葛亮

---

*"卧龙风雏，得一可安天下" - 蜀汉量化任务平台工作流*