AShare AI
A股量化交易 Claude Code Skill - 使用 Tushare Pro 获取数据，Backtrader 进行回测
目录
快速安装
方式一：自动全局安装（推荐）
直接告诉 Claude：
请全局安装 https://github.com/410417122/ashare-ai
Claude 会自动将插件安装到全局目录，所有项目都可以使用。
方式二：手动全局安装
# 添加 marketplace
claude plugin marketplace add 410417122/ashare-ai
# 安装插件（默认为全局安装）
claude plugin install ashare-plugin@ashare-plugins
安装后，在任何项目中都可以使用 /ashare skill。
更新插件
# 更新 marketplace
claude plugin marketplace update ashare-plugins
# 更新插件
claude plugin update ashare-plugin@ashare-plugins
前置要求
1. Claude Code
确保已安装 Claude Code CLI。
2. Python 环境
- Python 3.8 或更高版本
- 推荐使用虚拟环境（venv 或 conda）
3. Tushare Pro Token
AShare AI 使用 Tushare Pro 获取 A股数据，需要先注册并获取 token：
- 访问 Tushare Pro 官网
- 注册账号（免费）
- 在个人中心获取 token
- 配置 token（见下方快速开始）
注意：免费账号有积分限制，建议充值获取更多积分以支持高频数据获取。
4. 依赖包
使用 skill 时，Claude 会自动检测并提示安装所需的 Python 包：
# 核心依赖
pip install tushare pandas numpy backtrader matplotlib mplfinance
# 可选依赖（用于高级功能）
pip install scikit-learn shap networkx
推荐使用清华镜像加速安装：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <package-name>
快速开始
第一步：安装 Skill
按照上方快速安装步骤安装 ashare skill。
第二步：配置 Tushare Token
在任何项目中，告诉 Claude：
请帮我配置 Tushare Pro token
Claude 会引导你完成配置，通常会创建一个配置文件或环境变量。
第三步：开始使用
现在你可以开始使用 ashare skill 了！
示例对话：
你：/ashare 获取平安银行最近30天的日线数据
Claude：我来帮你获取平安银行（000001.SZ）最近30天的日线数据...
[执行代码并展示数据表格]
你：/ashare 回测一个双均线策略
Claude：我来帮你回测双均线策略...
[执行回测并展示结果，包括收益曲线图]
功能特性
📊 Tushare Pro 数据获取
完整的 A股市场数据支持：
- 行情数据：日线、周线、月线、分钟线
- 财务数据：资产负债表、利润表、现金流量表、财务指标
- 资金流向：主力资金、大单、中单、小单流向
- 市场数据：涨跌停、停牌、ST 股票
- 指数数据：指数行情、成分股、权重
特点：
- 自动处理数据格式转换
- 支持批量获取和增量更新
- 内置数据验证和清洗
🔄 Backtrader 回测引擎
专业的量化回测功能：
- 策略开发：支持自定义策略逻辑
- 风险控制：止损、止盈、仓位管理
- 性能分析：夏普比率、最大回撤、年化收益
- 可视化：收益曲线、持仓分析、交易记录
特点：
- 遵循 A股交易规则（T+1、涨跌停）
- 支持多股票、多策略回测
- 真实的手续费和滑点模拟
📈 因子分析
量化因子研究工具：
- IC 分析：信息系数、RankIC
- Shapley 值：因子贡献度分解
- 中心性指标：因子网络分析
- 因子组合：多因子合成和优化
特点：
- 60+ 预置因子示例
- 自动化因子测试流程
- 可视化分析报告
🤖 机器学习
量化机器学习支持：
- 特征工程：技术指标、财务指标、市场指标
- 标签生成：收益率、涨跌、分类标签
- 模型训练：集成常用 ML 模型
- 回测集成：ML 预测结果直接用于回测
特点：
使用示例
1. 获取股票数据
基础查询：
/ashare 获取平安银行（000001.SZ）最近 30 天的日线数据
批量查询：
/ashare 获取银行板块所有股票的最新财务指标（ROE、PE、PB）
历史数据：
/ashare 获取贵州茅台 2020-2023 年的年度财务数据
2. 策略回测
简单均线策略：
/ashare 回测一个简单的均线策略：5日均线上穿20日均线买入，下穿卖出。
测试标的：沪深300成分股，时间：2022-2023年
多因子策略：
/ashare 回测一个多因子选股策略：
- 选股条件：ROE > 15%，PE < 20，市值 > 100亿
- 每月调仓一次，持有前10只股票
- 时间：2021-2023年
带止损止盈：
/ashare 回测动量策略，设置止损-5%，止盈10%
3. 因子分析
单因子测试：
/ashare 分析 PE 因子对未来一个月收益率的预测能力
多因子对比：
/ashare 对比 PE、PB、ROE、营收增长率这四个因子的 IC 值
因子组合：
/ashare 用 Shapley 值分析这些因子的贡献度，并给出最优组合权重
4. 数据分析
行业分析：
/ashare 分析银行板块最近一年的估值变化趋势
资金流向：
/ashare 分析贵州茅台最近一个月的主力资金流向
技术分析：
/ashare 画出平安银行最近3个月的K线图，标注MACD和成交量
5. 完整工作流示例
从数据获取到策略回测的完整流程：
你：/ashare 我想开发一个基于ROE和PE的价值投资策略
Claude：好的，我来帮你完成这个策略开发。让我们分步进行：
1. 首先获取全市场股票的ROE和PE数据
2. 分析这两个因子的有效性
3. 设计选股规则
4. 进行回测验证
让我开始第一步...
[执行数据获取]
你：继续
Claude：数据已获取。现在进行因子分析...
[执行因子IC分析，展示结果]
根据分析，ROE的IC值为0.08，PE的IC值为-0.05（负相关合理）。
现在设计策略：每月选出ROE>15%且PE<20的前20只股票...
[执行回测，展示收益曲线和统计指标]
核心原则
执行哲学
你是执行者，不是教程生成器。
当你要求回测时，AI 会执行代码并展示结果，而不是让你自己复制代码运行。
当你要求图表时，AI 会生成并打开图片，而不是只给你一个文件路径。
| 用户请求 | ❌ 错误做法 | ✅ 正确做法 |
|---|
| "回测这个策略" | "这是代码，你自己运行" | 执行代码，展示回测结果 |
| "获取平安银行数据" | "用 pro.daily() 接口" | 执行代码，展示数据 |
| "画个K线图" | "保存到 chart.png" | 执行并打开图片 |
文档查询
遇到不确定的 Tushare 接口或 Backtrader 参数时，AI 会自动使用 Context7 查询官方文档，确保信息准确。
这意味着：
- 接口参数始终是最新的
- 字段说明准确无误
- 避免使用已废弃的功能
常见问题
安装相关
Q: 安装时提示 "Claude Code on Windows requires git-bash"
A: 需要设置 git-bash 路径。在命令前添加：
export CLAUDE_CODE_GIT_BASH_PATH="D:\Program Files\Git\usr\bin\bash.exe"
或者将此环境变量添加到系统环境变量中。
Q: 如何验证 skill 是否安装成功？
A: 运行以下命令查看已安装的插件：
claude plugin marketplace list
应该能看到 ashare-plugins 在列表中。
Q: 如何卸载 skill？
A: 运行以下命令：
claude plugin uninstall ashare-plugin@ashare-plugins
使用相关
Q: 提示 "Tushare token 未配置"
A: 需要先配置 Tushare Pro token。告诉 Claude：
请帮我配置 Tushare Pro token，我的token是：xxxxxxxx
Q: 数据获取失败，提示积分不足
A: Tushare Pro 免费账号有积分限制。解决方法：
- 访问 Tushare Pro 官网充值获取更多积分
- 减少数据获取频率
- 使用缓存避免重复获取
Q: 回测结果不符合预期
