Stock Analytics Skill - 股市投资分析助手

🎉 V2.0 升级 - 2026年6月25日

• 重构为基于 stock-sdk 的架构
• 新增股息率计算功能
• 支持A股、港股、美股、基金多市场
• 84个SDK方法，覆盖更多数据维度

项目简介

Stock Analytics Skill 是一个基于大语言模型（LLM）的股市投资分析技能集，专为个人投资者设计。它通过模块化的Skill架构和本地数据获取工具，帮助投资者进行市场分析、资产配置和投资决策。

核心特点

• 多维度分析：覆盖A股、港股、债券基金、ETF、基金等多个投资品种
• 智能持仓管理：根据投资者配置，自动调用对应分析技能
• 本地数据获取：可直接获取港股、基金实时行情数据
• 长期投资导向：专注于长期稳健复利策略，不鼓励短期炒作
• 开源可扩展：模块化设计，方便自定义和扩展

适用人群

• 追求长期稳健收益的个人投资者
• 无太多时间盯盘的上班族
• 希望系统化学习投资的小白投资者

投资理念

核心原则：长期持有、分红再投入、不波段、不追热点、年度再平衡
风险偏好：中低风险为主，小仓位高弹性进攻，严控回撤

Skill 技能一览（25个技能）

市场分析类

ETF投资类

基金投资类

个股分析类

投资发现类

债券与信用类

宏观研究类

资产配置类

使用场景

快速开始

1. 安装依赖

npm install -g bun  # 如果有bun运行时，则跳过
bun --version

bun install

2. 查询股票/基金数据

# 查询港股
bun run main.ts -s hk00700

# 查询基金
bun run main.ts -f 320007

# 查询多个标的
bun run main.ts -s hk00700,hk01810 -f 320007,110022

3. 配置持仓

复制 position.example.md 为 position.md，然后编辑 position.md 配置您的持仓信息：

cp position.example.md position.md

position.md 包含个人持仓数据，已加入 .gitignore，不会被提交到仓库。请放心编辑。

4. 配置Agent

编辑 agents.md 文件，配置Skill调用规则和场景映射。

首次配置说明

为什么要配置 position.md 和 agents.md？

本项目采用 Skill + 配置驱动 的架构，大模型需要通过这两个文件来理解您的投资情况：

• position.md：定义您的持仓配置，包括持仓标的、目标占比、配置规则等
• agents.md：定义Agent的工作流程，包括各场景对应调用哪个Skill、分析报告生成流程等

配置步骤

第一步：配置持仓信息

打开 position.md 文件，根据您的实际情况修改持仓配置：

| 资产大类 | 具体标的 | 代码 | 查询参数 | 目标占比 | 配置规则 & 备注 |
| --- | --- | --- | --- | --- | --- |
| 核心稳健权益类（50%） | 红利低波50ETF | sh515450 | -s | 20% | 股息率过低则逐步减仓... |

主要修改内容：

• 持仓标的代码
• 目标占比
• 个人的配置规则和备注

第二步：将 agents.md 丢给大模型

在开始使用大模型分析之前，需要将 agents.md 文件内容完整复制并发送给大模型，让大模型理解您的工作流程。

发送方式：

请加载以下 Agent 配置文件，并按照其中的规则执行任务：
[复制 agents.md 的完整内容]

或者将agents.md内容作为system prompt上传至IDE Agent对话框，生成随时可对话的智能体

设置->智能体->创建->输入智能体名称->agents.md内容粘贴至提示词

第三步：验证配置

配置完成后，可以尝试让大模型执行一个简单的任务来验证配置是否生效：

请分析一下我的持仓今天表现怎么样？

大模型应该会：

1. 自动读取 position.md 了解您的持仓
2. 调用CLI获取各持仓标的数据
3. 按照 agents.md 中的流程进行分析
4. 给出持仓分析报告

配置示意图

┌─────────────────────────────────────────────────────────┐
│                     大模型对话窗口                        │
├─────────────────────────────────────────────────────────┤
│  用户：今天我的持仓表现怎么样？                            │
│                                                         │
│  ┌──────────────────────────────────────────────────┐  │
│  │ 大模型读取 agents.md → 了解工作流程               │  │
│  │ 大模型读取 position.md → 了解持仓配置            │  │
│  │ 大模型调用 CLI 获取数据 → 各持仓标的价格          │  │
│  │ 大模型调用对应 Skill → 分析各持仓                 │  │
│  │ 大模型给出分析报告和建议                          │  │
│  └──────────────────────────────────────────────────┘  │
│                                                         │
│  输出：今日持仓分析报告...                                │
└─────────────────────────────────────────────────────────┘

CLI 工具

基本用法

bun run main.ts [options]

参数说明

stdout 只输出数据本身，标题与提示信息走 stderr，可直接将输出管道给 JSON 解析工具使用。

输出格式

JSON 格式（默认）：

[
  {
    "name": "贵州茅台",
    "code": "600519",
    "price": 1212.72,
    "change": -19.28,
    "change_percent": -1.57,
    "update_time": "2025/06/24"
  }
]

Table 格式：

名称        代码     价格      涨跌    涨跌幅
贵州茅台    600519   1212.72   -19.28  -1.57%
招商银行    600036   36.56     -0.55   -1.48%

支持的市场

• A股：sh600519（贵州茅台）、sh600036（招商银行）等
• 港股：00700（腾讯控股）、01810（小米集团）等
• 美股：AAPL（苹果）、MSFT（微软）等
• 基金：006493（南方中债）、006961（南方中债7-10年）等
• ETF：sh515450（红利低波50ETF）等

使用示例

示例1：查询股票数据

$ bun run main.ts -s hk00700

=== 获取股票数据 ===
请求状态: 成功

1. 腾讯控股 (TENCENT)
  当前价格: 538
  涨  跌: +22
  涨跌幅: +4.264%
  更新时间: 2026/03/10 11:09

示例2：市场行情分析

用户：今天A股市场表现怎么样？
Agent：调用 stock-analytics Skill，分析今日行情...

示例3：持仓综合分析

用户：今天我的持仓表现怎么样？
Agent：
1. 读取 position.md 了解持仓配置
2. 使用 CLI 获取各持仓标的数据
3. 调用各专业Skill分析持仓标的
4. 调用 asset-allocation-rebalancing 给出建议

示例4：个股深度分析

用户：请分析一下比亚迪的投资价值
Agent：调用 stock-investment-logic Skill，生成深度研究报告...

示例5：基金筛选

用户：我是平衡型投资者，帮我筛选几只合适的基金
Agent：调用 fund-screening Skill，根据风险偏好筛选基金...

示例6：主题投资

用户：AI主题有哪些真受益标的？
Agent：调用 thematic-stock-picker Skill，筛选AI产业链受益股...

示例7：宏观数据解读

用户：最新CPI数据怎么看？
Agent：调用 macro-data-interpretation Skill，解读通胀数据...

项目结构

stock-analytics-skill/
├── main.ts                 # CLI 入口文件
├── src/
│   ├── sdk.ts             # SDK封装层（stock-sdk）
│   ├── dividend.ts        # 股息率计算
│   ├── format.ts          # 输出格式化
│   └── index.ts           # 统一导出
├── test/
│   ├── sdk.test.ts        # 测试用例（bun test）
│   └── test-stock-sdk.ts  # stock-sdk 功能验证脚本
├── .agents/skills/        # Skill技能目录（25个技能）
├── position.example.md   # 持仓配置示例模板
├── agents.md             # Agent配置说明
├── package.json          # 项目依赖
└── README.md            # 项目介绍

技术栈

• 运行时：Bun
• CLI 框架：Commander
• 数据SDK：stock-sdk
• IDE：Trae IDE、Cursor、Windsurf 等支持 Skill 的开发工具
• 数据源：东方财富（股票/基金/港股/美股）

致谢

特别感谢 stock-sdk 作者提供的优秀开源库，使得本项目能够轻松获取A股、港股、美股、基金等多市场数据。

扩展开发

添加新的数据源

1. 在 src/ 目录下创建新的数据模块（参考 src/dividend.ts）
2. 实现数据获取和解析函数
3. 在 main.ts 中添加对应命令参数，并在 src/index.ts 中导出

添加新的Skill

1. 在 .agents/skills/ 目录下创建新目录
2. 编写 SKILL.md 文件，定义技能说明
3. 在 agents.md 中添加场景映射

注意事项

⚠️ 法律声明

• 本项目仅供个人学习和技术研究使用，禁止用于任何商业目的
• 数据来源为公开的第三方接口（东方财富、天天基金），数据归属权归各平台所有
• 本项目不存储任何用户数据，不涉及账户登录和信息采集
• 如有任何问题或侵权内容，请联系删除

⚠️ 风险提示

• 本项目仅供学习和参考，不构成投资建议
• 投资有风险，入市需谨慎
• 请根据自身情况做出投资决策

许可证

MIT License