mquant（mquant 开发）

MQuant Strategy Development Assistant

Overview

This skill generates runnable Python strategy code for the Matic-MQuant quantitative trading platform.

核心理念：

• 代码可直接运行优先，策略逻辑可由用户后续调整
• 生成代码经过模板验证，确保语法正确、API调用无误
• 用户可在实盘前通过Matic模拟盘验证策略效果

⚠️ 注意：由于Matic平台不支持回测，策略验证应通过测试环境调试。

Reference Structure

SKILL文档（Skill 维护）

⭐ 快速参考文档，生成策略时优先查阅

用户自定义文档（用户自行维护）

区别：

• reference/ = Skill 文档（随版本更新）
• custom_docs/ = 用户的私人笔记（完全自主，Skill 永不更新）
• 生成策略时优先参考 custom_docs/ 中的内容

Workflow

Step 0: User Environment Initialization (First Run)

首次使用时，自动创建以下内容：

1. 个人笔记文件（如果不存在）：

- COMMON_ERRORS.user.md - 个人错误笔记 - TRADING_RULES.user.md - 个人交易规则 - TRADING_PHILOSOPHY.user.md - 个人交易理念

1. custom_docs/ 用户自定义文档（如果不存在）：

- README.md - 目录说明 - strategy_templates.user.md - 策略模板库（含示例模板） - api_cookbook.user.md - API 速查手册 - deployment_checklist.user.md - 上线检查清单 - debugging_guide.user.md - 问题排查手册 - exchange_notes.user.md - 交易所特性笔记

提示：custom_docs/ 中的文档完全由用户管理，可随时编辑添加，也可由SKILL自助。

Step 1: Directory Configuration (User Provided)

需要用户提供 M-quant 策略目录路径

出于安全考虑，不进行全盘扫描。请用户自行提供保存路径。

路径示例：

Windows: D:\Matic\M-quant\admin\
         D:\Trading\Matic\M-quant\	rader01\
         C:\Program Files\Matic\M-quant\user\

路径确认流程：

1. 询问用户策略保存路径
2. 验证路径是否存在且可写
3. 如路径无效 -> 提示重新输入或仅输出代码到对话
4. 用户不提供路径 -> 直接输出代码到对话，不保存文件

Step 2: Version Control

命名格式：xxxxx_vN.py（文件名 ≤ 11 个字符）

举例:
首次生成: ma_v1.py + ma_v1.log
再次生成: ma_v2.py + ma_v2.log

规则：

• 最多保留 5 个版本，超出时自动删除最旧版本
• 生成新版本时自动对比变更（Version Diff）

Step 3: Strategy Parameter Configuration

确认策略类型后，询问用户参数需求：

举例:

您需要【xx交易策略】，请选择参数设置方式：
1. 自定义参数
2. AI 根据描述自动生成

• 自定义参数：用户指定具体数值，未填项使用默认值
• AI 生成：用户描述需求（如"茅台 1600-1800 网格交易"），AI 自动推断参数

Step 4: Code Generation

生成原则：可运行 > 完美

确保生成的代码：

• 语法正确，可直接运行
• API 调用符合 Matic 规范（接口速查详见 reference/API_REFERENCE.md）
• 包含日志写入功能
• 包含基本异常处理

参考文档优先级：

1. custom_docs/strategy_templates.user.md - 用户模板（如存在）
2. custom_docs/api_cookbook.user.md - 用户API 使用习惯（如存在）
3. custom_docs/exchange_notes.user.md - 用户交易所特性（如存在）
4. reference/mquant_api.py - MQuant内置 API 定义
5. reference/mquant_struct.py - MQuant内置 数据结构

代码规范：生成的策略必须包含日志功能，详细实现请参阅 reference/LOG_FORMAT.md API 规范：详细 API 用法和常见错误请参阅 reference/API_REFERENCE.md

保存与展示：

1. 在对话中完整展示生成的代码
2. 保存 .py 文件到选定目录
3. 同步保存 .log 元数据文件
4. 展示完成后提示保存路径：

   代码已生成并保存！
   
   文件位置：[完整路径]\strategy_name_v1.py
   日志文件：[完整路径]\strategy_name_v1.log
   
   你可以直接在 Matic-MQuant 中加载此策略。

Step 5: Debugging & Error Fixing

错误分类：

• Syntax Error：语法错误
• Import Error：模块导入失败
• API Error：Matic API 调用错误
• Logic Error：逻辑错误
• Runtime Error：运行时错误

排查步骤：

1. 读取 .log 文件查看生成参数和运行时日志
2. 查阅 custom_docs/debugging_guide.user.md 是否有类似问题
3. 查阅 custom_docs/exchange_notes.user.md 确认是否交易所特性导致

修复后建议：

• 新问题 -> 记录到 custom_docs/debugging_guide.user.md
• 交易所特性 -> 更新 custom_docs/exchange_notes.user.md
• 模板改进 -> 更新 custom_docs/strategy_templates.user.md