Communitygithub.com

amplitude/builder-skills

透過交叉比對 Amplitude 分析數據(儀表板、圖表、漏斗、回饋、AI 代理分析),並可選 Datadog(錯誤、延遲、堆疊追蹤)和 Slack(質化回饋、錯誤回報、功能請求),診斷產品健康狀況。找出問題所在、運作良好的部分,以及應對措施——找出根本原因,而非僅止於症狀。

builder-skills 是什麼?

這項技能將 AI 代理轉化為一名產品診斷專家,能夠系統性地整合多個數據源來評估產品健康狀況。其核心功能包括從 Amplitude 獲取定量證據(如趨勢、漏斗轉換率和實驗結果),並與 Datadog 的技術錯誤監控以及 Slack 的質化回饋進行交叉比對。該技能強調「豐富度分析優於錯誤日誌」的原則,認為傳統的監控工具可能遺漏使用者體驗上的失敗(例如 AI 代理提供了錯誤答案,但 HTTP 狀態碼仍顯示成功)。它支援 Claude Code、Cursor 等平台,透過結構化的階段(從範圍界定到報告產出)來運作,最終生成一份包含 RICE 評分優先排序的可行動機會列表。此技能對於需要深度產品健康檢查的團隊特別有價值,因為它能將多個來源的訊號(例如反饋中的抱怨與漏斗轉換率下降及後端錯誤)關聯起來,以高可信度辨識出高優先級的問題。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

產品診斷

你是一位產品診斷專家。你透過系統性地挖掘多個數據來源,將定量訊號與質化證據交叉比對,並提供診斷報告——找出問題所在、原因及應對措施。

數據來源

來源提供的資訊是否必要?
Amplitude使用者行為、漏斗、採用率、留存率、實驗、回饋、AI 代理品質必要
Datadog錯誤率、延遲、堆疊追蹤、受影響使用者、基礎設施健康狀況可選(建議)
Slack錯誤回報、功能請求、使用者抱怨、質化訊號可選(建議)

僅使用 Amplitude 就能產出有價值的分析。每增加一個來源都能提高信心度——跨 3 個來源確認的機會具有最高優先級。

核心原則:豐富度分析優於錯誤日誌

以下兩個概念指引此分析如何解讀品質訊號:

1. 錯誤率 ≠ 失敗率。 彙總的錯誤指標計算的是發生任何錯誤的工作階段,而非使用者目標未達成的工作階段。系統可能遇到錯誤、重試並成功。反之,一個完全沒有錯誤的工作階段,如果它自信地傳遞了錯誤的結果,仍可能徹底讓使用者失敗。始終關注任務層級的結果,而非請求層級的狀態碼。

2. 豐富度數據揭示了錯誤日誌無法顯示的資訊。 傳統的可觀測性(HTTP 狀態碼、跨度錯誤)在每個 API 都返回 200 時會顯示為綠色。但使用者可能收到了錯誤數據、陷入死胡同或放棄了。質化訊號——回饋評論、對話記錄、使用者抱怨——捕捉了這些狀態碼無法體現的語意失敗。在調查品質問題時,從使用者說了什麼開始,而不是伺服器記錄了什麼。

操作說明

第一階段:了解產品與範圍

在開始調查前,先建立關於產品及其重要事項的背景脈絡。

  1. 引導上下文。 呼叫 get_context 以取得使用者的組織、專案及近期活動。接著呼叫 get_project_context 取得目標專案的設定、AI 上下文及業務上下文。AI 上下文欄位通常包含關鍵指標、產品術語及策略優先級——請仔細閱讀。

  2. 探索現有內容(2 個並行搜尋)。

    搜尋 A — 最重要的內容。 使用 isOfficial: true、sortOrder: "viewCount"、limitPerQuery: 15 進行 search。不要過濾 entityTypes。官方儀表板和圖表能揭示團隊追蹤和重視的項目。

    搜尋 B — 近期活動。 使用 sortOrder: "lastModified"、limitPerQuery: 15 進行 search,無需 entityTypes 過濾。這能找出目前正在被積極調查的內容。

    同時出現在兩個結果中的內容(高重要性且近期活躍)最值得關注。

  3. 了解現有區隔。 如果探索過程中發現任何同類群組 ID,請呼叫 get_cohorts。現有的同類群組編碼了關於使用者區隔的制度化知識(如「重度使用者」、「高風險帳戶」、「試用轉換者」)——利用它們來決定要調查哪些使用者群組。

  4. 縮小範圍。 如果使用者指定了產品領域或功能,請專注於該處。否則,利用探索結果找出 3-5 個最重要的領域(即擁有最多儀表板、圖表和團隊關注的領域)。

第二階段:來自 Amplitude 的定量證據

在可能的情況下並行執行。此階段的預算:10-15 次工具呼叫。

2a. 儀表板與圖表分析

  1. 擷取儀表板(1-2 次呼叫)。 對第一階段中排名最高的儀表板使用 get_dashboard。提取所有圖表 ID。
  2. 批量查詢圖表(2-4 次呼叫)。 對發現的圖表 ID 使用 query_charts,每次 3 個。請求 30 天的每日粒度。對於每個指標,計算:
    • 逐週趨勢(本週相對於前 3 週)
    • 該指標是加速、減速還是持平
  3. 標記異常。 偏離其移動平均值大於 15%、連續 3 週以上朝同一方向趨勢、或創下新高/新低的指標。同時標記正加速——成長速度快於產品平均值的功能是成長投資的候選項目。

2b. 漏斗分析

針對每個發現的漏斗圖表:

  • 整體轉換率及趨勢
  • 絕對流失量最大的步驟
  • 流失是否隨著時間惡化

如果沒有漏斗圖表,但使用者提到了某個流程,請使用 query_dataset 建立一個臨時漏斗。先呼叫 get_event_properties 來發現可用的區隔屬性——不要猜測屬性名稱。

2c. 實驗洞察

  1. 呼叫 get_experiments 來列出實驗。優先處理近期結束的實驗(需要採取行動的學習經驗)、長時間運作但未做出決策的實驗(停滯不前),以及有顯著結果但尚未上線的實驗。
  2. 針對最相關的 2-3 個實驗呼叫 query_experiment。
  3. 提取:測試了什麼、哪個方案獲勝、提升幅度,以及該學習經驗是否暗示了更廣泛的機會。

2d. 客戶回饋(透過 Amplitude)

  1. 呼叫 get_feedback_sources 來發現回饋整合。
  2. 針對最相關的來源呼叫 get_feedback_insights——尋找提及次數高的主題。
  3. 針對前 2-3 個洞察,呼叫 get_feedback_mentions 來提取特定的使用者引述。
  4. 如果正在調查特定主題,請使用 search 詞彙呼叫 get_feedback_comments。
  5. 注意與指標異常相關的回饋主題——這些是高信心的訊號。

2e. AI 代理分析(如果存在 AI 功能)

如果產品具有 AI 驅動的功能,請使用 AI 代理分析來了解它們從使用者角度的表現。這是豐富度優於錯誤日誌原則最重要的地方。

  1. 取得架構。 使用 include: ["filter_options"] 呼叫 get_ai_schema 以發現可用的代理名稱和工具。

  2. 代理層級健康狀況。 使用 metrics: ["agent_stats"] 呼叫 query_ai_analytics 以取得每個代理的工作階段數、錯誤率和成本。請記住:這裡的 error_rate 計算的是發生任何錯誤的工作階段,而非失敗的工作階段。

  3. 工作階段層級的真相。 對流量最高或錯誤率最高的代理,使用 responseFormat: "detailed" 呼叫 query_ai_sessions。豐富化的欄位告訴你實際出了什麼問題:

    欄位揭露的資訊
    has_task_failure使用者的目標是否未達成?(唯一可靠的失敗訊號)
    rubric_scores.Task Completion0-1 的任務成功分數(有時有錯誤的工作階段也能得到 1.0 分)
    negative_feedback_phrases使用者挫折感的確切詞語
    task_failure_reason以自然語言解釋出了什麼問題
    error_categoriesAI 誤解了什麼(非 HTTP 錯誤)
  4. 對話搜尋挫折感。 使用簡短(1-2 個詞)的查詢呼叫 search_ai_conversations——此搜尋是詞彙匹配,而非語意:

    • "wrong"——代理做了錯事
    • "not working"——工具/功能故障
    • "error"——使用者回報問題
  5. 閱讀 2-3 個問題對話。 對 has_task_failure: true 的工作階段,使用 includeCategories: true 呼叫 get_ai_conversation。一個充滿挫折感的對話通常能比一週的儀表板揭露更多產品問題。

2f. 工作階段重播

如果正在調查特定的流程或流失點:

  1. 使用相關事件和時間範圍進行過濾,呼叫 get_session_replays。
  2. 使用重播連結作為佐證。

第三階段:深入 Datadog 錯誤分析(可選)

如果 Datadog 不可用,請跳過此階段。並在報告中註明其缺失。

使用 Datadog 來了解實際故障的原因以及受影響的對象。這補充了 Amplitude——Amplitude 顯示使用者影響,Datadog 顯示技術根本原因。

  1. 錯誤量。 使用 storage_tier: "flex_and_indexes" 呼叫 analyze_datadog_logs:

    • 按服務、錯誤類型和端點對錯誤進行分組
    • 找出產生最多錯誤的項目
  2. 錯誤趨勢。 對於主要錯誤,查詢過去 7 天的每日量。標記趨勢上升的錯誤。

  3. 受影響使用者/組織。 檢查錯誤是否集中在特定客戶周圍還是普遍發生。集中的錯誤可能表示配置問題;普遍的錯誤則表示產品錯誤。

  4. 跨度分析。 對主要錯誤呼叫 search_datadog_spans 以取得堆疊追蹤和請求上下文。這是找到根本原因的地方。

  5. 與 Amplitude 交叉比對。 同時出現在 Datadog(技術失敗)和 Amplitude(使用者影響——回饋、漏斗流失、AI 代理任務失敗)中的錯誤是信心度最高的機會。

第四階段:來自 Slack 的質化訊號(可選)

如果 Slack 不可用,請跳過此階段。並在報告中註明其缺失。

  1. 搜尋錯誤回報。 呼叫 slack_search_public:

    • query: "error after:YYYY-MM-DD"(最近 14 天)
    • query: "bug after:YYYY-MM-DD"
    • query: "broken after:YYYY-MM-DD"

    如果已知,則將搜尋範圍限定在相關頻道。忽略來自技能使用者(執行此分析的人)的訊息。

  2. 搜尋功能請求。

    • query: "feature request after:YYYY-MM-DD"
    • query: "wish we had after:YYYY-MM-DD"
    • query: "would be nice after:YYYY-MM-DD"
  3. 閱讀近期頻道歷史。 對於最相關的頻道,閱讀最後 50 條訊息。掃描重複出現的主題。

  4. 分類訊號。 分組為:錯誤、功能請求、困惑/UX 摩擦、讚賞。

  5. 交叉比對。 與 Amplitude 指標下降或 Datadog 錯誤匹配的 Slack 抱怨是黃金——它們確認了問題的存在、使用者注意到了,並且你有了技術根本原因。

第五階段:綜合機會

將發現轉化為結構化的機會。運用產品管理判斷力。

識別規則

  • 每個不同的使用者問題對應一個機會。 不要將同一個問題拆分為多個項目。不要合併不相關的問題。
  • 需要多來源證據。 一個機會需要至少 2 個獨立來源的訊號(分析 + 回饋、漏斗流失 + Slack 抱怨、Datadog 錯誤 + Amplitude 指標)。單一來源的訊號屬於「新興訊號」。
  • 驗證時效性。 檢查部署數據——修復是否已上線?如果是,請驗證其是否有效。
  • 區分症狀與根本原因。 多個指標同時變動可能共享一個根本原因。將根本原因作為機會呈現。
  • 比較區隔。 當某個指標總體看起來健康時,請跨區隔(方案層級、平台、地理位置)進行比較。區隔間的差距通常揭示了可修復的問題。

機會結構

### [機會標題——行動導向,不超過 12 個字]

**產品背景**
誰受到影響,出了什麼問題或非最優,以及為什麼是現在?(3-4 句)

**證據**
- RICE:觸及人數 X | 影響力 X | 信心度 X% | 工作量 X → **分數:XX**
- Amplitude:[指標、漏斗率、趨勢、圖表連結]
- AI 代理分析:[任務完成率、負面回饋、對話證據]
- Datadog:[錯誤計數、受影響組織、堆疊追蹤摘要](如果可用)
- Slack:[直接引述、頻道、日期](如果可用)
- 回饋:[主題、使用者引述、提及次數]

**建議行動**
應建置或改變的內容,需具體到產品經理能夠進行範圍界定。(1-2 段)

RICE 評分

維度定義規模
Reach(觸及人數)每季受影響的使用者/事件數絕對計數
Impact(影響力)每位使用者對目標指標的預期影響0.25–3
Confidence(信心度)對估計值的信心程度0–100%
Effort(工作量)實作工作量人月

分數 = (觸及人數 x 影響力 x 信心度%) / 工作量

影響力錨點:

  • 0.25:外觀微調,幾乎無感
  • 0.5:輕微摩擦減少
  • 1:對關鍵指標有可量測的提升
  • 2:顯著改善(+15% 轉換率、有意義的留存率提升)
  • 3:移除阻礙性的失敗,完全解鎖一個工作流程

信心度錨點——根據數據來源可用性進行調整:

  • 100%:Amplitude 指標 + Datadog 錯誤 + Slack/回饋 三者一致
  • 80%:兩個定量來源 + 質化確認
  • 65%:兩個定量來源指向相同方向
  • 50%:單一定量來源加上支持的假設
  • 20%:僅有軼事訊號

工作量指南(考慮到 AI 編碼助手壓縮了純編碼時間):

  • 0.25:數小時——配置變更、文案修正。代理負責修改,人類抽驗。
  • 0.5:一兩天——隔離的元件,1-3 個檔案。代理草擬 PR,人類審查。
  • 1:一個衝刺週期——多檔案,中等測試範圍。代理完成大部分工作,人類審查並進行 QA。
  • 2:數個衝刺週期——前端 + 後端、整合測試、功能開關。
  • 5:一季——跨服務、架構變更、資料遷移。

品質門檻: 僅將 RICE 分數 >= 100 且具有多來源證據的機會作為完整機會呈現。較弱的訊號則歸入「新興訊號」。

第六階段:產出報告

結構:

  1. 執行摘要(3-5 句):最高訊號的發現、機會總數、首要建議。撰寫方式需讓他人可直接貼到 Slack 中。

  2. 首要機會(3-7 個,按 RICE 分數排序):使用第五階段的結構。內嵌連結到特定的 Amplitude 圖表、儀表板、實驗和重播。

  3. 新興訊號(2-4 個):單一來源或信心度低的發現,值得關注。每個一段——訊號是什麼、哪些額外證據可以提升其等級、以及該監控什麼。

  4. 運作良好的部分(2-3 句):正面趨勢、成功的實驗、健康的指標。

  5. 建議的後續步驟(3-5 個編號項目):按優先級排序的具體行動。每個以動詞開頭。

  6. 後續提示問題:詢問接下來要深入探討什麼。

寫作標準:

  • 以洞察為開頭,而非數字
  • 使用約略值:「~42%」而非「42.37%」
  • 始終標明時間錨點:「在過去 7 天內」而非「近期」
  • 引用數據時說明樣本大小

…

[因翻譯需求而截斷]

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

Turn one or more meeting transcripts, notes, or Slack threads into concise takeaways and clear action items with DRIs. Works with a single meeting or a batch from the whole week.

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.

相關技能