SuperAPI AI 工具集

team-api-design

编程与开发

查看项目

更新于 10-16 00:24

技能介绍

用途:该技能用于设计团队对外暴露的显式接口(Team API),覆盖代码与制品、版本与发布、文档、沟通渠道、服务级别期望等边界,使团队间交互更明确、可预测和可持续。适用于团队 API 设计任务、规划与设计、以及遵循既有最佳实践的场景。

主要能力:提供 Team API 组件框架,包括代码与制品(仓库、API 规范、制品版本)、版本与发布(语义化版本、破坏性变更策略、发布节奏)、文档(团队 Wiki、API 文档、运维文档)、沟通渠道(异步与同步渠道、响应时间)、服务级别期望(可用性、性能、支持)。附带 Team API 模板、治理流程(起草、评审、发布、维护)、成熟度模型(基础、已定义、已度量、已优化),以及平台团队和流对齐团队的示例。

使用方式:技能要求文档优先,先调用 docs-management 技能获取团队接口模式,通过 MCP 服务器(perplexity)验证 Team API 概念,并基于 Team Topologies 的 Team API 框架给出指导。设计时按工作流执行:审计现状、识别消费者、记录接口、与消费者验证、发布并公告、度量与迭代。

适用场景:需要明确团队间接口与契约的组织,尤其是平台团队与流对齐团队之间的交互设计。

限制:资料未提供具体安装命令、收费信息或平台支持细节;部分示例中的具体数值(如响应时间、SLE 指标)为模板占位,需按实际情况填写。