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

- 明确策略分工：庞统负责价值投资（基本面策略），张飞负责技术策略 - 更新目录结构：每个将军一个完整工作区 - 创建pangtong-value目录：庞统的价值投资工作区 - 简化沟通方式：使用sessions_send直接沟通 - 提供完整的目录转换计划和执行步骤由庞统（凤雏）制定，诸葛亮审核
2026-03-25 11:52:27 +08:00
parent 92c78d9f61
commit 095e2ee1a2
1 changed files with 143 additions and 165 deletions
@@ -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直接沟通
+- **制定**：庞统（凤雏）
+- **审核**：诸葛亮

 ---