Python 库与 API 设计：从包结构到向后兼容
Python 库与 API 设计完整指南：包结构与模块划分、公开 API 面设计、类型标注与 Protocol、语义化版本与向后兼容策略、文档工程（docstring/类型/示例）、发布与社区治理，附高质量库案例拆解。
tag
API设计
共 4 篇文章。
MCP 工具设计模式与最佳实践
设计优秀的 MCP 工具需要兼顾 AI 可理解性、安全性和实用性。本文详解工具命名、参数设计、描述撰写、组合模式和结果格式化等 MCP 工具设计的核心方法论。
Go Swagger/OpenAPI 文档自动生成：从注释到可交互 API 文档的完整工作流
系统讲解 Go 项目中 Swagger/OpenAPI 文档的自动生成方案，覆盖 swaggo 使用、gin/echo 集成、自定义扩展与团队协作规范
API优先的短链服务设计：RESTful规范、多语言SDK、Webhook与开发者体验
API优先的短链服务设计完整指南：RESTful API规范、多语言SDK架构、Webhook事件体系、GraphQL扩展、速率限制策略，以及打造顶级开发者体验(DX)的实战经验。