API 设计
io.github.gsd-build/gsd-2/api-design
设计或审查 HTTP/REST/GraphQL API 的版本管理、分页、错误格式、幂等性、认证与可演进性。当被要求“设计 API”“规划端点”“设计 schema”“添加新端点”“审查此 API”,或在构建/修改公共或内部 HTTP 接口时使用。补充 `design-an-interface`(接口无关),涵盖 HTTP 特有关注点如状态码、缓存头与破坏性变更管理。
io.github.gsd-build/gsd-2/design-an-interface
为一个模块、API 或接口产出 3 个以上截然不同的设计方案,用文字对比优劣并综合出推荐方案。当被要求“设计一个接口”“塑造这个 API”“设计两次”“探索模块边界”,或规划一个新的深层模块且首个想法未必最佳时使用。源自《A Philosophy of Software Design》的“Design It Twice”——价值在于对比,而非初稿。