| name | stock-analysis |
| description | Chinese stock technical analysis with resonance-based framework (客观共振五维框架). Use when users provide Chinese stock codes and request: (1) Technical indicator analysis, (2) Stock price/MA analysis, (3) MACD/KDJ/RSI indicators, (4) Volume analysis, (5) Bollinger Bands/ATR analysis, (6) Comprehensive stock reports, (7) Price trend analysis, (8) Acceleration/limit-up detection. **CORE**: Uses multi-dimensional resonance validation (客观共振) and probability-based scoring (not absolute predictions). Supports 6-digit stock codes (e.g., 000001, 600036, 603259) for Chinese A-shares. |
Stock Technical Analysis - 客观共振五维框架
基于多维度共振验证和概率化评分的A股技术分析工具，拒绝主观预判，让信号自己说话。
核心设计原则
- 客观信号优先：先收集信号，不下预设结论
- 评分化判断：从"硬性规则"转向"概率评分"，避免一刀切
- 阶段动态适配：根据行情阶段动态调整信号解读规则
- 维度共振验证：五维相互印证，任一维度不配合即降低置信度
- 概率思维：评分代表"概率高低"，非"绝对涨跌"
- 周期分层：区分超短线/短线/中长线，不同周期不同策略
环境配置
Step 1: 安装TA-Lib（系统依赖）
TA-Lib必须先在系统级别安装：
Step 2: 运行安装脚本
python scripts/setup_venv.py
这会创建venv/目录并安装所有依赖。
运行分析
Windows (PowerShell)
.\scripts\run.ps1 000001
Windows (Batch)
scripts\run.bat 000001
Linux/macOS
chmod +x scripts/run.sh
./scripts/run.sh 000001
直接运行Python
Windows:
venv\Scripts\python.exe scripts/analyze_stock.py 000001
Linux/macOS:
venv/bin/python scripts/analyze_stock.py 000001
常用股票代码
000001 - 平安银行600036 - 招商银行603259 - 药明康德000858 - 五粮液002957 - 科瑞技术
调用说明
从Claude Code调用此技能时：
- 设置
USER_WORKING_DIR环境变量为用户当前工作目录
- 运行分析脚本获取原始技术数据
- 按照客观共振五步分析法生成报告（参考下方）
- 评分规则详见
templates/strategy_rules.md
- 报告输出格式详见
templates/report_template.md
- 保存Markdown报告到用户工作目录的
股票分析报告/{日期}/ 子目录
正确的调用方式（推荐）：
使用 --output-dir 参数指定输出目录：
cd C:/Users/CHAOFAN/.claude/skills/stock-analysis
venv/Scripts/python.exe scripts/analyze_stock.py {股票代码} --output-dir "{用户工作目录}"
或者使用环境变量：
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
2.MA均线粘合
3.价格在布林带中轨附近
4.近10日涨跌幅<10% | 方向不明，箱体波动 |
| 趋势加速市 | 1.ADX>25且上升
2.MA均线发散
3.价格突破布林上轨
4.近5日涨跌幅>10% | 方向明确，动能强劲 |
| 反转市 | 1.原趋势衰竭
2.出现反向突破信号
3.MA即将金叉/死叉
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小时缓存）
- 智能缓存：避免频繁网络请求，提升响应速度
- 静默模式：版本检查在后台进行，不干扰正常使用
- 更新提醒：发现新版本时自动显示更新命令
手动检查版本
venv/Scripts/python.exe scripts/version_checker.py
更新依赖
当提示有新版本时，运行：
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
- 原则：评分代表概率，非绝对预测
