Matic Mquant Assistant

# MQuant Strategy Development Assistant

## Overview

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

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

**⚠️ 注意**：Matic平台**不支持回测**，策略验证需通过模拟盘或极小仓位实盘测试。

## Reference Structure

```
reference/
├── mquantFAQ.md                    # 常见问题
├── mquant_inside_python_document/  # Python API文档
│   ├── python template.py          # Python策略模板
│   ├── mquant_api.py               # API接口定义
│   ├── mquant_struct.py            # 数据结构定义
│   ├── HTSACsvReader.py
│   └── HTSADbAccess.py
└── mquant_inside_python_strategy/  # Python策略示例
    ├── DualThrust/                 # DualThrust策略
    ├── 日频报单场景/               # 日频报单示例
    ├── 算法交易/                   # 算法交易示例
    ├── ETF轮动.py
    ├── Insight_Demo.py
    ├── R-Breaker.py
    ├── 两融接口调用示例.py
    ├── 交易数据下载.py
    ├── 增强网格策略.py
    ├── 定时撤单.py
    ├── 快捷参数多产品.py
    ├── 快捷参数示例.py
    ├── 横盘突破.py
    ├── 用户参数示例.py
    ├── 算法接口调用示例.py
    └── 调仓策略.py
```

## Workflow

### Step 0: User Environment Initialization (First Run)

**首次使用时，自动创建用户个人文档：**

检查以下文件是否存在，不存在则自动创建：

`
✓ COMMON_ERRORS.user.md      (个人错误笔记)
✓ TRADING_RULES.user.md      (个人交易规则)  
✓ TRADING_PHILOSOPHY.user.md (个人交易理念)
`

**每个文件包含模板：**
- My Coding Habits (编码习惯)
- My Common Mistakes (常见错误)
- My Debugging Tips (调试技巧)
- Personal Notes (个人笔记)

**说明：**
- .user.md 文件永远不会被Skill 更新覆盖
- 用户可随时编辑，记录个人习惯和心得
- Skill 文档更新时，.md 和 .user.md 各自独立维护

---

### Step 1: Directory Detection (Auto Scan)

Automatically locate the M-quant strategy director...

# Matic-MQuant-Assistant

> **MQuant 策略程序生成 OPENCLAW SKILL**

## 简介

Matic-MQuant-Assistant 是一个为 **Matic MQuant 模块** 编写的策略生成助手SKILL。目标是能够根据用户需求快速生成**可直接运行**的 Mquant Python 策略代码，提升效率。

**核心理念：可运行 > 完美**

- 先生成能运行的代码，策略逻辑可以后续优化
- 严格遵守 Matic MQuant API 文档，避免常见错误
- 详尽的日志记录，便于问题排查

## 免责声明

**本 Skill 仅生成代码框架，具体策略逻辑由用户自行实现。**

- 本工具仅提供策略代码的基础框架和模板
- 所有策略参数（买入条件、卖出条件、仓位管理等）由用户自行配置
- 生成的代码需在 Matic 测试环境中充分验证后再用于实盘
- 使用本工具生成的策略进行交易，风险由用户自行承担

## 主要特性

### 快速生成
- 支持 **Python** 策略生成
- 6 步工作流程：目录检测 → 语言选择 → 版本控制 → 参数向导 → 代码生成 → 代码解释
- 基于模板生成，确保代码可直接运行

### 质量保证
- **11 字符文件名限制** - 符合 Matic 平台要求
- 严格遵守 A 股交易规则
- **API 严格核对** - 每个接口和字段都核对文档
- **详尽日志** - 4阶段完整日志（初始化/行情/判断/执行）

### 个人化机制
- Skill 文档与个人笔记分离
- `.user.md` 文件永远不会被更新覆盖
- 记录个人习惯、踩过的坑、调试技巧



## 快速开始

### 1. 首次使用

首次使用时会自动创建个人笔记文件：
- `COMMON_ERRORS.user.md` - 个人错误笔记
- `TRADING_RULES.user.md` - 个人交易规则
- `TRADING_PHILOSOPHY.user.md` - 个人交易理念

### 2. 生成策略

直接告诉助手你想要的策略：

举例：
```
用户：我要一个双均线策略，标的用平安银行
助手：好的，正在生成...
```

### 3. 运行策略

生成的代码保存在 `M-quant/用户名/` 目录下，在 Matic 策略执行监控中加载运行。

## 文档结构

```
matic-mquant-assistant/
├── SKILL.md                    # 主文档（工作流程和API参考）
├── COMMON_ERRORS.md            # 常见报错总结
├── TRADING_RULES.md            # A股交易规则
├── README.md                   # 本文件
├── .gitignore                  # 保护个人文件
│
├── COMMON_ERRORS.user.md       # 个人错误笔记（自动创建）
├── TRADING_RULES.use...