MQuant Strategy Development Assistant

---

name: mquant-coder

slug: mquant-coder

version: 1.0.5

description: Matic MQuant strategy development assistant. Generates Python strategy code for Matic-MQuant platform.

author: chouchounii

license: MIT-0

---

# MQuant Strategy Development Assistant

Overview

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

**核心理念**：

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

Reference Structure

SKILL文档（Skill 维护）

| 文档 | 路径 | 说明 |

|------|------|------|

| **API 速查手册** ⭐ | `reference/API_REFERENCE.md` | 常用 API、结构体字段、常见错误 |

| **日志格式规范** ⭐ | `reference/LOG_FORMAT.md` | 日志格式、级别、代码实现 |

| **API 完整定义** | `reference/mquant_api.py` | MQuant 官方 API 定义 |

| **数据结构定义** | `reference/mquant_struct.py` | MQuant 官方结构体定义 |

| **策略模板** | `reference/python template.py` | MQuant 官方策略模板 |

| **常见问题** | `reference/mquantFAQ.md` | 官方 FAQ |

| **策略示例** | `reference/mquant_inside_python_strategy/` | DualThrust、网格策略等示例 |

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

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

| 文档 | 路径 | 说明 |

|------|------|------|

| **策略模板库** | `custom_docs/strategy_templates.user.md` | 你的代码模板、公共函数 |

| **API 用法笔记** | `custom_docs/api_cookbook.user.md` | 你的 API 使用经验 |

| **上线检查清单** | `custom_docs/deployment_checklist.user.md` | 你的实盘检查项 |

| **问题排查手册** | `custom_docs/debugging_guide.user.md` | 你遇到的问题和解决 |

| **交易所特性** | `custom_docs/exchange_notes.user.md` | 你的交易所规则笔记 |

| **其他** | `custom_docs/...` | 用户需要的其他文档 |

**区别**：

Workflow

Step 0: User Environment Initialization (First Run)

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

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

- `COMMON_ERRORS.user.md` - 个人错误笔记

- `TRADING_RULES.user.md` - 个人交易规则

- `TRADING_PHILOSOPHY.user.md` - 个人交易理念

2. **`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\trader01\
         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

**规则**：

---

Step 3: Strategy Parameter Configuration

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

举例:

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

---

Step 4: Code Generation

**生成原则：可运行 > 完美**

确保生成的代码：

**参考文档优先级**：

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

**错误分类**：

**排查步骤**：

1. 读取 `.log` 文件查看生成参数和运行时日志

2. 查阅 `custom_docs/debugging_guide.user.md` 是否有类似问题

3. 查阅 `custom_docs/exchange_notes.user.md` 确认是否交易所特性导致

**修复后建议**：