价格行动技能是一款专业的市场结构分析和交易设置检测工具包，专为AI编码助手（如Claude Code、Cursor和Antigravity）设计。

它弥合了程序化定量计算与定性图表分析之间的差距，采用Al Brooks经典的价格行为（PA）方法，自动扫描A-Share和全球市场K线图。

主要特色

• 📈 市场周期分类：程序化检测股票是否处于尖峰（强趋势）、通道（紧/宽）或交易区间（TR）。
• 🎯 Brooks回调设置计入：自动识别上升趋势回调中的H1/H2（高1/2）多头配置，以及下降趋势中的L1/L2（低1/2）看跌配置。
• 📍 波摆枢轴与支撑/阻力检测：绘制波幅高低图，构建通道并追踪水平支撑/阻力水平。
• 📐 楔形形态检测：识别看跌楔形顶和多头楔形底（三推结构），预测趋势反转。
• 📊 自动注释可视化：渲染K线图，突出EMA、摆动点、支撑/阻力区及H1/H2/L1/L2交易触发条件。

Price Action Skills — AI-Powered Brooks Price Action Analyzer

Price Action Skills is a professional market structure analysis and trading setup detection toolkit designed for AI coding assistants (like Claude Code, Cursor, and Antigravity).

It bridges the gap between programmatic quantitative calculations and qualitative chart analysis, automatically scanning A-Share and global market K-line charts using Al Brooks’ classic Price Action (PA) methodology.

Key Features

• 📈 Market Cycle Classification: Programmatically detects whether a stock is in a Spike (Strong Trend), Channel (Tight/Broad), or Trading Range (TR).
• 🎯 Brooks Pullback Setup Counting: Automatically identifies H1/H2 (High 1/2) bullish setups in uptrend pullbacks, and L1/L2 (Low 1/2) bearish setups in downtrends.
• 📍 Swing Pivot & Support/Resistance Detection: Maps swing highs and swing lows to construct channels and trace horizontal support/resistance levels.
• 📐 Wedge Pattern Detection: Identifies bearish wedge tops and bullish wedge bottoms (3-push structures) to forecast trend reversals.
• 📊 Auto-Annotated Visualization: Renders K-line charts highlighting EMAs, Swing Points, Support/Resistance zones, and H1/H2/L1/L2 trading triggers.

---

Repository Layout

price-action-skills/
├── SKILL.md                 # System prompt & skill configuration for AI agents
├── README.md                # Project documentation (this file)
├── scripts/
│   ├── pa_analyzer.py       # Core Python logic for Price Action calculation
│   └── chart_plotter.py     # Annotation and chart rendering engine
├── references/
│   └── al_brooks_cheat_sheet.md # Al Brooks terminology and reference guide
└── tests/                   # Test suite for indicators and algorithms

---

Getting Started

1. Requirements

• Python 3.10+
• Dependencies: pandas, numpy, matplotlib, requests, loguru (Optionally yfinance / akshare for live market data)

pip install pandas numpy matplotlib requests loguru yfinance

2. Run Analysis

You can execute the analyzer script directly to output a structured JSON report:

python scripts/pa_analyzer.py --ticker 601899 --start-date 20251001 --end-date 20260625 --output scratch/pa_601899.json

Arguments:

• --ticker: The 6-digit stock code (e.g. 601899 for Zijin Mining, 000001 for Ping An Bank) or US tickers (e.g. AAPL, GLD, QQQ).
• --output: Path to save the extracted setups and market structures (JSON).

3. Generate Annotated Charts

Once you have the analysis output, pass it to the plotter:

python scripts/chart_plotter.py --data scratch/pa_601899.json --output scratch/chart_601899.png

This produces a publication-quality chart mapping the identified Price Action setups on top of the candlestick chart.

---

Integrating with AI Agents (Antigravity / Claude Code)