chris-stock-master

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Stock Master

分析全球上市公司财报，生成结构化报告。

Analyze financial reports of listed companies worldwide and generate structured reports.

触发条件

Trigger Conditions

当用户请求以下内容时使用此 Skill：

"分析美股AAPL"/ "分析苹果公司"
"看看港股腾讯的财报" / "分析 0700.HK"
"茅台估值如何" / "分析 600519.SH"
任何关于股票财报、估值、财务分析的请求

Use this Skill when users make requests such as:

"Analyze US stock AAPL" / "Analyze Apple Inc."
"Check the financial report of Hong Kong stock Tencent" / "Analyze 0700.HK"
"How is Moutai's valuation?" / "Analyze 600519.SH"
Any requests related to stock financial reports, valuation, or financial analysis

支持市场

Supported Markets

市场	代码格式	示例
美股	`SYMBOL`	AAPL, MSFT, GOOGL
日股	`CODE.T`	7203.T (丰田)
A股	`CODE.SH/SZ`	600519.SH (茅台)
港股	`CODE.HK`	0700.HK (腾讯)

Market	Code Format	Example
US Stocks	`SYMBOL`	AAPL, MSFT, GOOGL
Japanese Stocks	`CODE.T`	7203.T (Toyota)
A-shares	`CODE.SH/SZ`	600519.SH (Moutai)
Hong Kong Stocks	`CODE.HK`	0700.HK (Tencent)

执行流程

Execution Process

1. 环境检查（首次）

1. Environment Check (First-time Use)

bash

cd "$SKILL_DIR"
if [ ! -d "scripts/.venv" ]; then
  python3 -m venv scripts/.venv
  scripts/.venv/bin/pip install -r scripts/requirements.txt
fi

bash

cd "$SKILL_DIR"
if [ ! -d "scripts/.venv" ]; then
  python3 -m venv scripts/.venv
  scripts/.venv/bin/pip install -r scripts/requirements.txt
fi

2. 运行分析

2. Run Analysis

bash

cd "$SKILL_DIR"
scripts/.venv/bin/python scripts/run_report.py --symbol <SYMBOL>

bash

cd "$SKILL_DIR"
scripts/.venv/bin/python scripts/run_report.py --symbol <SYMBOL>

3. 读取并呈现结果

3. Read and Present Results

分析完成后，读取生成的报告文件并向用户呈现关键信息：

bash

SYMBOL="<SYMBOL>"
SYMBOL_SAFE="${SYMBOL//./_}"
cat output/${SYMBOL_SAFE}_*/report.md

After analysis is completed, read the generated report file and present key information to users:

bash

SYMBOL="<SYMBOL>"
SYMBOL_SAFE="${SYMBOL//./_}"
cat output/${SYMBOL_SAFE}_*/report.md

参数说明

Parameter Description

参数	说明	默认值
`--symbol`	股票代码	必填
`--years`	财报年数	1
`--output`	输出根目录（公司子目录会自动创建）	`$SKILL_DIR/output`
`--refresh`	强制刷新缓存	false

如需改输出位置，显式传参覆盖默认值：

bash

cd "$SKILL_DIR"
scripts/.venv/bin/python scripts/run_report.py --symbol <SYMBOL> --output /path/to/output

Parameter	Description	Default Value
`--symbol`	Stock symbol	Required
`--years`	Number of fiscal years	1
`--output`	Root output directory (subdirectories for companies will be created automatically)	`$SKILL_DIR/output`
`--refresh`	Force refresh cache	false

To modify the output location, explicitly pass the parameter to override the default value:

bash

cd "$SKILL_DIR"
scripts/.venv/bin/python scripts/run_report.py --symbol <SYMBOL> --output /path/to/output

输出文件

Output Files

每个公司的文件放在独立文件夹中：

output/<SYMBOL>_<MARKET>/

output/
└── AAPL_US/                # 公司文件夹（代码_市场）
    ├── report.md           # 主报告（呈现给用户）
    ├── data.json           # 原始数据
    ├── analysis.json       # 分析结果
    ├── valuation.json      # 估值数据
    └── analyst.json        # 分析师预期

Files for each company are stored in independent folders:

output/<SYMBOL>_<MARKET>/

output/
└── AAPL_US/                # Company folder (symbol_market)
    ├── report.md           # Main report (presented to users)
    ├── data.json           # Raw data
    ├── analysis.json       # Analysis results
    ├── valuation.json      # Valuation data
    └── analyst.json        # Analyst expectations

呈现指南

Presentation Guidelines

向用户呈现结果时：

先输出报告开篇结论（增长趋势 + 估值状态）
按“财务亮点 → 产品研究 → 竞争格局 → 管理层指引”呈现核心信息
估值分析必须包含分位区间与币种说明
投资建议需给出明确结论（偏积极 / 中性 / 偏谨慎）
风格对齐
```
report_example.md
```
：少堆指标，多给可读结论

When presenting results to users:

First output the opening conclusion of the report (growth trend + valuation status)
Present core information in the order of "Financial Highlights → Product Research → Competitive Landscape → Management Guidance"
Valuation analysis must include quantile range and currency description
Investment recommendations must give clear conclusions (Positive / Neutral / Cautious)
Align with the style of
```
report_example.md
```
: fewer metrics, more readable conclusions

常见问题

Frequently Asked Questions

问题	解决方案
A股数据获取失败	检查网络，akshare 需要访问国内数据源
缓存数据过旧	使用 `--refresh` 强制刷新

Problem	Solution
Failed to obtain A-share data	Check network connection; AkShare requires access to domestic data sources
Cached data is outdated	Use `--refresh` to force refresh

注意事项

Notes

数据缓存 24 小时，使用
```
--refresh
```
强制更新
本 Skill 仅提供分析参考，不构成投资建议
A股使用 AkShare，其他市场使用 yfinance

Data is cached for 24 hours; use
```
--refresh
```
to force update
This Skill only provides analysis references and does not constitute investment advice
A-shares use AkShare, other markets use yfinance