SkillHub

mquant

v1.0.5

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

Sourced from ClawHub, Authored by chouchounii

Installation

Please help me install the skill `mquant` from SkillHub official store. npx skills add chouchounii/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 维护）

文档 路径 说明
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/... 用户需要的其他文档

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

Workflow

Step 0: User Environment Initialization (First Run)

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

  1. 个人笔记文件（如果不存在）：
  2. COMMON_ERRORS.user.md - 个人错误笔记
  3. TRADING_RULES.user.md - 个人交易规则

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

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

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

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

Step 1: Directory Configuration (User Provided)

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

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

路径示例：

Windows: D:MaticM-quantadmin
         D:TradingMaticM-quanttrader01
         C:Program FilesMaticM-quantuser

路径确认流程： 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