# Stock Analysis

> Stock Technical Analysis - 客观共振五维框架

- Skill: `chaofanat/stock-analysis` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add chaofanat/stock-analysis`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chaofanat/stock-analysis/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: chaofanat (https://skillmd.com/u/chaofanat)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chaofanat/stock-analysis

---


# Stock Technical Analysis - 客观共振五维框架

基于**多维度共振验证**和**概率化评分**的A股技术分析工具，拒绝主观预判，让信号自己说话。

## 核心设计原则

1. **客观信号优先**：先收集信号，不下预设结论
2. **评分化判断**：从"硬性规则"转向"概率评分"，避免一刀切
3. **阶段动态适配**：根据行情阶段动态调整信号解读规则
4. **维度共振验证**：五维相互印证，任一维度不配合即降低置信度
5. **概率思维**：评分代表"概率高低"，非"绝对涨跌"
6. **周期分层**：区分超短线/短线/中长线，不同周期不同策略

---

## 环境配置

### Step 1: 安装TA-Lib（系统依赖）

TA-Lib必须先在系统级别安装：

- **Windows**: 从 https://github.com/cgohlke/talib-build 下载预编译wheel并用pip安装
- **Linux**: `sudo apt-get install -y build-essential python3-dev ta-lib`
- **macOS**: `brew install ta-lib`

### Step 2: 运行安装脚本

```bash
python scripts/setup_venv.py
```

这会创建`venv/`目录并安装所有依赖。

---

## 运行分析

### Windows (PowerShell)
```powershell
.\scripts\run.ps1 000001
```

### Windows (Batch)
```bash
scripts\run.bat 000001
```

### Linux/macOS
```bash
chmod +x scripts/run.sh
./scripts/run.sh 000001
```

### 直接运行Python

**Windows**:
```bash
venv\Scripts\python.exe scripts/analyze_stock.py 000001
```

**Linux/macOS**:
```bash
venv/bin/python scripts/analyze_stock.py 000001
```

---

## 常用股票代码

- `000001` - 平安银行
- `600036` - 招商银行
- `603259` - 药明康德
- `000858` - 五粮液
- `002957` - 科瑞技术

---

## 调用说明

**从Claude Code调用此技能时**：

1. 设置`USER_WORKING_DIR`环境变量为用户当前工作目录
2. 运行分析脚本获取原始技术数据
3. 按照**客观共振五步分析法**生成报告（参考下方）
4. **评分规则**详见 `templates/strategy_rules.md`
5. **报告输出格式**详见 `templates/report_template.md`
6. 保存Markdown报告到用户工作目录的 `股票分析报告/{日期}/` 子目录

**正确的调用方式（推荐）**：

使用 `--output-dir` 参数指定输出目录：
```bash
cd C:/Users/CHAOFAN/.claude/skills/stock-analysis
venv/Scripts/python.exe scripts/analyze_stock.py {股票代码} --output-dir "{用户工作目录}"
```

**或者使用环境变量**：
```bash
cd C:/Users/CHAOFAN/.claude/skills/stock-analysis
USER_WORKING_DIR="{用户工作目录}" venv/Scripts/python.exe scripts/analyze_stock.py {股票代码}
```

**重要**：输出目录必须使用绝对路径，否则文件可能保存到错误的目录。

---

## 客观共振五步分析法

**这是本技能的核心分析框架，必须严格按此顺序执行，不得跳步或预设结论。**

执行时必须同时参考：
- `templates/strategy_rules.md` - 详细评分标准和策略规则
- `templates/report_template.md` - 报告输出格式

---

### 第一步：客观信号收集 📋

**目的**：不做任何预设，客观记录五维核心的多空信号。

**原则**：
- 只记录客观信号，不做解读
- 多空信号平等记录，不提前过滤
- 信号必须来自原始数据，不得主观推断

**五维核心信号收集**：

| 维度 | 多头信号 | 空头信号 |
|------|---------|---------|
| 量能 | 从数据中提取 | 从数据中提取 |
| 价格 | 从数据中提取 | 从数据中提取 |
| 时间 | 从数据中提取 | 从数据中提取 |
| 空间 | 从数据中提取 | 从数据中提取 |
| 趋势 | 从数据中提取 | 从数据中提取 |

**⚠️ 信号统计**：按 `templates/strategy_rules.md` 中的"综合评分机制"进行五维评分。

---

### 第二步：行情阶段识别 🎯

**目的**：识别当前所处行情阶段，为下一步动态解读提供依据。

#### 三大行情阶段识别标准

| 阶段 | 识别标准（满足3条以上） | 特征描述 |
|------|---------------------|---------|
| **震荡市** | 1.ADX<25<br>2.MA均线粘合<br>3.价格在布林带中轨附近<br>4.近10日涨跌幅<10% | 方向不明，箱体波动 |
| **趋势加速市** | 1.ADX>25且上升<br>2.MA均线发散<br>3.价格突破布林上轨<br>4.近5日涨跌幅>10% | 方向明确，动能强劲 |
| **反转市** | 1.原趋势衰竭<br>2.出现反向突破信号<br>3.MA即将金叉/死叉<br>4.成交量异常放大 | 趋势转换，变盘点 |

**⚠️ 如果判定为"趋势加速市"**：必须执行 `templates/strategy_rules.md` 中的"趋势阶段细分"评分判定。

---

### 第二步-B：趋势阶段细分（仅趋势加速市）

**当第二步判定为"趋势加速市"时，必须执行此步骤。**

参考 `templates/strategy_rules.md` 中的"趋势阶段细分评分规则"：

- 计算加速初期、中期、末期的各自得分
- 得分最高的阶段为当前阶段
- 末期得分≥6分：进入高风险区

**动态阈值调整**：
- 强势牛市：涨幅阈值+10%，BIAS阈值+3%
- 弱势熊市：涨幅阈值-10%，BIAS阈值-3%
- 高波成长股：涨幅阈值+15%，BIAS阈值+5%

---

### 第三步：动态信号解读 🔄

**目的**：根据行情阶段，动态调整信号的解读规则。

**关键原则**：同一信号在不同阶段有完全不同的含义，绝不能用同一套规则套所有行情。

**必须参考** `templates/strategy_rules.md` 中的：
- "综合评分机制"（五维评分）
- "动态信号解读规则"（概率化表达）
- "例外情况识别"（涨停板、高控盘等）

**解读原则**：
- 使用概率表达（如"80%向上"）而非绝对判断
- 识别例外情况（涨停板缩量是正常的）
- 区分交易周期（超短线/短线/中长线）

---

### 第四步：五维共振验证 🔗

**目的**：基于当前阶段对应的动态权重，计算五维综合评分，检查各维度之间是否相互印证。

**⚠️ 动态权重机制**：根据第二步的阶段判定结果，使用不同的权重体系。详细规则见 `templates/strategy_rules.md` 中的"综合评分机制（分阶段动态权重）"章节。

| 阶段 | 趋势 | 量价 | 资金 | 乖离 | 动量 | 特殊规则 |
|------|------|------|------|------|------|---------|
| Phase 1 启动期 | 18 | 28 | 24 | 18 | 12 | 背离扣分减半 |
| Phase 2 中期 | 25 | 25 | 20 | 15 | 15 | 无 |
| Phase 3 末期 | 25 | 25 | 20 | 15 | 15 | 末期惩罚+天花板 |

**Phase 3 末期惩罚**：末期得分6-7扣8分(天花板≤70)，8-9扣12分(天花板≤60)，10分扣12分(天花板≤55)

#### 维度联动验证

| 维度A | 维度B | 验证重点 |
|-------|-------|---------|
| 量能 | 价格 | 放量上涨/缩量上涨/放量下跌/缩量下跌 |
| 价格 | 趋势 | 价格站上均线/跌破均线 + MACD多空 |
| 趋势 | 资金 | 趋势方向 + 资金流向 |
| 资金 | 量能 | 资金流向 + OBV/成交量 |
| 动量 | 趋势 | RSI/KDJ状态 + 趋势强度 |

#### 共振强度评级

基于综合评分（满分100分）：

| 等级 | 分数区间 | 含义 | 建议仓位 |
|------|---------|------|---------|
| 🔴 强共振 | ≥90分 | 五维共振向上，高概率上涨 | 50-70% |
| 🟠 中等共振 | 75-89分 | 五维偏多，上涨概率较大 | 30-50% |
| 🟡 弱共振 | 60-74分 | 五维分歧，方向不确定 | 10-30% |
| 🟢 无共振/分歧 | <60分 | 五维混乱，等待信号明确 | 0-10% |

**⚠️ 背离检测**：

参考 `templates/strategy_rules.md` 中的"背离检测规则"：
- 量价背离：-5至-8分
- 量能背离：-5至-10分
- 动量背离：-5至-10分
- 豁免条件：涨停板、高控盘、市场整体缩量等

背离总分 > 15分：降低评级至少1级

---

### 第五步：结论推导与策略 📝

**目的**：基于前四步的客观分析，推导最终结论和操作建议。

**严禁**：在此步骤引入主观预设或与前面分析矛盾的观点。

#### 综合评级标准

| 总分 | 评级 | 含义 | 建议仓位 |
|------|------|------|---------|
| ≥90 | ⭐⭐⭐⭐⭐ 明确看多 | 高概率上涨，五维共振 | 50-70% |
| 75-89 | ⭐⭐⭐⭐ 偏多 | 上涨概率较大，机会>风险 | 30-50% |
| 60-74 | ⭐⭐⭐ 中性 | 方向不明，观望为主 | 10-30% |
| 45-59 | ⭐⭐ 偏空 | 下跌概率较大，风险>机会 | 0-10% |
| <45 | ⭐ 明确看空 | 高概率下跌，五维向下 | 0% |

**注意**：评分是概率判断，90分代表"高概率上涨"，非"一定上涨"。

#### 操作策略

**必须根据行情阶段、细分阶段、交易周期，选择对应的策略模板**。

参考 `templates/strategy_rules.md` 中的"分阶段操作策略模板"：

**交易周期分层**：

| 周期 | 持有期 | 风险容忍 | 策略特点 |
|------|--------|---------|---------|
| 超短线 | <3天 | 高 | 严格止损，可追涨 |
| 短线 | 3-10天 | 中 | 等待确认，控制仓位 |
| 中长线 | >10天 | 低 | 趋势跟踪，分批建仓 |

**加速末期策略（末期得分≥6分）**：
- 稳健型：观望为主，不新开仓
- 短线型：极低仓位（5-10%）参与反弹
- 超短线：涨停确认可小仓位（≤10%）
- 持筹者：逐步减仓至≤30%

**特殊情况策略**：
- 大盘暴跌日(>3%)：所有策略仓位减半
- 涨停板：超短线可追，中长线等待开板确认

---

## 格式要求

- 严禁使用 `<br>` 标签，改用列表形式或分隔线
- 使用标准Markdown格式
- emoji增强可读性（📋🎯🔄🔗📝✅❌🔴🟠🟡🟢）
- 共振评级用彩色圆点标识
- 使用概率化表达（如"80%向上"）而非绝对判断
- 完整报告格式参考 `templates/report_template.md`

---

## 文件结构

```
stock-analysis/
├── venv/                    # 虚拟环境
├── scripts/                 # 脚本目录
│   ├── setup_venv.py
│   ├── version_checker.py   # 版本检查模块
│   ├── run.ps1 / run.bat / run.sh
│   └── analyze_stock.py
├── templates/               # 规则和模板目录
│   ├── strategy_rules.md   # 评分规则和策略模板
│   └── report_template.md  # 报告输出格式
├── .version_cache.json      # 版本检查缓存（自动生成）
└── SKILL.md                 # 本文件（核心框架说明）
```

---

## 版本检查功能 🔄

技能内置**自动版本检查**功能，确保使用最新版本的`aishare-txt`。

### 功能特点

- **自动检查**：每次运行分析时自动检查（24小时缓存）
- **智能缓存**：避免频繁网络请求，提升响应速度
- **静默模式**：版本检查在后台进行，不干扰正常使用
- **更新提醒**：发现新版本时自动显示更新命令

### 手动检查版本

```bash
# 独立运行版本检查
venv/Scripts/python.exe scripts/version_checker.py
```

### 更新依赖

当提示有新版本时，运行：

```bash
venv/Scripts/python.exe -m pip install --upgrade aishare-txt
```

---

## 错误处理

- 虚拟环境缺失 → 返回安装步骤
- TA-Lib未安装 → 返回安装链接
- 无效股票代码 → 返回错误提示和示例

---

## 重要说明

- 股票代码必须是6位数字
- 数据来源：akshare（中国股票市场）
- 报告仅供参考，不构成投资建议
- 文件按日期自动归档保存到用户工作目录的子文件夹中：
  - `股票分析报告/{YYYY-MM-DD}/` — 技术分析报告（.txt原始数据 + .md分析报告）
  - `股票分析数据/{YYYY-MM-DD}/` — 技术指标JSON数据
- **核心**：客观共振五步分析法 + 概率化评分
- **评分**：详见 `templates/strategy_rules.md`
- **格式**：详见 `templates/report_template.md`
- **原则**：评分代表概率，非绝对预测