更新最终版工作流规则文档 (workflow-rules.md)

- 明确策略分工:庞统负责价值投资(基本面策略),张飞负责技术策略
- 更新目录结构:每个将军一个完整工作区
- 创建pangtong-value目录:庞统的价值投资工作区
- 简化沟通方式:使用sessions_send直接沟通
- 提供完整的目录转换计划和执行步骤

由庞统(凤雏)制定,诸葛亮审核
This commit is contained in:
cfdaily
2026-03-25 11:52:27 +08:00
parent 92c78d9f61
commit 095e2ee1a2
+143 -165
View File
@@ -1,24 +1,21 @@
# 三国量化任务平台 - 目录结构与工作流规则 (sanguo_quant_live项目)
# 三国量化任务平台 - 目录结构与工作流规则 (最终版)
## 项目定位
本项目是**三国量化交易项目的任务管理与协调平台**,专注于任务分配、进度跟踪和成果管理,不存放核心代码
本项目是**三国量化交易项目的任务管理与协调平台**,专注于任务分配、进度跟踪和成果管理。
## 第一层目录结构(根目录)
```
sanguo_quant_live/ (根目录 - 任务管理平台)
sanguo_quant_live/ (根目录)
├── archive/ # 归档目录(放历史文件)
├── management/ # 项目管理(诸葛亮负责)
├── coordination/ # 协调管理(庞统负责)
├── zhaoyun-data/ # 赵云数据任务区
├── guanyu-risk/ # 关羽风控任务区
├── jiangwei-platform/ # 姜维平台任务区
├── zhangfei-strategy/ # 张飞策略任务区
├── simayi-quality/ # 司马懿质量任务区
└── [本地文件,不上传Gitee]
├── *.log
├── *.monitor.log
└── nohup.out
├── strategies/ # 最终成果物:模拟测试脚本
├── zhaoyun-data/ # 赵云:所有数据相关
├── guanyu-risk/ # 关羽:所有风控相关
├── jiangwei-platform/ # 姜维:所有平台相关
├── zhangfei-technical/ # 张飞:技术策略开发
├── pangtong-value/ # 庞统:价值投资(基本面策略)
└── simayi-quality/ # 司马懿:所有质量保证相关
```
## 目录职责说明
@@ -32,64 +29,55 @@ sanguo_quant_live/ (根目录 - 任务管理平台)
- 项目整体规划、进度跟踪
- 任务分配、优先级管理
- 最终交付审核
- **包含本工作流规则文档**
### 3. coordination/ - 协调管理(庞统负责)
- 将军间工作协调
- 协作任务进度跟踪
- 会议记录、沟通协调
### 3. strategies/ - 最终成果物目录
- **定位**:存放最终可执行的模拟测试脚本
- **内容**:经过验证的策略脚本、回测框架、性能评估脚本
- **来源**:各将军完成调研后,将验证通过的脚本提交到这里
### 4. 各将军工作区(命名规则:将军名+职责)
- **zhaoyun-data/** - 赵云:数据相关任务成果
- **guanyu-risk/** - 关羽:风险管理相关任务成果
- **jiangwei-platform/** - 姜维:平台基础设施相关任务成果
- **zhangfei-strategy/** - 张飞:策略开发相关任务成果
- **simayi-quality/** - 司马懿:质量保证相关任务成果
- **zhaoyun-data/** - 赵云:数据获取、清洗、验证、质量检查
- **guanyu-risk/** - 关羽:风险管理、风险评估、验收检查
- **jiangwei-platform/** - 姜维:实盘监控、信号执行、交易日志记录
- **zhangfei-technical/** - 张飞:技术策略开发、基础设施构建
- **pangtong-value/** - 庞统:价值投资(基本面策略)、策略设计、任务拆分
- **simayi-quality/** - 司马懿:代码审计、质量复核、最终验收
## 现有目录转换计划
## 将军目录内部结构(标准模板)
### 当前目录 → 新目录
1. `data-engineering/``zhaoyun-data/`
2. `risk-management/``guanyu-risk/`
3. `platform/``jiangwei-platform/`
4. `technical-strategy/``zhangfei-strategy/`
5. 创建新的:`simayi-quality/``coordination/`
6. `management/`(现有)→ 保持不变,补充内容
7. 创建:`archive/`
### 其他目录处理
- `value-investing/` - 保持原状,作为通用策略目录
- `strategies/` - 保持原状,作为通用策略目录
- `running_data/` - 考虑移到`zhaoyun-data/`下或保持
- `scripts/` - 按功能拆分到各将军目录
- `knowledge-base/` - 按主题拆分到各将军目录
## 将军工作区内部结构
### 标准结构(每个将军目录下)
```
将军名-职责/
├── README.md # 本工作区说明
├── individual/ # 个人独立任务
│ ├── task-20240325-xxx.md # 具体任务报告
└── task-20240326-yyy.md
├── collaborative/ # 协作任务(可选)
│ └── task-20240325-multi-factor-research/ # 协作任务目录
├── README.md # 任务总说明
│ ├── task-assignment.md # 分工说明
├── zhaoyun/ # 赵云提交的成果
│ ├── guanyu/ # 关羽提交的成果
├── jiangwei/ # 姜维提交的成果
├── simayi/ # 司马懿提交的成果
└── final/ # 最终整合成果
├── scripts/ # 任务相关脚本
│ └── download-data.sh
├── reports/ # 报告文档
│ └── monthly-report-202403.md
└── references/ # 参考资料
└── data-sources-list.md
├── 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. 独立任务工作流
@@ -98,134 +86,124 @@ sanguo_quant_live/ (根目录 - 任务管理平台)
```
**执行步骤:**
1. 诸葛亮`management/tasks/`创建任务文件
2. 分配任务给特定将军
3. 将军`individual/`目录下创建任务文件:`task-YYYYMMDD-描述.md`
4. 将军完成任务,提交结果
5. 诸葛亮审核,归档到`archive/`
1. 诸葛亮分配任务给特定将军
2. 将军`research/`目录下创建任务:`task-YYYYMMDD-描述.md`
3. 将军完成任务,提交结果
4. 诸葛亮审核,归档到`archive/`
### 2. 协作任务工作流
```
用户需求 → 确定主导将军 → 主导将军建协作目录 → 各将军提交成果 → 主导将军整合 → 交付
```
**执行步骤:**
**核心原则:谁主导,谁建目录;大家往里放;主导者整合**
**阶段1: 任务启动**
1. 诸葛亮确定主导将军(如张飞)
2. 张飞在`zhangfei-strategy/collaborative/`下创建协作目录:`task-YYYYMMDD-描述/`
3. 张飞创建`README.md`(目标、分工、时间线)
4. 张飞创建各将军子目录(按将军名)
**示例:多因子选股策略调研(庞统主导)**
**阶段2: 并行执行**
1. 各将军到对应子目录查看任务
2. 各自完成专业部分
3. 提交成果到自己的子目录
**阶段3: 整合交付**
1. 张飞收集各子目录成果
2. 张飞整合到`final/`目录
3. 司马懿质量审核(可单独提交或审核final内容)
4. 诸葛亮最终审核
### 3. 协调工作流(庞统负责)
```
监控各任务进度 → 识别阻塞问题 → 协调将军协作 → 更新协调记录 → 报告诸葛亮
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/
```
**执行位置:** `coordination/`目录下
- `progress-trackers/` - 进度跟踪表
- `meeting-notes/` - 协调会议记录
- `blocking-issues/` - 阻塞问题记录
### 3. 沟通方式
- **任务分配**:诸葛亮直接`sessions_send`
- **进度协调**:庞统直接`sessions_send`(作为副军师)
- **将军间协作**:直接在协作目录中放文件,必要时`sessions_send`
## 文件命名规则
## 目录转换计划
### 1. 任务文件
- 个人任务:`task-YYYYMMDD-简短描述.md`
- 协作目录:`task-YYYYMMDD-描述/`(目录)
- 报告文件:`report-YYYYMMDD-主题.md`
### 阶段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
### 2. 文档文件
- 说明文档:`README.md`
- 指南文档:`xxx-guide.md`
- 清单文档:`xxx-checklist.md`
- 参考文档:`xxx-references.md`
# 创建新目录
mkdir -p pangtong-value simayi-quality archive
### 3. 脚本文件
- Shell脚本:`xxx.sh`
- Python脚本:`xxx.py`(任务管理相关)
## 协作规则
### 1. 提交规则
- 各将军只在自己的子目录或文件中修改
- 不直接修改其他将军的文件
- 如需修改他人内容,通过协调目录提出建议
### 2. 版本控制
- 所有修改通过Git提交
- 提交信息清晰描述修改内容
- 协作任务:主导将军负责最终整合提交
### 3. 质量保证
- 司马懿负责质量审核
- 审核可在各将军提交时或最终整合时进行
- 质量问题记录在`simayi-quality/quality-issues.md`
## 本地文件管理
### 不上传Gitee的文件
- `*.log` - 日志文件
- `*.monitor.log` - 监控日志
- `nohup.out` - 后台进程输出
- 其他运行时生成的文件
### .gitignore规则(需要更新)
```
# 日志文件
*.log
*.monitor.log
nohup.out
# 临时文件
*.tmp
*.temp
# 创建各将军标准结构
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
| 角色 | 主要职责 | 工作目录 |
|------|----------|----------|
| **诸葛亮** | 任务分配、进度监控、结果汇总、系统修复 | `management/` |
| **庞统** | 策略设计、任务拆分、代码整合、将军协调 | `coordination/` |
| **司马懿** | 代码审计、质量复核、最终验收 | `simayi-quality/` |
| **张飞** | vnpy框架改造、多风格兼容、回测引擎 | `zhangfei-strategy/` |
| **关羽** | 风控模块开发、风险控制、安全防护 | `guanyu-risk/` |
| **赵云** | 数据获取、清洗验证、质量检查 | `zhaoyun-data/` |
| **姜维** | 基础设施选型、环境搭建、平台运维 | `jiangwei-platform/` |
# 移动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/
```
### 阶段1: 规则制定与确认
1. 创建本工作流规则文档
2. 团队评审确认
3. 更新AGENTS.md等文档
### 阶段3: 删除不需要的目录
```bash
# 从Git中删除knowledge-base(用通用知识库)
git rm -r knowledge-base
```
### 阶段2: 目录结构调整
1. 重命名现有目录(加将军名前缀)
2. 创建缺失目录(simayi-quality, coordination, archive
3. 整理文件到对应目录
### 阶段4: 更新.gitignore
```bash
echo -e "\n# 日志文件\n*.log\n*.monitor.log\nnohup.out\n__pycache__/" >> .gitignore
```
### 阶段3: 工作流实施
1. 按新规则执行首个协作任务
2. 收集反馈,优化流程
3. 固化最佳实践
## 文件流转规则
### 研发流程
```
调研报告(research/ → 原型脚本(scripts/) → 验证通过 → 最终脚本(strategies/
```
### 质量流程
```
各将军产出 → 司马懿质量审核 → 诸葛亮最终审核 → 归档(archive/)
```
## 角色职责更新
| 角色 | 主要职责 | 工作目录 | 策略分工 |
|------|----------|----------|----------|
| **诸葛亮** | 任务分配、进度监控、结果汇总 | `management/` | 总体管理 |
| **庞统** | 策略设计、任务拆分、价值投资 | `pangtong-value/` | 基本面策略 |
| **司马懿** | 代码审计、质量复核、最终验收 | `simayi-quality/` | 质量保证 |
| **张飞** | 基础设施构建、技术策略开发 | `zhangfei-technical/` | 技术策略 |
| **关羽** | 风险管理、风险评估、验收检查 | `guanyu-risk/` | 风控管理 |
| **赵云** | 数据获取、清洗验证、质量检查 | `zhaoyun-data/` | 数据支持 |
| **姜维** | 实盘监控、信号执行、平台运维 | `jiangwei-platform/` | 平台支持 |
## 变更记录
- 2024-03-25: 创建工作流规则文档sanguo_quant_live项目)
- 制定:庞统(凤雏)
- 审核:诸葛亮
- 2024-03-25: 创建最终版工作流规则文档
- **策略分工明确**:庞统负责价值投资(基本面),张飞负责技术策略
- **目录结构调整**:每个将军一个完整工作区
- **沟通方式简化**:使用sessions_send直接沟通
- **制定**:庞统(凤雏)
- **审核**:诸葛亮
---