From 095e2ee1a2275fb268d88bc0a214f050db7a2a61 Mon Sep 17 00:00:00 2001 From: cfdaily Date: Wed, 25 Mar 2026 11:52:27 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=9C=80=E7=BB=88=E7=89=88?= =?UTF-8?q?=E5=B7=A5=E4=BD=9C=E6=B5=81=E8=A7=84=E5=88=99=E6=96=87=E6=A1=A3?= =?UTF-8?q?=20(workflow-rules.md)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 明确策略分工：庞统负责价值投资（基本面策略），张飞负责技术策略 - 更新目录结构：每个将军一个完整工作区 - 创建pangtong-value目录：庞统的价值投资工作区 - 简化沟通方式：使用sessions_send直接沟通 - 提供完整的目录转换计划和执行步骤 由庞统（凤雏）制定，诸葛亮审核 --- management/workflow-rules.md | 308 ++++++++++++++++------------------- 1 file changed, 143 insertions(+), 165 deletions(-) diff --git a/management/workflow-rules.md b/management/workflow-rules.md index 79bf831df..a42c2d21a 100644 --- a/management/workflow-rules.md +++ b/management/workflow-rules.md @@ -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直接沟通 +- **制定**：庞统（凤雏） +- **审核**：诸葛亮 ---