analyst-research

analyst-research · 投资研究工作流技能

一套经实地验证、由 AI 辅助的研究工作流，面向投资分析师和政策研究人员，并打包为可复用的 Claude 技能。基于产出《沙特阿拉伯 2030 愿景》深度分析报告的方法论（35 张图表，超过 15,000 字）。提供三种范围模式；用户在触发时选择。

许可：MIT。版权所有 © 2026 Ligen [email protected]。参见 LICENSE。

步骤 0 — 选择模式（加载参考文件前必须完成）

触发此技能时，在加载任何参考文件之前，询问用户选择范围。逐字呈现以下三个选项：

This skill has three scope modes. Pick one based on your project size:

  light    4-5 page decision memo, 0 charts, ~15 min budget
           Single LLM session. Pure markdown footnote citations.
           Use for: exec brief, internal memo, quick decision support.

  medium   12-15 page topic analysis, 6-10 charts, ~1 h budget
           Single LLM. PDF + Word derivations. Sign-off checkpoint after draft.
           Use for: topic deep-dive, board memo with data, same-day analysis.

  heavy    Flagship report 30-40 pages / 15k+ words, 25-35+ charts, ~2-3 h budget
           Single or multi-LLM. PDF + Word + WeChat md + HTML publication.
           Runs the full 11-step staged workflow (framing → sourcing →
           analysis → drafting → review), with 3 sign-off checkpoints.
           Use for: industry deep-dive, macro thesis, policy assessment,
                    flagship investor publication.

Which mode fits your project? (reply with light, medium, or heavy)

如果用户的触发消息已包含明确的范围提示（页数、图表数量、时间预算），则推断模式，并用一句话确认，而不是呈现完整菜单：

“听起来大约需要 10 页和几张图表——中等模式。就按这个来？”

确认模式后，询问一个简短的语言问题：“报告语言——英语（默认），还是其他语言？”（见下方的语言政策）。然后加载该模式对应的参考文件。

各模式的加载顺序

首先始终阅读 references/workflow.md（约 40 行，模式路由文件）。它会指向对应模式的工作流文件。（每份参考文件也有一个 .zh.md 中文镜像；Agent 读取英文 .md 文件。）

轻量模式

1. 必需 references/workflow.md — 概览 + 模式路由
2. 必需 references/workflow_light.md — 6 步框架，仅软性停止点、BLUF 执行摘要、grep 自检
3. 必需 references/_quarto-light.yml — 针对 4-5 页备忘录优化的 Quarto 模板（无目录、不编号章节、脚注引用、正文字号 11pt）
4. 无图表。无参考文献。无 HTML/微信公众号派生内容。跳过 report_style_spec.md 和 chart_template.py。

然后前往 workflow_light.md §1 hypothesis lock，开始 6 步流程。

中等模式

1. 必需 references/workflow.md — 概览 + 模式路由
2. 必需 references/workflow_medium.md — 8 步框架，使用单个 LLM，在草稿完成后设置一个签核检查点
3. 必需 references/report_style_spec.md — 6-10 张图表的视觉规范（chart_template 接口契约、配色方案、字体政策）
4. 必需 references/_quarto-medium.yml — Quarto 模板（脚注引用、无 .bib、正文字号 11pt、宋体 SC 中文字体）
5. 按需 scripts/chart_template.py — 图表样式实现

然后前往 workflow_medium.md §1 onboarding，搭建项目并开始。

重量模式

1. 必需 references/workflow.md — 概览 + 模式路由
2. 必需 references/workflow_heavy.md — 完整的 11 步框架，可选多 LLM，3 个签核检查点（大纲 / 草稿 / 最终稿）
3. 必需 references/report_style_spec.md — 视觉规范，包括 HTML 发布内容派生
4. 按需 scripts/chart_template.py — 图表样式实现
5. 按需 scripts/publication-style-template.html — HTML 发布模板
6. 按需 scripts/author.jpg — HTML 页面的作者照片占位图

重量模式的 Quarto 模板来自 report_style_spec.md §5.1（没有单独的 _quarto-heavy.yml 文件——该规范是重量模式 Quarto 配置的唯一依据）。

然后前往 workflow_heavy.md §1.3 new-project onboarding，搭建项目（将整个 analyst-research/ 文件夹复制到项目根目录）并开始。

模式一览

快速摘要如下；权威信息以 MODE_REGISTRY.md 为准。模式参数发生变化时，请先编辑该文件，再同步更新此处。

维度	light	medium	heavy
输出长度	4-5 页	12-15 页	30-40 页 / 15k+ 字
图表	0	6-10	25-35+
运行时限	~15 分钟	~1 小时	~2-3 小时
大模型	单个	单个	单个或多个大模型
工作流步骤	6	8	11
强制停止点	0	1（草稿后签核）	3（大纲 / 草稿 / 定稿）
衍生输出	PDF + Word	PDF + Word	PDF + Word + WeChat md + HTML
引用	Markdown 脚注	Markdown 脚注	BibTeX + APA
项目脚手架	最小化	最小化	完整（10 个编号目录）
图表模板	不适用	共享（chart_template.py）	共享（chart_template.py）

有关各模式的文件依赖、模式升级路径和回顾章节指引，请参阅 MODE_REGISTRY.md。

不适用此技能的情况

• 单篇新闻评论 → 使用 market-research-skills:topic-brief
• 幻灯片 / PPT → 使用 deckster-slide-generator
• 一次性问答（无需书面报告）→ 直接回答，无需使用技能
• 纯文学或营销文案 → 不属于此技能的适用范围
• 仅涉及工具 / 脚本、不产出报告的项目 → 不属于此技能的适用范围

此技能面向对现有研究和数据进行综合与分析（根据 workflow_heavy.md §2.2，不构建原创模型）。它最适合已有大量研究文献的主题（IMF / World Bank / IEA / BIS、投行和咨询研究、学术论文、监管披露）。机构研究覆盖有限、由新闻驱动的前沿主题并不适合。

如何在项目中途扩大或缩小范围

如果项目从 light 模式开始，而你发现需要更深入的分析，请在 medium 模式下重新触发此技能——工作流的第一步相同（锁定假设），因此早期工作可以沿用。从 medium 升级到 heavy 也是如此。缩小范围更困难（你已经投入精力搭建脚手架）；与其重新执行，不如删减交付物。

项目脚手架位于技能之外

此技能在 ~/.claude/plugins/.../analyst-research/ 中保持只读。每个项目的产物都存放在用户的项目目录中。

对于 light 模式，此技能只会在项目中创建 _quarto.yml（从 _quarto-light.yml 复制）和一个工作文件。不创建子文件夹。

对于 medium 模式，此技能会创建 _quarto.yml（从 _quarto-medium.yml 复制）、5_scripts/_path.py（用于加载 chart_template 的 sys.path 注入器），以及最精简的编号输出目录。

对于 heavy 模式，此技能会将整个 analyst-research/ 文件夹复制到项目根目录，作为本地工作副本，然后根据 workflow_heavy.md §11 创建完整的 10 个编号目录脚手架。这样，项目级覆盖设置（配色、字体、领域惯例）就可以保存在本地副本中，而不会污染技能本身。

技能演进

每个项目结束后，请按照相应模式工作流文件中的回顾章节（workflow_heavy.md §9、workflow_medium.md §8、workflow_light.md §6），决定将哪些项目经验回馈到技能本身。此技能使用 git 进行版本管理；每次升级次版本号。重大架构变更则升级主版本号。

语言政策

此技能遵循市场惯例，采用双语（英语 + 中文）。每份编写的文档都有两个文件：英语 .md（例如 SKILL.md、references/workflow_heavy.md）和中文镜像 .zh.md（例如 SKILL.zh.md、references/workflow_heavy.zh.md）。**英语是唯一事实来源；.zh.md 是同步翻译，而非独立版本。**编辑流程，不得例外：**始终先编写或修改英语 .md，然后在同一变更集中将相同修改同步到 .zh.md 翻译。**切勿只编辑中文，也不要让两个版本出现差异；措辞冲突时，以英语 .md 为准。

1. **对话回复遵循用户使用的聊天语言。**英语聊天 → 用英语回复；中文聊天 → 用中文回复；其他语言也同理。这是运行时行为，不是存储的内容。
2. **报告语言默认为英语。**在步骤 0 / 入门阶段，选定模式后，简短询问一个问题：“报告语言——英语（默认），还是其他语言？”如果用户未指定，就用英语撰写草稿；如果用户指定了其他语言，就使用该语言。将此选择记录在项目的 CLAUDE.md 中。此规则取代任何旧的“草稿遵循假设语言”规则。
3. **按语言设置 grep 红线。**对于英语报告，跳过中文冒号比例红线，并强制执行未转义 $ 红线（金额中的美元符号需转义为 \$）。对于中文报告则反之。

此文件的中文镜像为 SKILL.zh.md。中文版见 SKILL.zh.md。