UZI-Skill 是一个让 AI 助手(如 Claude Code、Codex、Cursor 等)能够对 A 股、港股、美股进行深度分析的技能包。它模拟了 66 位投资大佬(巴菲特、段永平、赵老哥、黄仁勋等)组成评审团,调用 22 维数据22 种机构级分析方法(DCF、LBO、Comps 等),最终生成一份详尽的 Bloomberg 风格 HTML 分析报告。


1. 系统要求与前提

1.1 软件前提

  • AI 编程助手:您需要安装并配置好以下任一 AI 编程助手:
    • Claude Code(推荐,支持最完善)
    • Codex (OpenAI CLI)
    • Cursor
    • Gemini CLI
    • OpenClaw / 龙虾
    • Windsurf / Devin
  • 网络:需要互联网连接以获取实时行情、财报等公开数据。
  • Python:如果使用 CLI 直跑方式,需要 Python 3.10+ 环境。

1.2 数据源说明

  • 全部免费:无需任何付费 API Key。数据来自东方财富、雪球、akshare、Yahoo Finance、巨潮资讯等公开数据源。
  • 可选增强:可配置 MX_APIKEY(免费申领)以提升数据获取稳定性,尤其在海外网络环境下。

2. 安装步骤

安装方式取决于您使用的 AI 助手。

2.1 在 Claude Code 中安装(推荐)

这是最简单、功能最完整的方式。

  1. 添加插件市场
    在 Claude Code 中执行:

    1
    /plugin marketplace add wbh604/UZI-Skill
  2. 安装技能

    1
    /plugin install stock-deep-analyzer@uzi-skill
  3. 验证安装
    安装成功后,您可以使用以下命令测试(注意必须带 stock-deep-analyzer: 前缀):

    1
    /stock-deep-analyzer:analyze-stock 贵州茅台

2.2 在 Codex 中安装

直接对 Codex 说:

“请按照 https://raw.githubusercontent.com/wbh604/UZI-Skill/main/.codex/INSTALL.md 的指引安装 UZI-Skill,然后帮我深度分析 贵州茅台。”

2.3 在 Cursor 中安装

1
/add-plugin stock-deep-analyzer

然后说“分析 贵州茅台”。

2.4 在 Gemini CLI 中安装

1
gemini extensions install https://github.com/wbh604/UZI-Skill

2.5 在 OpenClaw / 龙虾 中安装

对龙虾说:

“帮我安装 https://github.com/wbh604/UZI-Skill 这个股票分析技能,装好后分析 贵州茅台。”

2.6 在其他 Agent(如 Windsurf/Devin)中安装

直接发送指令:

“克隆 https://github.com/wbh604/UZI-Skill ,读 AGENTS.md 了解怎么用,帮我深度分析 贵州茅台。”

2.7 CLI 直跑方式(不依赖 AI 助手)

如果您没有 AI 助手,也可以直接在终端运行(生成报告质量会有所降低):

1
2
3
4
git clone https://github.com/wbh604/UZI-Skill.git
cd UZI-Skill
pip install -r requirements.txt
python run.py 贵州茅台

3. 核心命令与使用

安装完成后,所有命令都需加上 /stock-deep-analyzer: 前缀以确保正确执行。

3.1 最常用的四条命令

命令 功能 耗时
/stock-deep-analyzer:analyze-stock 贵州茅台 完整深度分析(22维 × 66评委) 5-8 分钟
/stock-deep-analyzer:quick-scan 002217 30秒速判 <1 分钟
/stock-deep-analyzer:scan-trap 002217 杀猪盘排查 2-3 分钟
/stock-deep-analyzer:dcf 600519 DCF 估值专项 2-3 分钟

3.2 其他专项分析命令(共 14+ 条)

命令 功能
/stock-deep-analyzer:comps 002273 同行对标(PE/PB 分位分析)
/stock-deep-analyzer:lbo 600519 LBO 测试(PE 基金 IRR 视角)
/stock-deep-analyzer:initiate 002273 机构首次覆盖报告(JPM/GS 格式)
/stock-deep-analyzer:ic-memo 002273 投委会备忘录(三情景回报)
/stock-deep-analyzer:earnings 002273 财报解读(beat/miss 检测)
/stock-deep-analyzer:catalysts 002273 催化剂日历(未来 60 天事件)
/stock-deep-analyzer:ai-readiness 002273 AI 就绪度/卡位评估(v3.8 新增)
/stock-deep-analyzer:earnings-preview 002273 财报前预览(一致预期 + 隐含波动)
/stock-deep-analyzer:model-update 002273 新财报增量更新模型
/stock-deep-analyzer:returns 组合收益归因
/stock-deep-analyzer:rebalance 逐持仓再平衡

3.3 三档思考深度(CLI 专用)

您可以通过 --depth 参数控制分析深度:

1
2
3
python run.py 600519 --depth lite     # ⚡ 速判(1-2 分钟)
python run.py 600519 # 📊 标准分析(5-8 分钟,默认)
python run.py 600519 --depth deep # 🔬 深度研究(15-20 分钟)

4. 报告内容与解读

一份完整的分析报告包含以下核心部分:

  • 综合评分与 verdict:66 位评委投票后的综合得分和结论(如“值得重仓”、“可以蹲一蹲”、“观望优先”、“回避”)。
  • 66 位评审团审判席:每位评委的投票(绿色看多/红色看空/灰色中性)及其引用具体规则的评语。
  • 多空大辩论(The Great Divide):看多与看空评委的激烈辩论,引用具体数据。
  • 22 维深度数据卡:包括财务、估值、技术、供应链、舆情、政策等维度的可视化图表。
  • 机构级分析模型:DCF 估值(含 5×5 敏感性热力图)、Comps 对标、LBO 测试、IC 备忘录等。
  • 一键分享素材:自动生成朋友圈竖图(1080×1920)和微信群战报图(1920×1080)。

5. 配置与优化

5.1 数据源优化(推荐)

如果遇到数据获取不稳定,可申请并配置免费的 MX_APIKEY(东方财富妙想 Skills API):

1
2
cp .env.example .env
# 编辑 .env,填入 MX_APIKEY(免费申领:https://dl.dfcfs.com/m/itc4)

配置后可提升数据获取速度和稳定性,尤其适合海外用户。

5.2 社交热榜数据(v2.12+)

自动查询微博、知乎、百度、抖音、头条、B 站六大平台热榜,检测股票名称是否出现在热搜中,用于情绪分析。

5.3 雪球登录(可选)

如需获取雪球实盘组合持仓数据(19_contests 维度),可启用登录:

1
2
3
export UZI_XQ_LOGIN=1
python -m lib.xueqiu_browser login # 弹出浏览器手动登录
python run.py 贵州茅台

6. 常见问题排查

问题 可能原因 解决方案
命令未找到或无法识别 未加 /stock-deep-analyzer: 前缀 使用全名,如 /stock-deep-analyzer:analyze-stock 贵州茅台
分析卡在“数据采集”阶段 网络问题或数据源反爬 1. 检查网络连接。 2. 如使用海外网络,强烈建议配置 MX_APIKEY(见上文)。 3. 等待一会,脚本有自动重试和 fallback 机制。
报告显示“数据缺口”或橙色 banner 部分数据因网络或源限制未获取到 查看 .cache/<ticker>/_data_gaps.json 了解具体缺口。Agent 会自动尝试补齐,或您可稍后重跑。
评分看起来偏低(如茅台<65分) 评分校准使分值分布更合理(v2.11 校准) 分数是相对的。真正的坑会 <35分(回避),白马股通常在 50-65 分(观望/可以蹲)。请结合 verdict 文字结论判断。
macOS 提示“无法验证开发者”(Hermes 用户) Hermes Skills Guard 误判 使用一键安装脚本绕过:`curl -fsSL https://raw.githubusercontent.com/wbh604/UZI-Skill/main/install-hermes.sh

7. 总结

UZI-Skill 将复杂的个股基本面、技术面、情绪面分析封装成 AI 助手可直接调用的“超能力”。

核心使用路径

  1. 安装:在您的 AI 助手中执行对应的安装命令(如 Claude Code 的 /plugin 命令)。
  2. 分析:使用 /stock-deep-analyzer:analyze-stock 股票名 命令开始分析。
  3. 阅读报告:在生成的 HTML 报告中查看综合评分、评委意见、估值模型和风险提示。
  4. 专项深入:使用 dcfcompsic-memo 等专项命令进行针对性分析。

建议

  • 首次使用,建议先用 quick-scan 命令快速体验。
  • 对于核心标的,运行 analyze-stock 获得完整报告。
  • 报告是分析工具,不构成投资建议,请结合自身判断。
  • 遇到问题,可查看项目 docs/ 目录下的详细文档或在 GitHub 提交 Issue。

项目地址:https://github.com/wbh604/UZI-Skill