Communitygithub.com

amplitude/builder-skills

提供编写产品功能需求文档(PRD)和设计解决方案的结构化模板,帮助产品经理、设计师和工程师高效协作。

builder-skills 是什么?

这是一个面向产品开发团队的技能,旨在通过系统化的模板和方法论,提升功能需求文档的编写质量和决策效率。该技能首先要求撰写一个高度凝练的问题陈述(最多3句话),阐明用户痛点、构建该功能的市场理由以及为何团队能够胜出。在解决方案设计部分,使用者需要探索多个候选方案,并依据成本优势、网络效应、转换成本等战略杠杆进行评估;同时,它倡导“简化到极致”、“保持无缝连续性”、“注重细节”和“令人愉悦的惊喜”等设计原则,以打造简洁且令人愉悦的用户体验。技能还要求提供详细的用户旅程叙述,并用具体的用户场景来锚定真实使用案例。最后,通过“可接受标准”部分(包括功能标准、边缘情况处理以及明确的范围边界)确保需求完整且可测试。该技能适用于产品经理、用户体验设计师和工程团队,在构思或评审新功能时使用,特别强调竞品对标(如 Linear)和最大化 ICE(影响、信心、努力)评分。

兼容平台~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 评分:影响、信心和努力。影响越大、信心越高、努力越小——解决方案就越优秀。

将解决方案说明拆分为聚焦且简洁的段落,用换行分隔——每个段落对应体验的一个方面。

验收标准

每个标准必须描述一个具体的、可测试的条件,并附有明确的预期结果。标准描述的是预期结果,而非实现方式。标准应符合 MECE 原则——相互独立且完全穷尽——覆盖完成工作所需的所有条件。

功能标准:

  • [可观察的用户行为 → 预期的系统响应或结果]

边界情况与错误处理:

  • [当输入无效、服务失败、数据缺失或用户遇到意外状态时会发生什么]

范围外:

  • [此项工作明确不包含的内容——设定清晰的边界以防止过度构建]

<强验收标准示例>

  • 当用户在搜索栏中输入时,结果在 300ms 防抖后实时更新,以排名列表形式显示产品名称、图片和价格。
  • 用户可以导航到“设置 > 编辑个人资料”,更新名字、姓氏、电子邮件和电话号码。更改在保存后立即生效,并在整个应用中无需刷新即可反映。
  • 如果保存请求失败(超时或 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.

相关技能