Files
sanguo_quant_live/management/workflow-rules.md
T
cfdaily e462901952 更新工作流规则:简化归档流程,添加公共知识库规则
- 删除目录转换计划,简化文档
- 简化归档流程:归档由诸葛亮决定
- 添加公共知识库规则:统一知识库,基础数据与分析结果分离
- 明确知识库使用原则:只存基础数据,个人分析结果放在各自目录
- 禁止污染知识库,不同分析角度各自保存结果

由庞统(凤雏)制定,诸葛亮审核
2026-03-25 11:59:44 +08:00

194 lines
7.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 三国量化任务平台 - 目录结构与工作流规则 (最终版)
## 项目定位
本项目是**三国量化交易项目的任务管理与协调平台**,专注于任务分配、进度跟踪和成果管理。
## 第一层目录结构(根目录)
```
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. 诸葛亮审核(归档由诸葛亮决定)
### 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. 知识库定位
- **统一的知识库**:所有将军使用同一个公共知识库
- **基础数据存放**:存放原始数据、基础资料、标准定义
- **分析结果分离**:个人分析结果放在自己的工作目录下
### 2. 使用原则
```
公共知识库(只存基础数据)
├── raw-data/ # 原始数据
├── basic-concepts/ # 基础概念定义
├── standards/ # 标准和规范
└── references/ # 参考资料
个人工作区(存分析结果)
├── research/ # 调研报告(基于知识库数据)
├── analysis-results/ # 分析结果(个人视角)
└── scripts/ # 分析脚本(使用知识库数据)
```
### 3. 禁止行为
- ❌ 不要将个人分析结果存入公共知识库
- ❌ 不要修改他人已确认的基础数据
- ❌ 不要在知识库中存放临时文件
- ❌ 不要污染知识库结构
### 4. 正确做法
- ✅ 从知识库获取基础数据进行分析
- ✅ 将分析结果保存在自己目录的`reports/``analysis/`
- ✅ 如需更新知识库数据,提交审核后统一更新
- ✅ 不同分析角度产生不同结果,各自保存
## 文件流转规则
### 研发流程
```
调研报告(research/ → 原型脚本(scripts/) → 验证通过 → 最终脚本(strategies/
```
### 质量流程
```
各将军产出 → 司马懿质量审核 → 诸葛亮最终审核 → (归档由诸葛亮决定)
```
## 角色职责更新
| 角色 | 主要职责 | 工作目录 | 策略分工 |
|------|----------|----------|----------|
| **诸葛亮** | 任务分配、进度监控、结果汇总 | `management/` | 总体管理 |
| **庞统** | 策略设计、任务拆分、价值投资 | `pangtong-value/` | 基本面策略 |
| **司马懿** | 代码审计、质量复核、最终验收 | `simayi-quality/` | 质量保证 |
| **张飞** | 基础设施构建、技术策略开发 | `zhangfei-technical/` | 技术策略 |
| **关羽** | 风险管理、风险评估、验收检查 | `guanyu-risk/` | 风控管理 |
| **赵云** | 数据获取、清洗验证、质量检查 | `zhaoyun-data/` | 数据支持 |
| **姜维** | 实盘监控、信号执行、平台运维 | `jiangwei-platform/` | 平台支持 |
## 变更记录
- 2024-03-25: 创建最终版工作流规则文档
- **策略分工明确**:庞统负责价值投资(基本面),张飞负责技术策略
- **目录结构调整**:每个将军一个完整工作区
- **沟通方式简化**:使用sessions_send直接沟通
- **制定**:庞统(凤雏)
- **审核**:诸葛亮
---
*"卧龙风雏,得一可安天下" - 蜀汉量化任务平台工作流*