用途
api-onboarding 聚焦于减少「首次 API 调用时间」（Time-to-First-API-Call，TTFAC），即开发者从首次接触 API 到收到第一次成功响应之间的耗时。技能认为这是预测开发者采纳情况最具指示性的单一指标：快速成功的开发者会转为活跃用户，遇到困难的开发者往往会静默离开。因此该技能用于优化开发者引导旅程中的每一步。
主要能力
技能涵盖以下方面：
- 测量与优化 TTFAC；
- 消除认证摩擦；
- 创建有效的沙箱环境；
- 构建交互式文档；
- 识别并修复常见失败点。
TTFAC 由多个阶段构成：发现时间、注册时间、凭证获取时间、设置时间、执行时间与成功时间。技能提供了评级基准：低于 5 分钟为「优秀」，5–15 分钟为「良好」，15–30 分钟为「可接受」，30–60 分钟为「差」，超过 60 分钟为「失败」。
在认证简化方面，技能给出了理想认证流程，并列出了应避免的反模式：审批队列、隐藏的密钥、复杂的 Token 流程、验证关卡。对应策略包括立即提供测试密钥、支持多种认证方式、预填示例、延后生产环境要求。
在沙箱环境方面，要求即时访问、行为真实、边界清晰、可重置、限制宽松，并给出分离端点、密钥前缀、环境参数、预置测试数据、魔法值（如特定卡号触发固定行为）与文档化测试场景等实现模式。
在交互式文档方面，强调「Try It」功能应预认证、预填可用示例数据、参数可编辑、返回真实响应、支持复制为 cURL/代码，并以 OpenAPI 工具（Swagger UI、Redoc、Stoplight Elements）或自定义平台（ReadMe.io、Postman 文档、自定义 React 组件）实现。
在失败点方面，技能列出常见首次调用失败及其占比：认证错误（40%）、请求格式错误（25%）、环境/设置错误（20%）、速率限制（10%）、网络错误（5%），并为每类给出修复方向，同时提供带恢复步骤的错误响应结构示例。
技能还包含「首次调用体验审计」清单（以新开发者身份注册、计时、照抄快速开始、记录摩擦点），以及一个五步优化框架：测量现状、减少步骤、加速剩余步骤、恢复失败、测量并迭代。
使用方式
该技能以过程指导与代码示例的形式提供。文中给出的可执行片段包括分析事件埋点（analytics.track）、错误事件埋点、沙箱调用示例、魔法值卡号示例、交互式文档的 HTML 结构、以及错误恢复的 JSON 结构。这些示例用于说明实践做法，实际落地需结合具体项目环境。
适用场景
适用于需要缩短开发者从发现 API 到完成首次调用的团队，包括优化注册与密钥获取流程、搭建沙箱、改进交互式文档、以及定位并消除引导过程中的失败点。
限制
技能说明其应在任务明确匹配上游来源与本地项目上下文时使用；应用变更前需验证命令、生成代码、依赖、凭证与外部服务行为；示例不能替代针对具体环境的测试、安全审查，也不应替代用户对破坏性或高成本操作的批准。