简体中文 | English
当前版本: SSQuant Agent 面向 期货策略 / data_server / SIMNOW/CTP / 中文回测报告 工作流。
SSQuant（松鼠Quant）是面向中国期货市场的 Python 量化交易框架，支持一套策略代码在 回测 / SIMNOW 仿真 / CTP 实盘 三种环境中运行。
它不是只做历史回测的 toy project，而是围绕期货交易的真实工程问题设计：连续合约、复权、换月、保证金、手续费、滑点、CTP 下单、Tick/K 线数据、SIMNOW 验证、实盘运行和回测报告。
| 项目 | 信息 |
|---|---|
| 当前版本 | v0.4.6 |
| Python | 3.9 - 3.14 |
| 上游 License | MIT |
| GitHub | songshuquant/ssquant |
| Gitee | ssquant/ssquant |
| 官网 | quant789.com |
这里的 MIT License 指 SSQuant 上游框架；本仓库是 QUANTSKILLS Agent 包，许可证以本仓库 LICENSE 为准。
SSQuant Agent 是给 AI 编码代理使用的 SSQuant 期货工作流契约。它不是一堆策略模板，而是让代理在真实项目里按正确顺序做事：先看源码和示例，再写策略，再跑真实回测，最后用报告和命令输出证明结果。
| 能力 | 说明 |
|---|---|
| 期货策略 | 编写、修复、解释和回测 SSQuant 期货策略 |
| 数据服务 | 诊断 data_server, SQLite/cache, raw/adjust_type, 历史数据任务 |
| SIMNOW/CTP | 回测迁移到模拟盘或实盘前的门禁检查 |
| 中文报告 | 检查回测指标、HTML/Markdown 报告、图表和模板问题 |
这个仓库正式命名为 agent-ssquant，根目录使用 AGENTS.md 作为主入口。
product name: SSQuant Agent
repo name: agent-ssquant
entry file: AGENTS.md
compat skill: skills/ssquant/SKILL.md
skills/ssquant/SKILL.md 只是兼容入口：当某些本地代理环境只能通过 SKILL.md 发现能力时，它会将任务引导到根目录的 AGENTS.md 执行契约。
flowchart LR
A["User request"] --> B["AGENTS.md"]
B --> C{"Lane"}
C --> D["Futures strategy / backtest"]
C --> E["data_server / cache"]
C --> F["SIMNOW / CTP gate"]
C --> G["Chinese report"]
D --> H["Evidence"]
E --> H
F --> H
G --> H
H --> I["command output / report path / logs / data proof"]
agent-ssquant/
|- AGENTS.md
|- README.md
|- README.en.md
|- LICENSE
|- agents/openai.yaml
|- skills/ssquant/SKILL.md
|- scripts/
| |- ssquant_doctor.py
| `- validate_strategy.py
|- references/
| |- core/
| |- futures/
| |- data/
| |- live-ctp/
| `- reporting/
`- assets/
`- ssquant-skill-map.svg
gh repo clone quantskills/agent-ssquant代理读取根目录 AGENTS.md 后，按它的路由表加载相应的 references/ 文件。
如果环境只识别 Skill，可以安装 skills/ssquant/SKILL.md 作为本地触发入口，它会回到 AGENTS.md 主契约。
Use SSQuant Agent to diagnose why this futures strategy has no trades.
Use SSQuant Agent to check raw versus adjust_type=1 behavior from data_server.
Use SSQuant Agent to run a real 60m dual moving average backtest and produce a Chinese report.
Use SSQuant Agent to gate a SIMNOW strategy before CTP runtime.
Agent 不应该在没有命令输出、报告路径、日志、SQL/API 结果或渲染产物的情况下宣称工作完成。
This QUANTSKILLS Agent package is licensed under the GNU General Public License v3.0. See LICENSE. The upstream SSQuant framework is distributed under the MIT License.