us-stock-researcher

美股研究员

对美国股票 SEC 文件进行机构级深度分析，输出专业投资报告。

研究模式选择

模式	适用场景	要求
Gemini 模式	默认，在配置了 GEMINI_API_KEY 时使用	GEMINI_API_KEY 环境变量
Claude 原生模式	没有 Gemini API 或用户提出请求时	WebSearch 工具访问权限

---

快速入门工作流

路径变量

开始前，确定以下两个路径：

• <project_root>：用户的当前工作目录（Agent 会话启动的位置）。所有输出文件都放在此处。
• <skill_dir>：此 SKILL.md 文件所在的目录。使用其绝对路径来引用脚本。

重要：运行脚本时始终使用绝对路径。切勿 cd 到技能目录。

步骤 1：确定财报期

如果用户未指定财报期，使用 WebSearch 查找最新财报：

WebSearch: "{company_name} latest 10-K 10-Q SEC filing"

重要：始终按日期分析最新的财报，无论类型是 10-K 还是 10-Q。

判断逻辑示例：

• 如果最新 10-K 为 2024-12-31，最新 10-Q 为 2025-09-30 → 使用 10-Q（日期更新）
• 如果最新 10-K 为 2025-01-15，最新 10-Q 为 2024-09-30 → 使用 10-K（日期更新）

告知用户：“根据搜索，{TICKER} 最新的财报是 {10-K/10-Q}（截至 {period}），将分析该期财报”

步骤 2：下载财报

python3.11 <skill_dir>/scripts/download_sec_filings.py --ticker <TICKER> --type <10-K|10-Q|6-K> --limit 1 --project-root <project_root>

输出：<project_root>/investment-research/{TICKER}/tmp/sec_filings/cleaned.txt

步骤 3：动态生成分析框架

1. 阅读财报的前 5000 个字符
2. 识别公司所属行业
3. 从 <skill_dir>/industry-analysis-modules.md 中选择模块
4. 与 <skill_dir>/financial-analysis-framework.md 合并
5. 保存到 <project_root>/investment-research/<TICKER>/tmp/analysis-framework-YYYY-MM-DD.md

步骤 4：执行深度研究

Gemini 模式（完整的两阶段分析）：

python3.11 <skill_dir>/scripts/gemini_deep_research.py \
  --input <project_root>/investment-research/<TICKER>/tmp/sec_filings/cleaned.txt \
  --prompt <project_root>/investment-research/<TICKER>/tmp/analysis-framework-YYYY-MM-DD.md \
  --output-dir <project_root>/investment-research/<TICKER> \
  --ticker <TICKER> \
  --company <Company Name> \
  --phase all

Gemini 模式（仅分析本地财报）：

python3.11 <skill_dir>/scripts/gemini_deep_research.py \
  --input <project_root>/investment-research/<TICKER>/tmp/sec_filings/cleaned.txt \
  --prompt <project_root>/investment-research/<TICKER>/tmp/analysis-framework-YYYY-MM-DD.md \
  --output-dir <project_root>/investment-research/<TICKER> \
  --ticker <TICKER> \
  --company <Company Name> \
  --phase local

Gemini 模式（仅进行网络研究，需要本地阶段的输出）：

python3.11 <skill_dir>/scripts/gemini_deep_research.py \
  --input <project_root>/investment-research/<TICKER>/tmp/sec_filings/cleaned.txt \
  --prompt <project_root>/investment-research/<TICKER>/tmp/analysis-framework-YYYY-MM-DD.md \
  --output-dir <project_root>/investment-research/<TICKER> \
  --ticker <TICKER> \
  --company <Company Name> \
  --phase web \
  --phase1-output <project_root>/investment-research/<TICKER>/tmp/phase1-YYYY-MM-DD.md

重要：--phase 只接受三个值：all、local、web。切勿使用 1 或 2 等数字值。

Claude 原生模式： 按照 <skill_dir>/prompts/claude-deep-research-protocol.md 执行完整的 7 阶段流程。

步骤 5：格式化并保存

按照 <skill_dir>/markdown-formatter-rules.md 的要求进行格式化，并保存到 <project_root>/investment-research/{TICKER}/

---

模式 1：Gemini 深度研究

User Input → Download Filing → Framework Generation → Local: Filing Analysis → Web: Market Research → Integration → Final Report
                                                              ↓                         ↓
                                                      (Gemini Deep Research)    (Gemini Deep Research)

• 本地阶段（--phase local）：通过 Files API 上传财报，由 Gemini 进行全面分析
• 网络阶段（--phase web）：通过网络搜索研究竞争对手、趋势并核验管理层信息
• 整合：Claude 根据 <skill_dir>/prompts/report-merge-prompt.md 合并本地与网络研究结果

---

模式 2：Claude 原生深度研究

采用 7 阶段深度研究 + 思维图（GoT） 方法。

完整执行详情，请参阅： <skill_dir>/prompts/claude-deep-research-protocol.md

7 阶段概览

阶段	名称	说明
1	问题界定	明确目标，下载财报
2	检索规划	识别行业，制定研究计划
3	迭代查询	GoT 分支：财务、竞争、行业、管理层、风险
4	信息源交叉验证	交叉验证研究发现
5	知识综合	按框架组织报告
6	质量保证	链式验证
7	输出打包	格式化并保存

GoT 研究分支

分支	方法	重点
A	阅读财报	财务数据分析
B	WebSearch	竞争格局
C	WebSearch	行业趋势
D	WebSearch	管理层信息核验
E	WebSearch	风险因素

---

参考文档

文档	用途
financial-analysis-framework.md	基础分析框架
industry-analysis-modules.md	行业专用模块
markdown-formatter-rules.md	报告格式规则
prompts/claude-deep-research-protocol.md	Claude Native 7 阶段指南
prompts/report-merge-prompt.md	Gemini 模式报告整合

---

输出位置

<project_root>/investment-research/{TICKER}/
├── tmp/
│   ├── sec_filings/cleaned.txt
│   ├── analysis-framework-YYYY-MM-DD.md
│   ├── phase1-YYYY-MM-DD.md             # Local phase (--phase local) output
│   └── phase2-YYYY-MM-DD.md             # Web phase (--phase web) output
└── {TICKER}-Investment-Report-YYYY-MM-DD.md

---

使用示例

• “分析 AAPL 最新的 10-K 年报”
• “深入研究 MSFT 的 10-K 文件”
• “分析 JPM 最新的年报”（自动选择金融模块）
• “研究 PFE 的财务报告”（自动选择制药模块）