a-share-skill

# a-share-skill > 中文文档 / Chinese README: [README.zh.md](README.zh.md) A collection of A-share (China Shanghai/Shenzhen) data-analysis, trend-pullback strategy, and paper-trading skills for AI tools — built for stock analysis, quant trading, paper trading, and A-share workflows: - `a-share-data`: market data query and analysis - `a-share-strategy-mainboard-multi-swing-defensive`: main-board trend-pullback signals - `a-share-strategy-allmarket-multi-swing-defensive`: all-market trend-pullback signals - `a-share-paper-trading`: paper-trading execution and backtesting You can simply ask your AI to: - Look up a stock's real-time quote, historical trend, technical indicators, events, and industry info - Scan main-board or all-market candidates and review position exit signals - Create a `calm1` paper-trading account, view account details and full trade history, and place simulated orders - Combine the broad market, your holdings, and account status to decide whether to buy, sell, hold, or do nothing today ## Paper Account: +40% in 2 Months <table> <tr> <td align="center" valign="top"> <strong>Apr 16 — account initialized with 1,000,000</strong><br/><br/> <img width="240" alt="account init" src="https://github.com/user-attachments/assets/ef7d9b23-b9a3-4c49-afc2-3f81fd489058" /> </td> <td align="center" valign="top"> <strong>Jun 17 — intraday +39.9%</strong><br/> Current holdings: ZTE, BOE A, WUS Printed Circuit, Jiemei Technology, Yongding, Voage Optoelectronics, LION Microelectronics, Boqian New Materials<br/><br/> <img width="731" height="859" alt="image" src="https://github.com/user-attachments/assets/3ed0eb21-34fe-4442-b49c-9adbdca31858" /> </tr> </table> Later update: The account saw a loss of about 30% during July and August, and its value fell to around 1.2 million. The figures above show the earlier June snapshot. ## Four Core Skills ### `a-share-data` Good for questions like: - How is this stock doing right now? - What's the trend over the last 60 days? - Are there any event-driven catalysts? - How are the CSI 300, hot sectors, and northbound capital doing right now? Capabilities: - Real-time quotes, historical K-line, technical indicators, events, industry, index, and macro data Docs: - [docs/A股数据安装使用文档.md](docs/A股数据安装使用文档.md) (Chinese) ### `a-share-strategy-mainboard-multi-swing-defensive` Scans a liquid main-board stock pool for trend-pullback entry and position exit signals. See [the skill guide](a-share-strategy-mainboard-multi-swing-defensive/SKILL.md). ### `a-share-strategy-allmarket-multi-swing-defensive` Uses the same signal rules across a liquid A-share pool that also includes ChiNext and STAR Market stocks. See [the skill guide](a-share-strategy-allmarket-multi-swing-defensive/SKILL.md). ### `a-share-paper-trading` Good for tasks like: - Create a `calm1` paper-trading account - View `calm1` account details, positions, orders, and full trade history - Place a simulated buy or sell order for `calm1` - Run a simple backtest Capabilities: - Account management, order placement, cancellation, positions, orders, fills, account valuation, and backtesting Docs: - [docs/模拟仓安装使用文档.md](docs/模拟仓安装使用文档.md) (Chinese) ## Quickest Examples - `Query data`: use `a-share-data` to check 600519's latest quote, the last 60 daily candles, and MACD. - `Scan trend pullbacks`: run either strategy’s `scripts/daily_decisions.py --json` and review the filtered candidate lists. - `Manage paper trading`: use `a-share-paper-trading` to create `calm1` with an initial balance of `1000000`, then view `calm1`'s account details and full trade history. ## Combined Usage - `Data analysis` - `a-share-data` - Good for single-stock analysis, market-state monitoring, and batch data pulls - `Strategy signals` - `a-share-data + a-share-strategy-mainboard-multi-swing-defensive` or `a-share-data + a-share-strategy-allmarket-multi-swing-defensive` - Good for candidate scans and position exit checks - `Paper execution` - `a-share-data + a-share-strategy-mainboard-multi-swing-defensive + a-share-paper-trading` - Good for reviewing signals and then executing simulated trades on `calm1` ## Installation The examples below include all four skills. ### Codex ```bash mkdir -p ~/.agents/skills cp -R a-share-data ~/.agents/skills/ cp -R a-share-strategy-mainboard-multi-swing-defensive ~/.agents/skills/ cp -R a-share-strategy-allmarket-multi-swing-defensive ~/.agents/skills/ cp -R a-share-paper-trading ~/.agents/skills/ ``` ### Cursor ```bash mkdir -p ~/.cursor/skills cp -R a-share-data ~/.cursor/skills/ cp -R a-share-strategy-mainboard-multi-swing-defensive ~/.cursor/skills/ cp -R a-share-strategy-allmarket-multi-swing-defensive ~/.cursor/skills/ cp -R a-share-paper-trading ~/.cursor/skills/ ``` ### Claude Code ```bash mkdir -p ~/.claude/skills cp -R a-share-data ~/.claude/skills/ cp -R a-share-strategy-mainboard-multi-swing-defensive ~/.claude/skills/ cp -R a-share-strategy-allmarket-multi-swing-defensive ~/.claude/skills/ cp -R a-share-paper-trading ~/.claude/skills/ ``` ### Qoder ```bash mkdir -p ~/.qoder/skills cp -R a-share-data ~/.qoder/skills/ cp -R a-share-strategy-mainboard-multi-swing-defensive ~/.qoder/skills/ cp -R a-share-strategy-allmarket-multi-swing-defensive ~/.qoder/skills/ cp -R a-share-paper-trading ~/.qoder/skills/ ``` If you use OpenCode, openclaw, or another AI tool that supports skills, just replace the path with that tool's skills directory. ## Documentation - [A-share Data — install & usage (Chinese)](docs/A股数据安装使用文档.md) - [Paper Trading — install & usage (Chinese)](docs/模拟仓安装使用文档.md) - [Main-board trend-pullback skill](a-share-strategy-mainboard-multi-swing-defensive/SKILL.md) - [All-market trend-pullback skill](a-share-strategy-allmarket-multi-swing-defensive/SKILL.md) ## Other Skills - `macd-second-golden-cross` - Good for spotting repair-type setups like "MACD bullish divergence + a second golden cross below the zero axis" - `macd-trend-resonance-stock-picker` - Good for "moving averages set the direction, MACD sets the rhythm" trend-resonance stock picking - `tuige-shortline-trading` - Good for short-line trigger / invalidation / risk / position_grade decisions ## References - Cursor: [Agent Skills](https://www.trycursor.com/docs/context/skills) - Claude Code: [Extend Claude with skills](https://code.claude.com/docs/en/skills.md) - Codex: [Agent Skills](https://developers.openai.com/codex/skills) - Qoder: [Skills](https://docs.qoder.com/extensions/skills) Data contract and industry updates: [数据口径与行业扩展](docs/data-contracts-2026-10-11.md).