sanguo_quant_live/management/workflow-rules.md

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

项目定位

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

依据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/                # 参考资料链接（链接到通用知识库）

策略分工依据AGENTS.md

1. 庞统 (pangtong-value) - 副军师 & 基本面策略

• 主要职责：策略设计、任务拆分、代码整合
• 专项负责：价值投资（基本面策略）
• 范围：基本面分析、财务指标、估值模型、价值投资策略
• 来源：原value-investing/目录内容
• 输出：价值投资策略脚本，提交到strategies/

2. 张飞 (zhangfei-technical) - 右路先锋 & 技术策略

• 主要职责：vnpy框架改造设计，支持聚宽/QMT多风格兼容，多回测引擎，更好结果展示
• 专项负责：技术策略开发、回测引擎优化
• 范围：技术指标、图表分析、量化信号、回测框架
• 来源：原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. 知识库定位和路径

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

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

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

2. 使用原则

公共知识库（只存基础数据）
/Users/chufeng/.openclaw/knowledge_base/
├── raw-data/           # 原始数据
├── basic-concepts/     # 基础概念定义
├── standards/          # 标准和规范
└── references/         # 参考资料

个人工作区（存分析结果）
将军名-职责/
├── research/           # 调研报告（基于知识库数据）
├── analysis-results/   # 分析结果（个人视角）
└── scripts/           # 分析脚本（使用知识库数据）

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直接沟通
• 制定：庞统（凤雏）
• 审核：诸葛亮

---

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