mcpField
C
company-deep-dive

company-deep-dive

github.com/nimbleway生产力6191 次安装2 天前更新
代码仓库

关于 company-deep-dive

company-deep-dive 是用于 Claude Code 的单家公司研究技能,涵盖财务、产品、领导团队、新闻和市场地位。它借助 Nimble 网络数据 API 搜集资料,并可基于本地记忆更新既有研究。

主要功能

  1. 01覆盖五个公司研究维度
  2. 02搜索并提取网络资料
  3. 03使用 WSA 丰富研究结果
  4. 04根据已存研究更新报告
  5. 05将公司档案和报告存入记忆

适用场景

  1. 01撰写全面的公司研究报告
  2. 02更新已有研究的最新发现
  3. 03梳理融资、产品、领导团队、新闻及市场地位

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nimbleway/agent-skills --skill company-deep-dive

安装后在 Claude Code 中输入/company-deep-dive确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
dimension-agent-prompt.md
memory-and-distribution.md
nimble-playbook.md
profile-and-onboarding.md

详细介绍

公司深度研究

借助 Nimble 的网络数据 API,开展 360° 公司研究。

用户请求:$ARGUMENTS

运行任何命令之前,请阅读 references/nimble-playbook.md,了解 Claude Code 的限制(无 shell 状态、禁止使用 &/wait、子 Agent 权限、沟通风格)。


说明

步骤 0:预检

遵循 references/nimble-playbook.md 中的传输方式选择和标准预检流程:在会话开始时选择 CLI 或 MCP,然后并行运行标准预检调用(日期计算、今天、个人资料、记忆索引)。

根据结果:

  • CLI 缺失或未设置 API 密钥 → 查看 references/profile-and-onboarding.md,然后停止
  • 为所有 nimble CLI 调用添加标记:nimble --client-source nimble-agent-skills <subcommand>。MCP 请求在传输层进行归因,详见 references/nimble-playbook.md。
  • 存在个人资料 → 记录以供参考(公司名称有助于确定研究方向)。阅读 ~/.nimble/memory/companies/index.md,检查目标公司是否已有 过往研究。按照 [[path/entity]] 交叉引用加载相关背景信息。
    • 存在过往研究:加载该研究。以更新模式运行——重点关注自上一份报告日期以来的新信息。告知用户:“我有一份 [Company] 的过往研究,日期为 [date]。正在根据最新数据更新。”
    • 不存在过往研究:以完整模式运行——全面覆盖所有维度。
  • 不存在个人资料 → 没关系。公司深度研究不需要完成引导(与竞品情报不同)。直接进入步骤 1。
步骤 1:确定目标公司

从 $ARGUMENTS 或用户消息中解析目标公司。

如果明确(例如,“研究 Stripe”“介绍一下 Datadog”):

  • 提取公司名称
  • 同时运行两个 Bash 调用以确认公司身份:
    • nimble search --query "[Company] official site" --max-results 3 --search-depth lite
    • nimble search --query "[Company] company overview" --max-results 5 --search-depth lite
  • 简要确认:“正在研究 [Company]([domain])……”

如果有歧义(例如,“研究 Mercury”——可能指银行、汽车或其他公司):

  • 提出一个澄清问题,并列出最可能的候选项

如果缺少目标——询问:“您想让我研究哪家公司?”

选择研究范围——如果用户未指定深度,默认进行完整深度研究。 如果用户说“快速概览”“简要介绍”或“摘要”,则运行快速模式,跳过深度提取步骤并生成较短的报告。

步骤 2:发现 WSA

发现目标公司域名可用的 WSA。同时运行以下两项搜索:

nimble extract:templates list --limit 100  # then filter items for "{company-domain}"
nimble extract:templates list --limit 100  # then filter items for "{company-name}"

根据结果,筛选 entity_type 为 SERP 或 PDP 的 WSA,并优先选择 managed_by: "nimble" 的 WSA。使用 nimble extract:templates get --extract-template-name {name} 验证每个 WSA,然后缓存本次运行发现的 WSA 名称和参数。将其传递给步骤 3 中的维度 Agent,以便结合 nimble search 进行信息补充。如果未发现 WSA,则仅使用 nimble search 继续。

步骤 3:跨维度并行研究(子 Agent)

阅读 references/dimension-agent-prompt.md,了解完整的 Agent 提示词模板。 遵循 references/nimble-playbook.md 中的子 Agent 启动规则 (bypassPermissions、每批最多 4 个、明确的 Bash 指令,以及失败时的备用方案)。

使用 mode: "bypassPermissions" 启动 nimble-researcher Agent(agents/nimble-researcher.md)。 每个 Agent 负责研究公司一个维度。 将步骤 2 中发现的 WSA 名称传给每个 Agent,让它们在使用 nimble search 的同时,也能利用这些名称补充信息。

重要: Nimble API 的速率限制为每个 API 密钥每秒 10 次请求。每个 Agent 会并行执行 4-5 次搜索,因此每批同时运行的 Agent 不要超过 2 个,以免超出限制。概览搜索应单独作为一个阶段运行,不要与 Agent 批次同时执行。

调用量估算与扩展执行: 启动 Agent 前,估算 API 调用总量:2 次概览搜索 + 每个 Agent 约 5 次搜索 × 5 个 Agent = 约 27 次调用。对于 11 次或更多调用,每个 Agent 应使用 extract-batch 或 agent run-batch,而非单独调用。有关层级选择,请参阅 references/nimble-playbook.md 中的扩展执行模式。

阶段 A — 概览搜索(在 Agent 启动前直接运行):

  • nimble search --query "about" --include-domain '["[domain]"]' --max-results 3 --search-depth lite
  • nimble search --query "[Company] Wikipedia OR Crunchbase OR Pitchbook" --max-results 5 --search-depth lite

这些搜索可提供基础背景信息(成立日期、总部、员工人数、使命),为所有维度的发现提供背景。

阶段 B — 第 1 批(同时运行 2 个 Agent):

Agent维度重点
1融资与财务融资轮次、估值、营收信号、投资者、财务状况
2产品与技术产品、技术栈、近期发布、工程博客、开源项目

阶段 C — 第 2 批(同时运行 2 个 Agent):

Agent维度重点
3领导层与团队创始人、高管、重要新员工、离职人员、团队规模、文化信号
4近期新闻与活动媒体报道、公告、合作、奖项、会议

阶段 D — 第 3 批(1 个 Agent):

Agent维度重点
5市场定位竞争对手、市场份额、定位、分析师报道、客户评价

刷新模式调整: 如果已有先前的研究结果,将已知事实作为背景传给每个 Agent,让它们聚焦于新信息。Agent 应使用 --start-date 仅筛选近期数据。

备用方案: 如果任何 Agent 失败或返回空结果,请直接在主上下文中运行相应维度的搜索。不要让报告留下信息缺口。

步骤 4:深度提取

根据所有 Agent 的结果,找出跨维度最具信息量的 5-8 个 URL。优先选择:

  • 含有具体金额的融资公告
  • 官方产品/功能页面
  • 高管访谈、播客节目或会议演讲
  • 深度分析师报道或记者专访
  • 公司自己的关于/团队页面

每个 URL 调用一次 Bash,并同时执行所有调用:

nimble extract --url "https://..." --format markdown

提取失败时,请遵循 references/nimble-playbook.md 中的备用方案。

快速模式: 完全跳过此步骤。仅根据搜索摘要撰写报告。

WSA 信息补充: 如果步骤 2 中发现了 WSA,请在使用 nimble extract 前,先用它们对关键 URL 进行更丰富的提取。

第 5 步:综合报告

将输出整理为一份 360° 公司报告:

# [Company Name] — Deep Dive
*As of [today's date]*

## Quick Assessment
[2-3 sentence verdict: what this company is, where they stand, and the one thing
that matters most right now. This is the "if you read nothing else" paragraph.]

## Company Overview
- Founded: [year] | HQ: [location] | Employees: [estimate]
- Domain: [domain] | Industry: [industry]
- Mission/focus: [one line]

## Funding & Financials
[Latest round, total raised, key investors, valuation signals, revenue indicators.
Every claim dated and sourced.]

## Leadership & Team
[Founders, C-suite, notable recent hires or departures. Executive perspectives
on company direction — direct quotes when available from interviews or talks.]

## Product & Technology
[Core products, recent launches, tech stack signals, engineering culture,
open-source contributions. What they're building and how.]

## Market Position
[Key competitors, differentiation, market share signals, analyst perspectives,
customer sentiment from reviews (G2/Capterra/Reddit).]

## Recent News & Events
[Chronological, most recent first. Each entry dated with source.]

## Strategic Outlook
[Synthesis across all dimensions: where the company is heading, key risks,
growth signals, and strategic bets. This is insight, not summary.]

## Sources
[Numbered list of all URLs cited in the report]

核心规则:

  • 每项事实性陈述都必须标注日期和来源 URL。
  • 先呈现快速评估——大多数读者只会读到这里。
  • 对于没有相关信息的维度,请说明“未找到公开数据”,不要猜测。
  • 区分已确认的事实与推断出的信号。
  • 高管引语能提升可信度——找到采访、财报电话会议或大会演讲中的直接引语时,请将其纳入报告。
  • 在刷新模式下:完整报告各部分之前,先列出“自 [上次日期] 以来的新动态”。
第 6 步:保存到记忆

同时执行所有 Write 调用:

  • 报告 → ~/.nimble/memory/reports/company-deep-dive-[date].md
  • 公司资料 → ~/.nimble/memory/companies/[company-name-slug].md (使用 references/memory-and-distribution.md 中的格式)。为发现的关键人物(例如 [[people/jane-smith]])、 同一领域的竞争对手(例如 [[competitors/widgetco]])及其他相关实体添加 [[path/entity]] 交叉引用。
  • 如果资料已存在 → 在 ~/.nimble/business-profile.json 中更新 last_runs.company-deep-dive
  • 遵循 references/memory-and-distribution.md 中的 wiki 更新模式:更新所有受影响实体文件在 index.md 中的行,并在 log.md 中追加本次运行的记录。

companies/ 中的公司资料应包含结构化关键事实(概述、财务状况、领导团队、产品),以便未来运行任何需要了解该公司背景的技能时加载。

第 7 步:分享与分发

务必提供分发选项——不要跳过此步骤。 遵循 references/memory-and-distribution.md 中的连接器检测、分享流程和来源链接要求。

第 8 步:后续跟进
  • 深入了解某个维度 → 针对该主题进行聚焦搜索
  • 与另一家公司进行比较 → 并列分析
  • “特定主题怎么样?” → 定向搜索并提取信息
  • “看起来不错” → 完成

相关技能建议:

后续步骤:

  • 运行 competitor-intel,持续追踪这家公司作为竞争对手的动态
  • 如果你要与这家公司的某人会面,运行 meeting-prep
  • 运行 competitor-positioning,分析对方与你方的宣传信息

Agent 团队模式(双模式)

启动时检查:echo $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS

团队模式(已设置标志):启动 3 位队友,而非子 Agent。每位队友负责相关维度,并可互相发送消息,交叉核实发现。

队友维度交叉核实对象
财务与新闻融资、收入、近期新闻、活动市场(估值与定位)
产品与领导团队产品、技术栈、创始人、关键新员工财务(战略转向与融资)
市场竞争对手、定位、评价、分析师产品(差异化主张)

负责人(你):创建共享任务,等待所有队友完成,然后综合形成最终报告。当一位队友发现某项主张需要另一位队友核实(例如,某笔融资金额可能意味着某个估值)时,应为相关队友创建任务。

单人模式(未设置标志):采用第 3 步中的标准子 Agent 流程。


本技能不是什么

  • 不是竞争对手监控。 如需长期追踪多个竞争对手,请使用 competitor-intel。本技能深入研究一家公司。
  • 不是会议准备。 如需研究你将会见的人,请使用 meeting-prep。 本技能研究的是公司,而非个人。
  • 不是财务建议。 本技能从公开来源收集信息,不提供投资分析或尽职调查认证。
  • 不是实时监控。 本技能生成的是特定时间点的报告。如需持续追踪,请稍后再次运行,或将公司添加到 competitor-intel 中。

错误处理

标准错误表(缺少 API 密钥、429、401、结果为空、提取内容杂乱)请参阅 references/nimble-playbook.md。本技能特有的错误:

  • 搜索 500: 重试一次,不带 --focus 标志。如果仍然失败,则使用简化后的查询重试(缩短关键词,不加日期筛选)。记录失败情况,但不要跳过该维度。
  • 搜索超时: 重试一次,然后跳过该调用并继续——与操作手册的超时策略一致。
  • 未找到公司: 使用域名、其他名称或母公司重试
  • 某个维度的结果为空: 注明“未找到公开数据”——不要推测

评论

支持 Markdown