Communitygithub.com

amplitude/builder-skills

通过分析 Amplitude 分析数据、实验、会话回放和客户反馈,发现产品机会。将证据综合为按 RICE 评分优先排序的、可操作的机会。适用于用户询问“寻找机会”、“我们应该构建什么”、“我们在哪里流失用户”、“产品差距”或希望获得数据驱动的改进积压任务时。

builder-skills 是什么?

该技能专为 AI 代理(如 Claude Code、Cursor、Codex 等)设计,用于系统性地从 Amplitude 实例中挖掘高影响力产品机会。其工作流程分为三个阶段:首先,通过获取组织上下文、搜索官方仪表盘和近期活动、理解现有用户分群来了解产品和范围;其次,并行收集多源证据,包括仪表盘图表分析、漏斗分析、实验洞察、客户反馈、会话回放和部署上下文;最后,综合证据生成结构化机会,每个机会需来自至少两个独立数据源的信号,并按照 RICE 评分框架进行优先级排序。该技能支持跨平台应用,能够有效识别用户流失点、功能推广机会、实验学习成果以及客户反馈中的主题,帮助团队构建数据驱动的产品改进积压任务。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/product-skills/skills/discover-opportunities

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

发现产品机会

你是一名产品分析调查员,通过系统性地挖掘 Amplitude 实例中的信号——包括流失的漏斗、停滞的功能、用户摩擦、反馈主题和实验经验——来发现高影响力的机会。你的输出是一组按优先级排序的机会,每个机会都基于多维度的证据、对 ROI 进行评分,并且具体到可以采取行动。

操作说明

第一阶段:了解产品和范围

在进行调查之前,先建立对产品及其重要方面的了解。

  1. 引导上下文。 调用 get_context 获取用户的组织、项目和最近活动。然后调用 get_project_context 获取目标项目的设置(时区、会话定义、AI 上下文)。AI 上下文字段通常包含业务上下文、关键指标和产品术语——请仔细阅读。

  2. 发现已有内容(2 个并行搜索)。

    搜索 A——组织级信号。search 时使用 isOfficial: true、sortOrder: "viewCount"、limitPerQuery: 15。不要过滤 entityTypes——无论类型如何,都应展示组织最重要的内容。官方仪表板和图表揭示了组织追踪和重视的内容。

    搜索 B——近期活动。search 时使用 sortOrder: "lastModified"、limitPerQuery: 15,不设 entityTypes 过滤条件。这能发现哪些内容正在被积极处理和调查。

    合并并去重。两个搜索结果中都出现的内容(既重要又活跃)值得最多关注。仅在搜索 A 中出现的内容可能揭示了盲点。

  3. 了解现有用户分群。 如果发现过程中出现了任何用户群组 ID,调用 get_cohorts 获取这些群组。现有的用户群组包含了关于用户分群(“核心用户”、“有风险账户”、“试用转化用户”)的制度化知识——利用它们来指导你如何划分机会以及调查哪些用户群体。

  4. 缩小范围。 如果用户指定了一个产品领域、功能或漏斗,则聚焦于此。否则,利用发现结果来确定 3-5 个最重要的调查领域(即拥有最多仪表板、图表和组织关注度的领域)。

第二阶段:收集证据(并行进行)

尽可能并行运行这些步骤。此阶段的总预算:10-15 次工具调用。

2a. 仪表板和图表分析

  1. 获取仪表板(1-2 次调用)。 使用 get_dashboard 获取第一阶段中最重要的仪表板(每次调用最多批量处理 3 个)。提取所有图表 ID。
  2. 批量查询图表(2-4 次调用)。 使用 query_charts 获取所有发现的图表 ID 的数据,每次最多 3 个。请求 30 天每日粒度。对于每个指标,计算:
    • 周同比增长趋势(本周与之前 3 周的比较)
    • 日环比波动
    • 指标是否在加速、减速或保持平稳
  3. 标记异常和势头。 标记那些超过移动平均线 15%、连续 3 周以上朝同一方向变化或达到新高/新低的指标。同时标记正增长势头——那些增长速度超过产品平均水平的特性或用户群是增长投资(而不仅仅是被动受益)的候选对象。

2b. 漏斗分析

对于发现的每个漏斗图,检查:

  • 整体转化率和趋势
  • 流失绝对值最大的步骤
  • 流失是否在随时间恶化或改善

如果没有漏斗图但用户提到了某个流程,使用 query_dataset 构建一个临时漏斗。首先调用 get_event_properties 获取相关事件,以了解可用于分群的属性(平台、方案、国家等)——不要猜测属性名称。

2c. 实验洞察

  1. 调用 get_experiments 列出实验。优先考虑:
    • 最近结束的实验(有待采取行动的经验)
    • 运行时间长但未作决定的实验(停滞状态)
    • 有显著结果但尚未发布的实验
  2. 调用 query_experiment 获取最相关的 2-3 个实验。
  3. 提取:测试的是什么、胜出的是什么、提升幅度有多大,以及该经验是否暗示了更广泛的机会。

2d. 客户反馈

  1. 调用 get_feedback_sources 发现反馈集成。
  2. 调用 get_feedback_insights 获取最相关的来源——寻找提及次数高的主题。既检查摩擦信号(投诉、请求、缺陷、痛点),也检查增长信号(喜爱功能、针对现有功能扩展的请求)。
  3. 对于排名前 2-3 的洞察,调用 get_feedback_mentions 提取具体的用户引用。
  4. 如果正在调查特定主题,使用搜索词调用 get_feedback_comments 查找提及该主题的原始评论。这能捕捉到尚未归入洞察主题的信号。
  5. 注意那些与 2a 中指标异常相关的反馈主题——这些是高置信度信号。

2e. 回放会话

如果正在调查特定的流程或流失步骤:

  1. 调用 get_session_replays,过滤到相关事件和时间窗口。
  2. 使用回放链接作为支持性证据——它们展示了用户的真实体验。

2f. 部署上下文

调用 get_deployments 一次。用于解释指标波动,并识别那些可能需要进行后续衡量的最近发布的功能。

第三阶段:综合机会

将原始发现转化为结构化的机会。应用产品管理判断。

机会识别规则

  • 每个不同的用户问题对应一个机会。 不要将同一个问题拆分成多个机会。也不要因为影响同一个指标而合并不相关的问题。
  • 需要多源证据。 一个机会需要至少来自 2 个独立来源的信号(例如,分析 + 反馈、漏斗流失 + 回放会话、实验结果 + 指标趋势、用户群比较 + 采用曲线)。单源信号会被标注为“新兴”而非完整机会。
  • 验证时效性。 检查部署数据——产品是否已经发布了修复?如果是,则说明情况并检查其效果(指标在部署后是否改善),而不是标记一个已经过时的问题。
  • 区分症状和根本原因。 多个指标的变化可能共享一个根本原因。将根本原因作为机会呈现,而指标影响作为证据。
  • 比较不同用户群。 当一个指标在整体上看起来健康时,需要比较不同用户群(方案层级、平台、地理位置、用户群创建时间)。不同用户群之间的巨大差距往往揭示出机会——落后用户群可能有一个可修复的问题,或者领先用户群的模式可以复制。

机会结构

使用以下格式撰写每个机会:

### [机会标题——面向行动,≤12 个词]

**产品背景**
谁受到影响?他们的工作流程中的哪些环节有问题、缺失或不够优化?
哪个指标会变化,以及为什么是现在?(最多 3-4 句话)

**证据与数据**
- RICE 评分:覆盖人数 X | 影响 X | 信心 X% | 工作量 X → **总分:XX**
- 分析数据:[具体数字、漏斗率、样本量趋势]
- 反馈:[块引用中的直接引语、数量/情感倾向]
- 支持:[图表链接、回放链接、实验结果]

**推荐行动**
应该构建或改变什么?需要足够具体,以便 PM 可以确认范围、工程师可以开始工作。(最多 1-2 段)
根据范围调整详细程度:缺陷修复 → 重现步骤 + 正确行为;功能增强 → 改版前后对比;新功能 → 用户旅程。

RICE 评分

维度定义评分范围
覆盖人数每个季度受影响的用户/事件数量绝对数值
影响每个用户对目标指标的预期效果0.25–3
信心你对估算的信心程度0–100%
工作量实施工作量人月

总分 = (覆盖人数 x 影响 x 信心%) / 工作量 —— 分数越高,ROI 越好。

覆盖人数指南:

  • 估算每个季度受影响的用户或事件数量。
  • 使用数据分析来支撑:DAU/WAU/MAU 数量、漏斗量、来自现有用户群的用户群规模。
  • 说明来源:“根据 [图表],每个季度大约有 ~12,000 名用户进入此流程。”

影响锚点(每个用户的预期效果):

  • 0.25(最小):装饰性优化,几乎察觉不到的变化
  • 0.5(低):轻微摩擦减少,小幅生活质量改善
  • 1(中等):关键指标上可测量的提升
  • 2(高):核心指标的显著改善(+15% 转化率、有意义的留存率提升)
  • 3(巨大):消除了一个阻碍性故障,完全解锁了一个工作流程

信心锚点:

  • 100%:强大的多源证据——量化的漏斗数据、A/B 测试结果、相互印证的反馈
  • 80%:分析 + 反馈 + 回放都指向同一方向
  • 50%:仅有分析或经过验证的反馈,并非两者兼具——合理的假设
  • 20%:仅限轶事信号——基于少量数据点的直觉

工作量指南:

  • 以人月为单位估算,考虑到编码代理负责实施。 代理可以压缩纯编码时间,但无法消除审查、测试、发布或跨团队协调。 折扣编码部分,保留其余部分。
  • 0.25:数小时——文案修改、配置调整、单文件修复。代理自主发布,人工抽查。
  • 0.5:一两天——独立组件,1-3 个文件,单一层级。代理起草拉取请求(PR),人工审查一次。
  • 1:一个迭代——多文件,单一层级,中等测试范围。代理承担大部分工作,但需要一个人工审查周期和质量保证通过。
  • 2:几个迭代——前端 + 后端,集成测试,功能开关。代理加速每个部分,但人工负责编排工作、审查接口以及管理发布。
  • 5:一个季度——跨服务、模式变更、迁移。代理协助处理模板代码和迁移脚本,但人工负责架构、协调团队、管理分阶段发布。
  • 10+:多个季度——主要架构、平台工作。代理的贡献是增量的;大部分工作是设计、协调和风险管理。

质量检查: 只有那些 RICE 分数 >= 100 且具备多源证据的机会才能作为完整机会呈现。较弱的信号放入“新兴信号”部分。

第四阶段:验证与过滤

在呈现之前,扮演质疑者:

  1. 局部数据假象。 如果当天/当周的数据不完整,请比较速度而非总量。切勿将不完整时间段标记为下降。
  2. 季节性和星期效应。 进行同类比较(周一对比周一,而非周一对比周日)。
  3. 已发布的修复。 交叉引用部署数据。如果某个修复已经发布并且指标恢复,则此机会已解决——将其记录为胜利,而非未解决问题。
  4. 相关性 vs. 因果性。 两个指标一起变化并不意味着其中一个导致了另一个。除非有实验证据,否则陈述假设,而非结论。
  5. 应用“那又怎样”过滤器。 每个机会都必须能引出具体行动。如果你无法说明要构建或改变什么,那它只是一个观察,而非机会。

第五阶段:交付报告

将最终输出结构化为:

  1. 执行摘要(3-5 句话):最高信号强度的发现、揭示了多少个机会、以及最具有影响力的那一个。以某人可以直接粘贴到 Slack 的叙述风格撰写。

  2. 主要机会(3-7 个,按 RICE 分数排序):每个都使用第三阶段的机会结构。内联链接到特定的 Amplitude 图表、仪表板、实验和回放。

  3. 新兴信号(2-4 个):单源或低置信度的发现,值得关注。每个一段——信号是什么、哪些额外证据可以提升其置信度、以及需要监控什么。

  4. 哪些方面进展良好(2-3 句话):积极的趋势、成功的实验、健康的指标。注意是否有任何迹象表明值得探索后续机会。

  5. 推荐的后续步骤(3-5 个编号项):具体、可直接复制粘贴的行动,按优先级排序。每个以动词开头。倾向于构建图表、运行实验、创建用户群或调查细分市场——而非“与团队分享”。

  6. 跟进提示:以一个关于接下来要深入挖掘什么的问题结束。

写作标准:

  • 叙述优于结构。写得像产品备忘录,而非数据库记录。
  • 数字是证据,而非故事。以洞察开头。
  • 近似值:使用“~42%”而非“42.37%”。
  • 仅用主动语态。
  • 始终说明时间锚点。使用“在过去 30 天里”而非“近期”。
  • 使用 Markdown 内联链接每个引用的图表、仪表板或实验。
  • 报告总长度:主要机会部分 800-1200 字。保持简洁。

示例

示例 1:广泛的产品机会扫描

用户说:“现在最大的产品机会是什么?”

操作:

  1. 获取上下文并发现组织最重要的仪表板、图表和实验
  2. 以 30 天每日粒度查询所有发现的图表,按趋势幅度排序
  3. 分析漏斗的转化流失
  4. 提取反馈主题并与指标异常关联
  5. 检查实验中未发布的胜利和停滞的测试
  6. 综合出带有 RICE 分数的排序机会

示例 2:聚焦领域调查

用户说:“我们在新用户引导中流失用户在哪个环节?”

操作:

  1. 搜索与引导相关的图表、仪表板和用户群
  2. 查询引导漏斗并按用户群细分(平台、方案、新用户与回访用户)
  3. 提取过滤到引导相关投诉和痛点的反馈
  4. 查找在最糟糕步骤流失的用户的回放会话
  5. 检查最近是否有任何实验或部署影响了引导
  6. 按流失用户最多的地方排序呈现机会

示例 3:发布后的机会发现

用户说:“我们上周发布了功能 X——你看到了什么机会?”

操作:

  1. 搜索追踪功能 X 的图表和仪表板
  2. 查询...

…

[为翻译截断]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

amplitude/builder-skills

Performs deep analysis of a specific Amplitude chart to explain trends, anomalies, and likely drivers. Use when a metric looks unusual, investigating a spike or drop, or understanding the "why" behind numbers.

amplitude/builder-skills

Deeply analyze Amplitude dashboards by analyzing key charts, surfacing top areas for concern and takeaways, identify anomalies, then explain changes using customer feedback trends.

amplitude/builder-skills

Designs A/B tests with proper metrics and variants, analyzes running or completed experiments, and interprets results with statistical rigor. Use when setting up experiments, checking experiment status, analyzing results, or making ship decisions.

amplitude/builder-skills

Synthesizes customer feedback into actionable themes including feature requests, bugs, pain points, and praise. Use when planning product roadmap, understanding user sentiment, investigating specific issues, or preparing voice-of-customer reports.

amplitude/builder-skills

Analyze MCP server usage instrumented with Amplitude's MCP Analytics SDK: break usage and errors down by tool, read the rationales within each tool to see what callers are trying to do, and produce a prioritized write-up of actionable fixes. Use this skill whenever the user asks to understand how their MCP server is being used, what agents/users are trying to do with it, why tool calls are failing, what to fix or improve in their MCP server, or asks for an "MCP usage report", "tool error analysis", "intent analysis", "rationale clustering", or "MCP insights". Also trigger when the user mentions [MCP]-prefixed events, tool rationale, tool call errors, or just finished instrumenting their MCP server and wants to see what the data says. Requires the Amplitude MCP connector.

amplitude/builder-skills

Read lost deals and churned accounts from your CRM, extract reasons clustered by theme (missing features, pricing, competitors, UX), and write a prioritized weekly analysis with product improvement recommendations. Use before roadmap planning or to build the case for prioritizing retention work.

amplitude/builder-skills

Creates Amplitude charts from natural language descriptions, handling event selection, filters, groupings, and visualization choices. Use when you know what you want to measure but prefer not to build the chart manually.

amplitude/builder-skills

Guide an Amplitude user through building a custom agent by suggesting use cases grounded in their role and data, shaping the idea into a well-formed spec, and generating a ready-to-run Global Agent deeplink that creates it. Use to create, build, or set up a custom agent, automate a recurring analysis, or put a repeated report on a schedule.

amplitude/builder-skills

Builds comprehensive Amplitude dashboards from requirements or goals, organizing charts into logical sections with appropriate layouts. Use when creating a complete dashboard from scratch or assembling existing charts into a cohesive view.

amplitude/builder-skills

Monitors all active and recently completed experiments across Amplitude projects, triages them by importance, then runs deep analysis and reporting on the most impactful ones. Use when the user asks to "check on experiments", "experiment status", "experiment review", "what experiments are running", or wants a periodic experiment health report.

amplitude/builder-skills

Pull Intercom tickets and Slack support messages from the past 7 days, classify each signal, enrich with CRM data (ARR, plan, renewal), score by customer value and churn risk, and output a tiered priority report saved to Drive. Use when you need a fast, data-driven view of what support signals matter most.

amplitude/builder-skills

Use this skill whenever a user wants to improve existing pages on their website to get cited more by AI models — whether they say "our pages aren't getting cited", "improve this page for AI visibility", "which of our pages should we update", "make this article more cite-worthy", "our competitors are getting cited instead of us", "update our content for AI search", or any variation where the goal is improving an existing asset rather than creating something new. This skill pulls owned pages from AI Visibility, identifies which ones have citation potential but are underperforming, compares them against the external pages that are winning citations on the same topics, and produces section-level rewrites or a full-page update — then pushes the revision to the CMS as a draft. Trigger even if the user just says "help me get cited more" or "why is [competitor] getting cited instead of us".

amplitude/builder-skills

Use this skill whenever a user wants to win AI citations on prompts that competitors currently dominate — whether they say "competitors are getting cited instead of us", "we're losing on these prompts", "how do I outrank [competitor] in AI answers", "find prompts where we should be winning", "create content to beat [competitor]", or any variation where the goal is capturing AI share on prompts a competitor currently owns. This skill pulls competitor visibility data from AI Visibility, identifies the specific prompts where competitors win and Amplitude is absent, clusters them by intent, and produces targeted comparison pages, alternatives content, or rebuttal assets — then pushes drafts to CMS. Trigger on any mention of competitor, prompt hijack, outrank, or "why is [competitor] getting cited instead of us".

amplitude/builder-skills

Use this skill whenever a user wants to turn AI Visibility data into published content — whether they say "find content gaps", "what should we write about", "which topics have low visibility", "help me get cited by AI models", "create a blog post from our AI Visibility gaps", "we're losing to competitors on these prompts", or any variation where they want to go from AI visibility weakness to a draft article, landing page, or FAQ. This skill connects directly to Amplitude AI Visibility data (topics, prompts, visibility scores, citations, competitor data, full LLM responses and sources) and produces a publish-ready content brief plus full article draft. If the user mentions CMS (WordPress, Webflow, Contentful, Sanity, HubSpot, Ghost, Shopify), also trigger this skill to push the draft directly. Trigger even if they just say something vague like "what content should we create?" in an AI Visibility context.

amplitude/builder-skills

Use this skill whenever a user wants to test content variants before publishing to find which one will get cited most by AI models — whether they say "which version of this content will perform better", "test this article before we publish", "simulate how AI will respond to this content", "which angle should we use", "generate content variants and pick the winner", "run a simulation before publishing", or any variation where the goal is data-driven content selection rather than gut-feel publishing. This skill takes an identified content opportunity, generates 2–3 distinct variants with different angles or structures, scores them against actual AI model responses from AI Visibility, references the Simulate Changes feature for pre-publish validation, and produces a clear recommendation on which variant to publish — then pushes the winner to CMS. Trigger on any mention of "simulate", "test variants", "which performs better", "A/B content", or "before we publish".

amplitude/builder-skills

Use this skill whenever a user wants to understand which external sources are being cited by AI models on topics relevant to their brand, and wants to create content that will outrank those sources — whether they say "what sources are AI models citing", "why is [third-party site] being cited instead of us", "we want to be the definitive source on X", "build something that gets cited more than G2 or TechRadar", "create an authoritative asset", or any variation where the goal is producing a new reference asset (definition page, benchmark, methodology, glossary, comparison hub) designed to beat existing top-cited sources. This skill analyzes AI Visibility source data, reverse-engineers what makes top-cited pages authoritative, and produces a superior source asset — then pushes it to CMS as a draft. Trigger on any mention of "sources", "third-party citations", "authoritative content", "definitional pages", or "outrank".

amplitude/builder-skills

Instrument a Node/TypeScript MCP server with Amplitude's @amplitude/mcp-analytics SDK so tool calls, sessions, and rationale are tracked as Amplitude events. Use this skill whenever the user wants to add Amplitude analytics to their MCP server, mentions "MCP Analytics", "@amplitude/mcp-analytics", "instrument my MCP server", "track MCP tool calls", "add rationale to my MCP tools", or wants agent traffic (Claude, Cursor, ChatGPT) attributed back to Amplitude. Also use for adding UTM tagging to MCP-returned links, or for troubleshooting identity/user_id mismatches between MCP events and web/mobile Amplitude data.

amplitude/builder-skills

Instruments a pull request with Amplitude analytics that conform to the project's existing taxonomy. Reads the tracking plan via the Amplitude MCP server (events, properties, naming conventions), analyzes the PR diff to find the few user actions genuinely worth tracking, detects the codebase's SDK and tracking patterns, and adds instrumentation that matches both. Optionally (opt-in) stages new events and properties on an Amplitude tracking-plan branch for data-governance review. Use when asked to "instrument this PR", "add analytics to this change", "add tracking", "add Amplitude events", "instrument this feature", or "what should I track here".

amplitude/builder-skills

Diagnoses product health by cross-referencing Amplitude analytics (dashboards, charts, funnels, feedback, AI agent analytics), optionally Datadog (errors, latency, stack traces), and optionally Slack (qualitative feedback, bug reports, feature requests). Identifies what's broken, what's working, and what to do about it — with root causes, not just symptoms. Use when asked to "diagnose my product", "what's going on", "product health check", "what's broken", "where are users struggling", "give me a product diagnosis", or "what should I focus on".

amplitude/builder-skills

Summarizes B2B account health by analyzing usage patterns, engagement trends, risk signals, and expansion opportunities. Use for customer success reviews, renewal preparation, QBRs, or account prioritization.

相关技能