platform-product-manager

平台产品经理

面向 API 优先和开发者导向的平台的战略产品管理专业知识——涵盖 API 设计、开发者体验、生态系统建设和平台指标。

理念

优秀的平台产品并非关注功能，而是致力于让开发者取得成功。

最好的 API 和平台产品：

1. 开发者体验就是产品体验——DX 是你的首要差异化优势
2. API 就是用户界面——像设计可视化 UI 一样用心设计 API
3. 文档就是产品——出色的文档能减少支持需求、提高采用率并推动成功
4. 生态系统能放大价值——集成让你的平台更具黏性

此技能的工作方式

调用时，应用 rules/ 中的指南，这些指南按以下类别组织：

• api-* — API 设计原则、标准和模式
• dx-* — 开发者体验、引导和成功
• docs-* — 开发者文档策略和标准
• sdk-* — SDK 和库策略
• versioning-* — API 版本管理、弃用和迁移
• community-* — 开发者社区和生态系统建设
• marketplace-* — 集成市场和合作伙伴策略
• metrics-* — 平台健康度和成功指标

核心框架

平台成熟度模型

阶段	重点	关键指标	团队结构
基础	核心 API、基础文档	API 正常运行时间、错误率	PM + 工程师
增长	DX、SDK、引导	首次调用耗时、激活率	+ DevRel、DX 工程师
规模化	生态系统、市场	集成数量、合作伙伴收入	+ 合作伙伴团队
平台化	网络效应、飞轮	平台 GMV、生态系统价值	完整的平台组织

开发者旅程

┌─────────────┐   ┌─────────────┐   ┌─────────────┐   ┌─────────────┐
│  DISCOVER   │ → │   EVALUATE  │ → │   ADOPT     │ → │   EXPAND    │
│             │   │             │   │             │   │             │
│ - Search    │   │ - Docs      │   │ - Signup    │   │ - More APIs │
│ - Content   │   │ - Sandbox   │   │ - First call│   │ - Higher    │
│ - Referral  │   │ - Pricing   │   │ - Use case  │   │   volume    │
│             │   │             │   │   solved    │   │ - Referral  │
└─────────────┘   └─────────────┘   └─────────────┘   └─────────────┘

API 设计层级

                    ┌─────────────────┐
                    │   CONSISTENCY   │  ← Predictable patterns
                    ├─────────────────┤
                    │   SIMPLICITY    │  ← Easy to understand
                    ├─────────────────┤
                    │   DISCOVERABILITY│ ← Self-documenting
                    ├─────────────────┤
                    │   RELIABILITY   │  ← Stable and trustworthy
                    ├─────────────────┤
                    │   PERFORMANCE   │  ← Fast and efficient
                    └─────────────────┘

开发者成功指标体系

┌─────────────────────────────────────────────────────────────────┐
│                    BUSINESS OUTCOMES                            │
│        Revenue, Retention, Net Dollar Retention                 │
├─────────────────────────────────────────────────────────────────┤
│                    DEVELOPER SUCCESS                            │
│     Active Developers, API Calls, Use Cases Completed           │
├─────────────────────────────────────────────────────────────────┤
│                    DEVELOPER EXPERIENCE                         │
│   Time-to-First-Call, Activation Rate, Support Tickets          │
├─────────────────────────────────────────────────────────────────┤
│                    PLATFORM HEALTH                              │
│        Uptime, Latency, Error Rates, Documentation Quality      │
└─────────────────────────────────────────────────────────────────┘

平台类型

类型	示例	成功关键因素	主要指标
基础设施 API	Stripe、Twilio、AWS	可靠性 + DX	API 调用次数、正常运行时间
数据 API	Plaid、Clearbit	数据质量 + 时效性	数据覆盖范围
聚合平台	Zapier、Segment	集成 + 易用性	建立的连接数
开发者工具	GitHub、Vercel	工作流契合度 + 速度	活跃项目数
嵌入式平台	Shopify Apps	分发 + 价值	安装率、GMV

API 风格比较

风格	最适合	复杂度	灵活性	缓存
REST	CRUD 操作、简单资源	低	中	优秀
GraphQL	复杂数据获取、移动端	中	高	手动
gRPC	内部服务、高性能场景	高	低	不适用
Webhooks	实时事件、异步流程	低	中	不适用
WebSocket	双向、实时通信	中	高	不适用

反模式

• API 优先，却不以开发者为先 — API 在技术上很出色，却难以使用
• 把文档当作事后补充 — 等 API“完成”后才编写文档
• 不提前警告就进行破坏性变更 — 让开发者措手不及地遭遇不兼容问题
• 虚荣式集成 — 为了营销而构建无人使用的集成
• 产品市场契合之前就建设平台 — 核心价值尚未确立就构建生态系统
• 忽视支持信号 — 不把支持工单视为产品反馈
• 一刀切的 SDK — 对所有语言和使用场景采用相同的 SDK 策略
• 版本管理没有迁移路径 — 发布新版本却不提供升级指南