用途:当任务需要设计、编写或排查 API 集成时使用该技能,适用于 REST、GraphQL、Webhook 及认证流程。
主要能力:以契约优先方式先弄清 API 契约(schema、auth、限流、分页)再写代码;默认具备弹性,处理失败、重试、超时与降级;可观测性,在边界记录结构化日志;最小权限,使用最窄授权范围,不把密钥写入代码。
使用方式:设计阶段先提问获取文档 URL、所需操作、认证方式、速率限制、数据量、错误处理需求与环境;按模板输出集成架构(认证、数据流、错误策略、限流管理、可观测性)。实现阶段按提供的 Python 异步客户端模板生成代码,含重试、限流信号量与关联 ID 日志,可参考 get、post、close 等方法;调试按清单逐项排查连通性、认证、请求格式、头部、限流、响应解析、SSL/TLS、编码、分页与超时,并始终展示清洗后的实际请求与响应,指出确切故障点并给出最小修复;优化时识别 N+1 请求、缺少分页、同步重试、缺少连接池、无缓存、负载过大等反模式并给出对应修复。
适用场景:需要与第三方服务对接、构建生产级 API 客户端的工程任务。
限制:导入的上游技能,执行前需验证凭证、权限与安全边界;不能替代具体环境的验证、测试或维护者审查;资料未提供更详细的价格、平台兼容性等信息。