joinquant-skill

---
name: joinquant-skill
description: Generate accurate, runnable quantitative strategy code for the JoinQuant (聚宽) platform. Use this skill when the user asks to write a stock/ETF/futures backtest, paper-trading, or live-trading strategy on JoinQuant — the skill provides progressive-disclosure access to the complete JoinQuant API knowledge base (14 categories, 294KB official docs), 5 production-ready strategy templates (single-stock MA, multi-factor, ETF rotation, momentum, mean-reversion), and a lint tool that catches hallucinated APIs, future-function violations, and unset price-mode/slippage/commission. Chinese-friendly. Code generated by this skill should paste directly into the JoinQuant online editor without modification.
---

# JoinQuant Skill

Generate quantitative strategy code that runs on the JoinQuant platform without modification.

## When to Use This Skill

Yes:
- Stock backtest / paper trading / live trading on JoinQuant (聚宽)
- ETF rotation, multi-factor stock selection, momentum, mean reversion strategies
- Futures (期货) strategies on JoinQuant
- Margin trading (融资融券) strategies
- Strategy code review / lint to catch hallucinated APIs and future-function violations
- Translating a strategy idea into JoinQuant API calls

No:
- Local data analysis without JoinQuant (use `jqdatasdk` directly, or pandas/numpy)
- Strategy backtesting on other platforms (vectorbt, backtrader, vn.py — use those skills instead)
- Pure machine learning model training (no JoinQuant-specific API needed)
- Live trading on broker APIs other than JoinQuant simulated trading (CTP, Interactive Brokers, etc. need different skills)

## Default Mode

Most user requests fall into one of three patterns. Detect the pattern first, then route:

| Pattern | Trigger | Action |
|---|---|---|
| **Quick code** | "帮我写一个 X 策略" / "用聚宽实现 Y" | Pick template, fill in user-specific parts, return ready-to-paste code |
| **API question** | "聚宽里 get_price 的 fq 参数是什么意思" / "set_option 都有哪些选项" | Load matching `references/XX-*.md` and answer based on it |
| **Code review** | "帮我审一下我这段聚宽代码" / paste of existing code | Run mental `strategy_lint.py` against it (or actually call it), point out hallucinated APIs and missing safeguards |

## Progressive Disclosure: 14 API Categories

DO NOT load all references at once (294KB total, would burn context). Pattern-match the user request and load only the relevant category file:

| Category | Reference file | Triggered by keywords |
|---|---|---|
| 策略设置 | `references/01-strategy-setup.md` | initialize, set_benchmark, set_option, set_order_cost, set_slippage, run_daily, run_weekly, run_monthly |
| 数据获取 | `references/02-data-getters.md` | get_price, attribute_history, history, get_current_data, get_fundamentals, get_money_flow, get_concept, get_industry |
| jqlib 因子库 | `references/03-jqlib.md` | alpha101, alpha191, technical_analysis, jqfactor |
| 数据处理 | `references/04-data-processing.md` | get_factor_values, calc_factor_history, neutralize, winsorize, standardlize |