实施可扩展的分页策略，通过高效的查询、导航和性能优化来处理大型数据集。

设计和配置 API 网关来处理微服务架构的路由、身份验证、速率限制和请求/响应转换。

构建灵活的过滤和排序系统，通过适当的验证、安全性和性能优化来有效处理复杂的查询。

使用标准化错误响应、详细日志记录、错误分类和用户友好的错误消息构建强大的错误处理系统。这项技能涵盖了从抛出键入错误到日志记录、监控和面向客户端的响应格式化的整个生命周期。

合同测试验证 API 是否遵守消费者和提供商之间的合同。它确保服务更改不会破坏依赖的消费者，而无需完整的集成测试。合约测试独立验证请求/响应格式、数据类型和 API 行为。

创建全面的 API 变更日志，记录变更、弃用、重大变更，并为 API 使用者提供迁移指南。

通过适当的安全实践，为 API 实施全面的身份验证策略，包括 JWT 令牌、OAuth 2.0、API 密钥和会话管理。

这项技能可以帮助您处理由 uv 管理的 Python 项目，uv 是一个用 Rust 编写的速度极快的 Python 包和项目管理器。使用此技能可以：

Ahrefs API 提供对 Ahrefs SEO 数据的编程访问。官方 Python SDK ( ahrefs-python ) 为所有端点提供类型化请求和响应模型，这些模型是根据 OpenAPI 规范自动生成的。

FastAPI 应用程序的综合生产级最佳实践。包含 7 个类别的规则来指导自动重构和代码生成。

Python 工作的分支到 PR 执行规则：自信地验证、范围和交付。在打开或更新 PR 之前应用这些默认值。

将类型提示视为界面设计，而不是装饰。专注于显式契约、稳定的公共 API 和边界安全建模。

测试可观察的行为和契约，而不是内部实现。保持单元测试快速、确定性，并在模块边界进行修补。

每个服务、工作线程和 CLI 入口点都必须在进行实际工作之前验证其环境，在所有退出路径下彻底关闭，并发出使运行时行为可观察的结构化信号。将这些视为首选默认值 - 当项目约束需要时进行偏离，但需要进行权衡和补偿控制。

笔记本内核拥有事件循环；异步代码必须与该所有权合作而不是与之对抗。此技能涵盖编排模式、顶级 wait 以及 .ipynb 和 #%% 工作流程的兼容性约束。

当特定于提供商的详细信息隐藏在明确的客户端边界后面时，外部集成保持可靠，并且每个出站操作都带有已定义的可靠性策略，该策略针对成功和失败路径进行了测试。

设计错误，以便呼叫者可以采取行动，操作员可以快速诊断。将这些建议视为首选默认值 - 当默认值与项目限制发生冲突时，建议更合适的替代方案，并进行权衡和补偿控制。

具有显式模块契约的可读性优先设计。保持控制流、数据移动和所有权边界可见，以便代码保持可维护性和安全更改。

每个数据错误都可以追溯到三个问题的不明确答案：谁拥有这些数据，它在哪里得到验证，以及它传播了多远？这项技能体现了边界优先思维——明确所有权、在边缘进行验证，并最大限度地减少跨越边界的内容。

正确的并发性始于将模型与工作负载相匹配，而不是开发人员的偏好。该技能对模型选择、取消/截止日期行为和生命周期安全的默认值进行编码——优先考虑显式控制而不是隐式魔法。