buy-side-research-skills

Buy-Side Research Skills —— 零基础完全上手指南

当前版本：3.9.0

仓库地址：iRyantik/buy-side-research-skills

---

Current Workspace Rules

This section is the canonical v3.9 workspace rule.

research-workspace/
  _inbox/                 # global staging only
  _scripts/
  edge-radar.md
  topics/
    industry/<slug>/
      index.md
      _inbox/             # created by new-session
      2026-05-18-industry-quickread.md
      2026-05-18-rklb-stock-quickread.md

    company/<slug>/
      index.md
      _inbox/             # created by new-session or promote-company
      2026-05-18-stock-quickread.md
      _cache/             # created on demand by financial-data / driver-map / ingest
      _raw/               # created on demand by ingest
      _models/            # created on demand by modeling skills

• new-session creates only index.md and _inbox/.
• ingest creates _raw/ and _cache/ on first conversion.
• Industry/theme topics can temporarily hold company research as YYYY-MM-DD-<company-slug>-<artifact>.md.
• Use promote-company to move company-scoped files into topics/company/<company-slug>/.
• integrate is unchanged and remains the legacy whole-topic directory merge skill.
• Industry topics do not get _models/ by default; model folders are created only when explicitly needed.

---

目录

• 0. 这个插件是什么？我能用它做什么？
• 1. 我完全不会编程，能用吗？
• 2. 安装：跟 Claude 说几句话就搞定
• 3. 准备工作：全用对话完成
• 4. 第一次研究：从零到写出第一份分析
• 5. 每个 Skill 做什么、什么时候用
• 6. 完整研究流程示例
• 7. 文件放在哪里？Workspace 结构详解
• 8. 常见问题与排错
• 9. 进阶：自定义与维护

---

0. 这个插件是什么？我能用它做什么？

用一句话说

这个插件把专业股票研究员（buy-side analyst）的工作流程，变成了一套你在 Claude Code 或 Codex 里可以直接用中文对话触发的「技能」。

源码与安装包结构

当前源码仓库是 wrapper + nested payload 结构：真正的 plugin payload 在 plugins/buy-side-research-skills/，active skills 在 plugins/buy-side-research-skills/skills/[skill-name]/。

用户下载的 Release zip 仍是扁平运行时结构，解压后直接包含 .claude-plugin/、.codex-plugin/、skills/ 和 README.md。源码 root 的 CLAUDE.md、AGENTS.md、docs/、examples/ 不进入安装包。

用人话说

想象你雇了一个非常聪明的研究助理。你跟他说：

• "帮我看一下 Vertiv 这家公司值不值得深入研究"
• "市场现在对 GE Vernova 的预期是什么？有没有哪里可能错了？"
• "帮我把 Rocket Lab 的财务数据拉出来，我要搭模型"
• "我下周要看 GE 的财报，帮我准备一下关键问题"
• "我想做多 Vertiv、做空西门子能源，帮我分析这个 pair trade 合不合理"

这个插件就是让 Claude / Codex 听得懂这些指令，并且按照专业研究员的标准来执行和输出。

你能做什么（不写一行代码）

你想做的事	跟 Claude 说什么
快速看一家不熟的公司	"用 stock-quickread 看 Vertiv"
快速了解一个陌生行业	"用 industry-quickread 看核电行业"
搞清楚一家公司到底靠什么赚钱	"用 driver-map 拆 Rocket Lab 的收入 driver"
搞懂一个行业的工程/技术原理	"用 mechanism-map 解释燃气轮机产业链"
拉美股/A股/港股/日股/韩股/欧股的财务数据	"用 financial-data 拉 AAPL 美股数据"
搭三表财务模型	"用 3-statement-model 给 GE 搭模型"
做 DCF 估值	"用 dcf-model 给 Rocket Lab 做 DCF"
看市场对一只股票的预期	"用 consensus-map 看市场对 IONQ 的预期"
写一份完整的做多/做空 thesis	"用 alpha-thesis 写 GE Vernova 做多逻辑"
找 thesis 的漏洞	"用 bear-pre-mortem 打我 GEV 做多 thesis 的逻辑"
准备财报季	"用 earnings-setup 准备下周 GE 的财报"
设计一对 pair trade	"用 pair-trade 分析做多 VRT 做空 SMCI"
比较几家同行业公司	"用 peer-deep-dive 比较 VRT、GEV、SMCI"
把研究结论沉淀下来	"用 research-journal 总结这轮研究"
判断一条新闻值不值得追	"用 information-impact 看这条消息"

你不能做什么（重要边界）

• 插件不会替你买卖股票，不会替你下单。
• 插件给的是分析框架和判断依据，不是投资建议。
• 所有财务数据来自公开源（SEC、交易所公告等），插件不做数据造假，也不会替你核实每一条第三方数据。

---

1. 我完全不会编程，能用吗？

能。 你不需要会写代码。你需要会的是：

1. 打字 —— 用自然语言跟 Claude Code 或 Codex 对话。
2. 知道你要研究什么 —— 知道公司名或股票代码，知道你想回答什么问题。
3. 有基本的文件操作能力 —— 新建文件夹、把 PDF/Excel 拖进文件夹。

你需要先装好的东西

你需要什么	怎么装	要不要钱
Claude Code 或 Codex	去官网下载安装即可	Claude Code 需要 Anthropic 账号和 API 额度；Codex 取决于你的授权
Python（仅 ingest 和 financial-data 需要）	去 python.org 下载，安装时勾选 "Add Python to PATH"	免费
本插件	看下一节，全程用对话安装	免费，开源

如果你只做对话类研究（让 Claude 帮你分析、写 thesis、做 peer comparison），你甚至不需要装 Python。只有当你需要消化 PDF/Excel 文件或拉取结构化财务数据时，才需要 Python。

三个概念先搞清楚

插件源码仓库（本 repo）
    ↓ 发布为扁平 Release zip 后安装
Claude Code / Codex（你的 AI 助手）
    ↓ 你对它说话，它加载本插件的 skills
研究 Workspace（你电脑上一个普通文件夹）
    ↓ 所有研究产物（分析报告、财务数据、模型）都存在这里

简单记：本仓库是"说明书和工具"，Claude Code 是"执行者"，Workspace 是"你的笔记本"。

---

2. 安装：跟 Claude 说几句话就搞定

第一步：确认 Claude Code 或 Codex 已装好

打开你的 Claude Code，随便跟它说句话（比如"你好"）。如果能正常回复，说明已装好。

如果还没装，去 Claude Code 官网下载安装。安装过程就是普通的"下一步→下一步"，跟装微信没有区别。

第二步：安装本插件

1. 打开 GitHub Release 页面
2. 下载最新版本的 buy-side-research-skills-X.X.X.zip
3. 解压到你电脑上的一个文件夹（记下路径）
4. 在 Claude Code 里说："帮我安装本地插件，路径是 xxx"（把 xxx 换成你解压的文件夹路径）

Claude 会帮你完成安装。你只需要确认即可。

如果你用的是 Codex，把上面对话里的 "Claude" 换成 "Codex" 即可，操作完全一样。

第三步：验证安装成功

在 Claude Code 里说：

"帮我检查 buy-side-research-skills 插件是否正确安装了"

如果 Claude 回复说能看到一列 skill 名字（如 stock-quickread、financial-data、driver-map 等），说明安装成功。

---

3. 准备工作：全用对话完成