cfdaily
92c78d9f61
- 定义sanguo_quant_live项目定位：任务管理与协调平台 - 制定第一层目录结构：archive/ management/ coordination/ 及各将军工作区 - 规范工作流规则：独立任务和协作任务流程 - 明确角色职责和文件命名规则 - 创建协作任务标准流程：谁主导谁建目录，大家往里放，主导者整合 - 提供现有目录转换计划和实施步骤 由庞统（凤雏）制定，诸葛亮审核
7.7 KiB
7.7 KiB
三国量化任务平台 - 目录结构与工作流规则 (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
目录职责说明
1. archive/ - 归档目录
- 存放历史文件、过时文档
- 按日期或主题分类归档
- 保持仓库整洁，不删除历史
2. management/ - 项目管理（诸葛亮负责）
- 项目整体规划、进度跟踪
- 任务分配、优先级管理
- 最终交付审核
- 包含本工作流规则文档
3. coordination/ - 协调管理（庞统负责）
- 将军间工作协调
- 协作任务进度跟踪
- 会议记录、沟通协调
4. 各将军工作区（命名规则：将军名+职责）
- zhaoyun-data/ - 赵云：数据相关任务成果
- guanyu-risk/ - 关羽：风险管理相关任务成果
- jiangwei-platform/ - 姜维：平台基础设施相关任务成果
- zhangfei-strategy/ - 张飞：策略开发相关任务成果
- simayi-quality/ - 司马懿：质量保证相关任务成果
现有目录转换计划
当前目录 → 新目录
data-engineering/→zhaoyun-data/risk-management/→guanyu-risk/platform/→jiangwei-platform/technical-strategy/→zhangfei-strategy/- 创建新的：
simayi-quality/、coordination/ management/（现有）→ 保持不变，补充内容- 创建：
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
工作流规则
1. 独立任务工作流
用户需求 → 诸葛亮拆解 → 分配单一将军 → 将军在自己目录完成 → 提交结果 → 诸葛亮审核 → 交付
执行步骤：
- 诸葛亮在
management/tasks/创建任务文件 - 分配任务给特定将军
- 将军在
individual/目录下创建任务文件：task-YYYYMMDD-描述.md - 将军完成任务，提交结果
- 诸葛亮审核，归档到
archive/
2. 协作任务工作流
用户需求 → 确定主导将军 → 主导将军建协作目录 → 各将军提交成果 → 主导将军整合 → 交付
执行步骤：
阶段1: 任务启动
- 诸葛亮确定主导将军（如张飞）
- 张飞在
zhangfei-strategy/collaborative/下创建协作目录：task-YYYYMMDD-描述/ - 张飞创建
README.md（目标、分工、时间线） - 张飞创建各将军子目录（按将军名）
阶段2: 并行执行
- 各将军到对应子目录查看任务
- 各自完成专业部分
- 提交成果到自己的子目录
阶段3: 整合交付
- 张飞收集各子目录成果
- 张飞整合到
final/目录 - 司马懿质量审核（可单独提交或审核final内容）
- 诸葛亮最终审核
3. 协调工作流（庞统负责）
监控各任务进度 → 识别阻塞问题 → 协调将军协作 → 更新协调记录 → 报告诸葛亮
执行位置： coordination/目录下
progress-trackers/- 进度跟踪表meeting-notes/- 协调会议记录blocking-issues/- 阻塞问题记录
文件命名规则
1. 任务文件
- 个人任务：
task-YYYYMMDD-简短描述.md - 协作目录：
task-YYYYMMDD-描述/（目录） - 报告文件：
report-YYYYMMDD-主题.md
2. 文档文件
- 说明文档：
README.md - 指南文档：
xxx-guide.md - 清单文档：
xxx-checklist.md - 参考文档：
xxx-references.md
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
角色职责表
| 角色 | 主要职责 | 工作目录 |
|---|---|---|
| 诸葛亮 | 任务分配、进度监控、结果汇总、系统修复 | management/ |
| 庞统 | 策略设计、任务拆分、代码整合、将军协调 | coordination/ |
| 司马懿 | 代码审计、质量复核、最终验收 | simayi-quality/ |
| 张飞 | vnpy框架改造、多风格兼容、回测引擎 | zhangfei-strategy/ |
| 关羽 | 风控模块开发、风险控制、安全防护 | guanyu-risk/ |
| 赵云 | 数据获取、清洗验证、质量检查 | zhaoyun-data/ |
| 姜维 | 基础设施选型、环境搭建、平台运维 | jiangwei-platform/ |
实施计划
阶段1: 规则制定与确认
- 创建本工作流规则文档
- 团队评审确认
- 更新AGENTS.md等文档
阶段2: 目录结构调整
- 重命名现有目录（加将军名前缀）
- 创建缺失目录（simayi-quality, coordination, archive）
- 整理文件到对应目录
阶段3: 工作流实施
- 按新规则执行首个协作任务
- 收集反馈，优化流程
- 固化最佳实践
变更记录
- 2024-03-25: 创建工作流规则文档（sanguo_quant_live项目）
- 制定：庞统（凤雏）
- 审核：诸葛亮
"卧龙风雏，得一可安天下" - 蜀汉量化任务平台工作流