sanguo/sanguo_quant_live

Fork 0

Files

T

cfdaily c0e4cf4990 auto-sync: 2026-04-11 09:00:02

2026-04-11 09:00:02 +08:00

10 KiB

Raw Permalink Blame History

三国量化任务平台 - 目录结构与工作流规则 (依据AGENTS.md更新)

项目定位

本项目是三国量化交易项目的任务管理与协调平台，专注于任务分配、进度跟踪和成果管理。

vnpy框架使用原则

尽量使用原生vnpy框架模块，不仿写，不重写，尽量适配

优先使用vnpy官方提供的组件，避免重复造轮子
对于不满足需求的功能，优先考虑扩展和适配，而非完全重写
保持与vnpy官方架构的兼容性，便于后续升级和维护
只在官方组件无法满足核心需求时，才考虑自定义实现

技术架构原则

基于vnpy官方架构，遵循分层设计原则

策略层：使用CtaTemplate等官方策略基类
数据层：使用vnpy官方数据接口和存储组件
平台层：使用Docker容器化部署，保持架构一致性
通信层：使用RPC服务，遵循vnpy官方通信协议

依据AGENTS.md的团队配置

指挥层

姓名	角色	职责
诸葛亮	总军师	任务分配、进度监控、结果汇总、系统修复
庞统士元	副军师	策略设计、任务拆分、代码整合
司马懿仲达	质量总监	代码审计、质量复核、最终验收

执行层

姓名	角色	职责
张飞翼德	右路先锋	vnpy框架改造设计，支持聚宽/QMT多风格兼容，多回测引擎，更好结果展示
关羽云长	左路先锋	风控模块开发、风险控制、安全防护
赵云子龙	数据护军	数据获取、清洗验证、质量检查
姜维伯约	平台总督	基础设施选型，开发/测试/生产环境搭建和运维，平台工具链搭建和运维

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. 各将军工作区（依据AGENTS.md职责）

zhaoyun-data/ - 赵云：数据获取、清洗验证、质量检查
guanyu-risk/ - 关羽：风控模块开发、风险控制、安全防护
jiangwei-platform/ - 姜维：基础设施选型，开发/测试/生产环境搭建和运维，平台工具链搭建和运维
zhangfei-technical/ - 张飞：vnpy框架改造设计，支持聚宽/QMT多风格兼容，多回测引擎，更好结果展示
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. 独立任务工作流

用户需求 → 诸葛亮拆解 → sessions_send分配任务 → 将军完成后提交成果物 → 诸葛亮审核 → 交付

执行方式：

诸葛亮通过sessions_send直接分配任务给特定将军
将军完成任务后，将成果物提交到自己目录的相应位置（如research/, scripts/, reports/等）
诸葛亮审核成果物（归档由诸葛亮决定）

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. 知识库定位和路径

统一的知识库：所有将军使用同一个公共知识库
具体路径：/Users/chufeng/.openclaw/knowledge_base/

当前内容：

/Users/chufeng/.openclaw/knowledge_base/
├── jqjoinquant/      # 聚宽相关知识和数据
└── tradingview/      # TradingView相关知识和数据

基础数据存放：存放原始数据、基础资料、标准定义
分析结果分离：个人分析结果放在自己的工作目录下

2. 使用原则

知识库只存放基础数据：原始数据、基础概念、标准定义、参考资料
分析数据放到各自工作目录：调研报告、分析结果、处理脚本等个人分析产出，请放在各自将军的工作目录下
禁止污染知识库：不要将个人分析结果、临时文件、不同分析角度的结果存入知识库

3. 禁止行为

❌ 不要将个人分析结果存入公共知识库
❌ 不要修改他人已确认的基础数据
❌ 不要在知识库中存放临时文件
❌ 不要污染知识库结构

4. 正确做法

✅ 从/Users/chufeng/.openclaw/knowledge_base/获取基础数据进行分析
✅ 将分析结果保存在自己目录的reports/或analysis/中
✅ 如需更新知识库数据，提交审核后统一更新
✅ 不同分析角度产生不同结果，各自保存

文件流转规则

研发流程

调研报告（research/） → 原型脚本（scripts/） → 验证通过 → 最终脚本（strategies/）

质量流程

各将军产出 → 司马懿质量审核 → 诸葛亮最终审核 → （归档由诸葛亮决定）

角色职责（依据AGENTS.md）

角色	AGENTS.md职责	工作目录	专项负责
诸葛亮	任务分配、进度监控、结果汇总、系统修复	`management/`	总体管理
庞统	策略设计、任务拆分、代码整合	`pangtong-value/`	价值投资（基本面策略）
司马懿	代码审计、质量复核、最终验收	`simayi-quality/`	质量保证
张飞	vnpy框架改造设计，支持聚宽/QMT多风格兼容，多回测引擎，更好结果展示	`zhangfei-technical/`	技术策略、回测引擎
关羽	风控模块开发、风险控制、安全防护	`guanyu-risk/`	风控管理
赵云	数据获取、清洗验证、质量检查	`zhaoyun-data/`	数据支持
姜维	基础设施选型，开发/测试/生产环境搭建和运维，平台工具链搭建和运维	`jiangwei-platform/`	平台基础设施

变更记录

2024-03-25: 创建最终版工作流规则文档
策略分工明确：庞统负责价值投资（基本面），张飞负责技术策略
目录结构调整：每个将军一个完整工作区
沟通方式简化：使用sessions_send直接沟通
制定：庞统（凤雏）
审核：诸葛亮

重要更新 - 2026-03-25 提交方式调整

📜 军令：自今日起，调整项目提交方式：
开发过程不变：各位将军仍在自己的独立workspace中接收任务、开发调试
成果物提交统一：完成任务后，请将成果物统一提交到项目目录：
/Users/chufeng/.openclaw/sanguo_projects/sanguo_quant_live
放到各自分工目录下即可，保持原有的目录结构不变
统一推送远程：所有变更由丞相（诸葛亮）统一审核后提交到Gitee，诸位将军无需自行推送
保持Gitee仓库整洁，避免冲突，由总军师统一把关后再合并，保证项目质量。

"卧龙风雏，得一可安天下" - 蜀汉量化任务平台工作流

10 KiB Raw Permalink Blame History Unescape Escape