---

name: developer-portal-builder description: 使用Backstage或自定义框架构建统一的开发者门户 allowed-tools:

• Read
• Write
• Edit
• Glob
• Grep
• Bash

---

开发者门户构建器技能

概述

此技能构建全面的开发者门户，将API发现、文档、凭证管理和分析统一到一个单一的、连贯的体验中。

能力

• 配置服务目录和API发现
• 实现凭证管理界面（API密钥、OAuth应用）
• 构建API发现和搜索功能
• 集成分析和使用情况仪表板
• 配置自助服务入职流程
• 实现速率限制和配额可视化
• 构建Webhook管理界面
• 支持多租户门户配置

目标流程

• 开发者门户实施
• 内部开发者平台设置
• 开发者体验优化

集成点

• Backstage（用于内部平台）
• Port（用于开发者门户）
• 自定义React/Next.js应用程序
• Stripe风格的门户模式
• API管理平台（Kong, Apigee）

输入要求

• API目录要求
• 身份验证/授权模型
• 需要管理的凭证类型
• 分析要求
• 品牌和用户体验指南
• 多租户要求

输出产物

• 开发者门户应用程序
• 服务目录配置
• 凭证管理系统
• 分析仪表板
• 入职流程实现
• 文档集成
• 门户管理后台面板

使用示例

skill:
  name: developer-portal-builder
  context:
    framework: backstage
    features:
      - apiCatalog
      - credentialManagement
      - usageDashboard
      - webhookManagement
    authProvider: auth0
    multiTenant: false
    customBranding: true

最佳实践

1. 优先考虑首次调用时间指标
2. 实现自助服务凭证管理
3. 提供清晰的使用情况和计费可见性
4. 支持轻松的环境切换
5. 包含全面的搜索功能
6. 支持团队和组织管理