Communitygithub.com

amplitude/builder-skills

一個以結構化架構定義功能規格和解決方案的技能,適用於AI代理工具,協助開發者清晰表達問題脈絡、設計解決方案並驗收成果。

builder-skills 是什麼?

amplitude/builder-skills 是一個專為 AI 代理程式(如 Claude Code、Cursor 或 Codex)設計的技能,旨在協助開發者以結構化的方式撰寫功能規格文件。該技能提供一個完整的框架,從問題陳述開始,要求使用者以簡潔且行動導向的方式描述核心問題與動機,並強調以最相關的客戶角色(如「企業主需要…」)作為開端。接著,技能引導使用者探索解決方案空間,考慮多種候選方案,並評估其對策略槓桿(如成本優勢、網路效應、反定位機會、客戶轉換成本等)的影響。最後,技能要求定義具體、可測試的驗收標準,涵蓋功能面、邊界案例與錯誤處理,並明確列出不包含的範圍,以避免過度開發。此技能支援多種 AI 代理平台,透過清晰的標題、列表與程式碼區塊等 Markdown 結構,幫助開發者產出高品質、易於協作的規格文件。

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

在你喜歡的 AI 中提問

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

說明文件

更新:@今天的日期(MM/DD/YY)

問題脈絡

用一句可執行且簡潔的問題陳述段落,描述該議題背後的核心問題與動機,清楚說明此功能旨在解決的核心問題,或建構此功能所釋放的機會。 此功能的市場宣導語是什麼?我們為何現在要建構它?我們憑什麼能靠此功能取勝? 此問題陳述必須足夠詳細且可執行,無需額外背景資訊就能獨立傳達所有關鍵要點,但限制在最多3句簡潔句子。 以最相關的客戶角色開頭(例如:「企業主需要……」),但切勿在概述段落中使用確切的個人或公司名稱。

解決方案設計

在確定方向前,先探索解決方案空間。 考慮多種候選方案,並根據策略和體驗的鏡頭進行評估。

識別哪些策略槓桿對此解決方案最重要,並深入探討:

  • 優先考慮能透過規模經濟最大化成本優勢的功能,隨著用戶採用或營運量增加,降低單位成本。
  • 選擇能放大網路效應的功能,隨著參與者數量增加,提升用戶價值。
  • 偏好能創造反定位機會的功能,引入競爭對手無法輕易複製,否則會嚴重干擾其自身策略的能力或體驗。
  • 強調能提高客戶轉換成本的功能,讓用戶更難或不願離開生態系統。
  • 專注於能強化品牌的功能,鞏固其獨特身份,並與用戶建立持久的情感連結。
  • 利用能佔據封閉資源的功能,例如專有資料、獨家合作夥伴關係或競爭對手無法輕易取得或模仿的獨特能力。
  • 實施能展現優越流程或專有工作流程的功能,創造可持續的營運優勢,超越競爭對手。

在設計簡單且令人愉悅的用戶體驗時,請嘗試在設計用戶流程時運用以下原則:

  • 持續簡化——移除不必要的步驟或功能,提供直覺、極簡的體驗。每個元素都必須證明其存在的價值。

  • 維持無縫連貫——以最少的認知負荷引導用戶從頭到尾,無死胡同。

  • 注重細節——字體排版、轉場、間距和文案都應反映精心的工藝。在每個接觸點上,平衡功能與美感,保持統一且一致的品牌感受。

  • 用體貼的巧思帶來驚喜——添加微小但令人難忘的細節,提升體驗超越純功能性。

  • 如果不確定如何設計 SaaS 元件,請模仿 Linear 的設計或元件運作方式。

在討論解決方案時,不要明確提及這些原則,只需在探索、決定並解釋最佳解決方案時,將其融入你的論證中。

在探索解決方案空間並確立最佳策略後,簡潔地說明此功能的作用、如何解決用戶的痛點,以及如何讓用戶感到愉悅——寫得緊湊,避免不必要的開場白。

  • 非常具體地詳細說明用戶與產品互動和體驗的理想方式。聚焦於介面設計、用戶旅程的每一步,以及如何改善解決方案的整體可用性和簡潔性。
  • 呈現我們預期推出此功能後會發生的真實使用敘事。
  • 將此錨定在真實用戶的真實時刻。例如:「當 Frank 在舊金山拜訪不同新創公司時,他使用[功能 X]記錄抱怨,並在[功能 Y]中追蹤需求,隨著他了解這些資訊……」
  • 強調我們可以採用的獨特策略,或使此解決方案與市場上替代方案不同的方面,並將我們的產品與競爭對手進行反定位。

請記住:最佳解決方案能最大化 ICE:影響力(Impact)、信心(Confidence)和努力(Effort)。影響力越高、信心越高、努力越低——解決方案越好。

將解決方案的說明分成聚焦且簡潔的段落,段落之間用換行分隔——每個段落涵蓋體驗的一個方面。

驗收標準

每個標準必須描述一個特定的、可測試的條件,並包含明確的預期結果。標準描述預期的結果,而非實作選擇。標準應符合 MECE 原則——互斥且 collectively exhaustive——涵蓋完成工作所需的所有條件。

功能性:

  • [可觀察的用戶行為 → 預期的系統回應或結果]

邊界案例與錯誤處理:

  • [當輸入無效、服務失敗、資料遺失或用戶遇到非預期狀態時,會發生什麼]

不包含在內:

  • [此工作明確不包含的內容——設定明確界限以防止過度建構]

<強驗收標準範例>

  • 當用戶在搜尋列中輸入時,結果會在 300 毫秒的去抖動後即時更新,以排名列表顯示產品名稱、圖片和價格。
  • 用戶可以導航至「設定」>「編輯個人資料」,並更新名字、姓氏、電子郵件和電話號碼。變更會立即儲存,並在應用程式中反映,無需重新整理。
  • 如果儲存請求失敗(逾時或 5xx),則顯示行內錯誤:「發生錯誤,請重試。」表單會保留用戶未儲存的輸入。
  • 提交空的搜尋查詢會返回預設結果列表,而非錯誤或空狀態。
  • 這不包括批次個人資料編輯、CSV 匯出或管理員級別的權限變更。 </強驗收標準範例>

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.

相關技能